Es

Instalación con PostgreSQL externo#

Esta guía se refiere a una nueva instalación de Sherpa Orchestrator con una base de datos PostgreSQL en un servidor separado. Al actualizar una instalación existente, utilice el proceso de actualización y prepare una copia de seguridad con anticipación.

Antes de comenzar#

  • Prepare un servidor PostgreSQL versión 13 o superior con una base de datos en codificación UTF-8.
  • Permita conexiones desde la red Docker del servidor Orchestrator: configure listen_addresses, la regla host en pg_hba.conf y el cortafuegos. Verifique la dirección y el puerto disponibles desde el contenedor, no solo desde el host.
  • Elija un nombre para el rol de trabajo, la base de datos y una contraseña separada. El rol de trabajo necesitará el derecho CREATE en la base: las migraciones crearán automáticamente los esquemas orchestrator y orchestrator_archive.
  • Si el rol y la base ya han sido creados por un administrador de PostgreSQL, no se necesitan credenciales administrativas para el instalador. De lo contrario, prepare un rol administrativo temporal con derechos CREATEROLE y CREATEDB.

Instalación#

  1. Descomprima el paquete del cliente y ejecute sudo ./sh_scripts/install.sh, como se describe en la guía general.
  2. En el paso Selección de base de datos, elija 4 — PostgreSQL externo. En este caso, el contenedor de la base de datos no se inicia.
  3. Indique POSTGRES_PASSWORD del rol de trabajo, luego POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER y POSTGRES_DBNAME. No deje en .env un ejemplo de contraseña del template.
  4. Si el rol o la base aún no están creados, complete POSTGRES_ADMIN_USER, POSTGRES_ADMIN_PASSWORD y si es necesario POSTGRES_ADMIN_DBNAME (por defecto postgres). Si los roles y la base ya están creados, deje el rol administrativo vacío.
  5. Espere la verificación de la conexión antes de iniciar el sistema. El instalador verificará la disponibilidad del servidor y el inicio de sesión del rol de trabajo, creará el rol y la base si es necesario, y luego verificará el derecho CREATE.
  6. Si la verificación falla, realice las acciones indicadas en el servidor PostgreSQL y elija r — Repetir verificación. La opción e permite corregir los parámetros de conexión. No omita la verificación con la opción s: Orchestrator no se iniciará mientras la base o el rol no estén disponibles.
  7. Complete los demás pasos del instalador y abra la interfaz de Orchestrator. Verifique el inicio de sesión y la creación de un objeto de prueba en la sección permitida para su rol.

Si la verificación no pasa#

  • Servidor no disponible: verifique POSTGRES_HOST, POSTGRES_PORT, la ruta desde Docker, listen_addresses, pg_hba.conf y el cortafuegos.
  • Rol o base ausente: créelos en el servidor PostgreSQL o proporcione temporalmente credenciales administrativas al instalador. Después de crear la base, otorgue al rol de trabajo el derecho CREATE.
  • Error de inicio de sesión del rol de trabajo: verifique su contraseña en .env y la regla de autorización en pg_hba.conf. Si el rol existía anteriormente, su contraseña puede diferir de la indicada para una nueva instalación.

Los esquemas orchestrator y orchestrator_archive son creados por las migraciones. Para una nueva instalación, no cargue un volcado de otro sistema en ellos.