Registro de Agente para agentes privados de Jitterbit

Introducción

Antes de que un agente privado pueda procesar operaciones de proyectos de integración, debe registrarse en un servidor Harmony. La información que necesita para registrarse incluye la URL del servidor Harmony para la región de su organización, las credenciales de su cuenta Harmony, el nombre del grupo de agentes privados al que se unirá y el nombre del agente en sí. Para obtener el nombre de un agente privado, primero debe agregar uno mediante la Management Console Agentes página. Luego, puede proporcionarla como uno de los datos de registro necesarios durante el paso de instalación en Windows (con entrada manual en el instalador), el paso de configuración en Linux (con entrada manual o parámetros para jitterbit-config), o al iniciar un Docker contenedor (con variables de ambiente). Este método de registro se conoce como registro manual.

Si desea aprovisionar y eliminar automáticamente agentes privados en contenedores (por ejemplo, mediante Kubernetes), debe utilizar el agente privado Jitterbit auto-register característica. Con esto, no necesita agregar un agente con la página Agentes de la Management Console. El sistema agrega automáticamente un agente privado a un grupo de agentes con nombre, genera un nombre y luego lo registra. El sistema también puede, opcionalmente, anular el registro y eliminar el agente privado del grupo de agentes cuando el agente se detiene. (Existe una desventaja: no puede usar un proxy con registro automático.)

Registro manual

Para registrar manualmente un agente, siga estos pasos:

1. Abra la Management Console Agentes página.

2. Agregue un grupo de agentes privados o identifique uno existente y luego agréguele un nuevo agente privado.

3. Proporcione la información de registro. El momento de hacerlo depende del tipo de alojar del agente:

   WindowsLinuxDocker

   Durante la instalación, la interfaz de usuario le solicita que seleccione a qué grupo de agentes unirse y qué agente registrar.

   Durante la configuración, el jitterbit-config dominio le solicita que seleccione a qué grupo de agentes unirse y qué agente registrar. (Alternativamente, estos valores se pueden proporcionar como parámetros para jitterbit-config.)

   Cuando se ejecuta el contenedor, utilice las variables de ambiente abajo.

Registro manual de un agente privado de Docker mediante variables de ambiente

Para utilizar el registro manual con agentes privados en contenedores, establezca valores para las siguientes variables de ambiente y páselos al contenedor:

docker run -it \
-e HARMONY_ORIGIN=https://na-east.jitterbit.com \
-e HARMONY_USERNAME=example@jbexample.com \
-e HARMONY_PASSWORD=P@55w0rd \
-e HARMONY_ORG_NAME="Example Org" \
-e HARMONY_AGENT_GROUP_NAME="Example Agent Group_Example Environment" \
-e HARMONY_AGENT_NAME=ExampleAgent \
jitterbit/agent

Registro automático

Con el registro automático, hay dos formas de proporcionar información de registro: en un register.json archivo, o como variables de ambiente.

Registre un agente privado de Docker utilizando el register.json archivo

Para registrar automáticamente un agente privado de Docker mediante un register.json archivo, siga estos pasos:

1. Cree un directorio y un archivo conf/register.json que contiene lo siguiente, con valores establecidos según la siguiente tabla:

   conf/register.json

   {
       "cloudUrl": "https://REGION.jitterbit.com",
       "agentGroupId": GROUP_ID,
       "username": "ENCRYPTED_USERNAME",
       "password": "ENCRYPTED_PASSWORD",
       "agentNamePrefix": "PREFIX",
       "deregisterAgentOnDrainstop": false,
       "retryCount": 10,
       "retryIntervalSeconds": 5
   }
   

   Parámetro	Descripción del valor
   cloudUrl	La URL de inicio de sesión para su cuenta de Harmony, https://REGION.jitterbit.com, dónde REGION es uno de na-east, emea-west, o apac-southeast.
   agentGroupId	El número de identificación del grupo del agente privado.
   username	Su nombre de usuario de cuenta Harmony cifrada.
   password	Su contraseña de cuenta Harmony encriptada.
   agentNamePrefix	Un prefijo para el nombre del agente privado generado automáticamente.

   Example conf/register.json

   {
       "cloudUrl": "https://na-east.jitterbit.com",
       "agentGroupId": 12345,
       "username": "$00HD1uP3SoM3odoS5NklwBp3VBeg1O4COW31ohIMqBBfWOcUrlzADwMawtI8lAcg6C",
       "password": "$003k9pLM1SJvrnh4CeMzw6jBdzsr0TY6s92wNuMiBuIVs=",
       "agentNamePrefix": "test",
       "deregisterAgentOnDrainstop": false,
       "retryCount": 10,
       "retryIntervalSeconds": 5
   }
   

2. Inicie el agente privado de Docker con el conf directorio montado en el contenedor /conf directorio. (Ver Registro automático con register.json archivo por ejemplo.)

   Example

   docker run --detach --name jitterbit-agent --rm --volume ./conf:/conf jitterbit/agent
   

   Consejo

   Debes utilizar un credentials.txt archivo o un register.json archivo. El agente privado no se iniciará si el conf El directorio contiene ambos.

Para utilizar el register.json archivo en agentes privados de Linux no contenedorizados, mover o eliminar el /opt/jitterbit/Resources/credentials.txt archivo, crear un /opt/jitterbit/Resources/register.json archivo como se muestra arriba y luego reinicie el agente.

Registrar un agente privado de Docker mediante variables de ambiente

Para registrar automáticamente un agente privado de Docker mediante variables de ambiente, siga estos pasos:

1. Cree un archivo que contenga lo siguiente, con valores sustituidos según la siguiente tabla:

   HARMONY_ORIGIN=
   AUTO_REGISTER=true
   AUTO_REGISTER_AGENT_GROUP_ID=
   AUTO_REGISTER_AGENT_NAME_PREFIX=auto
   AUTO_REGISTER_DEREGISTER_ON_DRAINSTOP=false
   AUTO_REGISTER_ENCRYPTED_USERNAME=
   AUTO_REGISTER_ENCRYPTED_PASSWORD=
   

   Variable	Descripción del valor
   HARMONY_ORIGIN	La URL de inicio de sesión para su cuenta de Harmony, https://REGION.jitterbit.com, dónde REGION es uno de na-east, emea-west, o apac-southeast.
   AUTO_REGISTER_AGENT_GROUP_ID	El número de identificación del grupo del agente privado.
   AUTO_REGISTER_ENCRYPTED_USERNAME	Su nombre de usuario de cuenta Harmony cifrada.
   AUTO_REGISTER_ENCRYPTED_PASSWORD	Su contraseña de cuenta Harmony encriptada.

   Example

   HARMONY_ORIGIN=https://na-east.jitterbit.com
   AUTO_REGISTER=true
   AUTO_REGISTER_AGENT_GROUP_ID=12345
   AUTO_REGISTER_AGENT_NAME_PREFIX=auto
   AUTO_REGISTER_DEREGISTER_ON_DRAINSTOP=false
   AUTO_REGISTER_ENCRYPTED_USERNAME=$00HD1uP3SoM3odoS5NklwBp3VBeg1O4COW31ohIMqBBfWOcUrlzADwMawtI8lAcg6C
   AUTO_REGISTER_ENCRYPTED_PASSWORD=$003k9pLM1SJvrnh4CeMzw6jBdzsr0TY6s92wNuMiBuIVs=
   

2. Inicie el agente privado de Docker, pasando el archivo de variables de ambiente mediante el comando --env-file Opción para docker run:

   Example

   docker run --detach --env-file FILE jitterbit/agent
   

   Consejo

   Alternativamente, utilice el -e/--env Opción para configurar variables de ambiente individualmente.

Comparación de register.json parámetros y variables de ambiente

La siguiente tabla compara los parámetros utilizados en el register.json archivo con sus variables de ambiente equivalentes: