Agentregistrierung für Jitterbit private Agenten

Einführung

Bevor ein privater Agent Integrationsprojektoperationen verarbeiten kann, muss er sich bei einem Harmony-Server registrieren. Die Informationen, die er zur Registrierung benötigt, umfassen die Harmony-Server-URL für die Region Ihrer Organisation, Ihre Harmony-Kontodaten, den Namen der privaten Agentengruppe, der er beitreten soll, und den Namen des Agenten selbst. Um den Namen eines privaten Agenten zu erhalten, müssen Sie zunächst einen über die Management Console Agents Seite hinzufügen. Sie können ihn dann als eines der erforderlichen Registrierungsinformationen während des Installationsschritts unter Windows (mit manueller Eingabe in den Installer), des Konfigurationsschritts unter Linux (mit manueller Eingabe oder Parametern für jitterbit-config) oder beim Starten eines Docker Containers (mit Umgebungsvariablen) angeben. Dieser Ansatz zur Registrierung wird als manuelle Registrierung bezeichnet.

Wenn Sie containerisierte private Agenten automatisch bereitstellen und entfernen möchten (zum Beispiel mit Kubernetes), müssen Sie die Jitterbit private Agent Auto-Registrierung Funktion verwenden. Damit müssen Sie keinen Agenten über die Management Console Agents Seite hinzufügen. Das System fügt automatisch einen privaten Agenten zu einer benannten Agentengruppe hinzu, generiert einen Agentennamen und registriert ihn. Das System kann auch optional den privaten Agenten abmelden und aus der Agentengruppe entfernen, wenn der Agent stoppt. (Es gibt einen Nachteil: Sie können keinen Proxy mit automatischer Registrierung verwenden.)

Manuelle Registrierung

Um einen Agenten manuell zu registrieren, befolgen Sie diese Schritte:

1. Öffnen Sie die Management Console Agents Seite.

2. Fügen Sie eine private Agentengruppe hinzu oder identifizieren Sie eine vorhandene, und fügen Sie dann einen neuen privaten Agenten hinzu.

3. Geben Sie die Registrierungsinformationen an. Wann Sie dies tun, hängt vom Typ des Agentenhosts ab:

   WindowsLinuxDocker

   Während der Installation fordert die Benutzeroberfläche den Benutzer auf, auszuwählen, welcher Agentengruppe beigetreten werden soll und welcher Agent registriert werden soll.

   Während der Konfiguration fordert der jitterbit-config Befehl den Benutzer auf, auszuwählen, welcher Agentengruppe beigetreten werden soll und welcher Agent registriert werden soll. (Alternativ können diese Werte als Parameter an jitterbit-config übergeben werden.)

   Beim Ausführen des Containers verwenden Sie die untenstehenden Umgebungsvariablen.

Manuelle Registrierung eines Docker-Privatagenten mit Umgebungsvariablen

Um die manuelle Registrierung mit containerisierten Privatagenten zu verwenden, setzen Sie Werte für die folgenden Umgebungsvariablen und übergeben Sie diese in den Container:

docker run -d \
-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

cat > agent.env <<EOF
HARMONY_ORIGIN=https://qa-green.jitterbit.com
HARMONY_USERNAME=example@jbexample.com
HARMONY_PASSWORD=J1tt_erb1t
HARMONY_ORG_NAME="JB Example Company"
HARMONY_AGENT_GROUP_NAME="Agent Group A_Default Environment"
HARMONY_AGENT_NAME=XMPL_3
ENABLE_JITTERBIT_METRICS=true
EOF
docker run -d --env-file=agent.env jitterbit/agent

Automatische Registrierung

Bei der automatischen Registrierung gibt es zwei Möglichkeiten, Registrierungsinformationen bereitzustellen: in einer register.json-Datei oder als Umgebungsvariablen.

Registrieren Sie einen Docker-Privatagenten mit der register.json-Datei

Um einen Docker-Privatagenten automatisch mit einer register.json-Datei zu registrieren, befolgen Sie diese Schritte:

1. Erstellen Sie ein Verzeichnis und eine Datei conf/register.json, die Folgendes enthält, wobei die Werte gemäß der Tabelle unten festgelegt sind:

   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
   }
   

   Parameter	Wertbeschreibung
   cloudUrl	Die Anmelde-URL für Ihr Harmony-Konto, https://REGION.jitterbit.com, wobei REGION eines von na-east, emea-west oder apac-southeast ist.
   agentGroupId	Die ID-Nummer der privaten Agentengruppe.
   username	Ihr verschlüsselter Harmony-Konto-Benutzername.
   password	Ihr verschlüsseltes Harmony-Konto-Passwort.
   agentNamePrefix	Ein Präfix für den automatisch generierten Namen des privaten Agenten.

   Beispiel conf/register.json

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

2. Starten Sie den Docker-Privatagenten mit dem conf-Verzeichnis, das im Verzeichnis /conf des Containers eingebunden ist. (Siehe Automatische Registrierung mit der register.json-Datei für ein Beispiel.)

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

Um die register.json-Datei auf nicht-containerisierten Linux-Privatagenten zu verwenden, verschieben oder entfernen Sie die Datei /opt/jitterbit/Resources/credentials.txt, erstellen Sie eine Datei /opt/jitterbit/Resources/register.json, wie oben gezeigt, und starten Sie den Agenten neu.

Registrieren Sie einen Docker-Privatagenten mit Umgebungsvariablen

Um einen Docker-Privatagenten automatisch mit Umgebungsvariablen zu registrieren, befolgen Sie diese Schritte:

1. Erstellen Sie eine Datei mit folgendem Inhalt, wobei die Werte gemäß der Tabelle unten ersetzt werden:

   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	Wertbeschreibung
   HARMONY_ORIGIN	Die Anmelde-URL für Ihr Harmony-Konto, https://REGION.jitterbit.com, wobei REGION eines von na-east, emea-west oder apac-southeast ist.
   AUTO_REGISTER_AGENT_GROUP_ID	Die ID-Nummer der Privatagentengruppe.
   AUTO_REGISTER_ENCRYPTED_USERNAME	Ihr verschlüsselter Harmony-Konto-Benutzername.
   AUTO_REGISTER_ENCRYPTED_PASSWORD	Ihr verschlüsseltes Harmony-Konto-Passwort.

   Beispiel

   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. Starten Sie den Docker-Privatagenten und übergeben Sie die Umgebungsvariablen-Datei mit der Option --env-file für docker run:

   Beispiel

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

   Tipp

   Alternativ können Sie die Option -e/--env verwenden, um Umgebungsvariablen einzeln festzulegen.

Vergleich der register.json-Parameter und Umgebungsvariablen

Die folgende Tabelle vergleicht die in der register.json-Datei verwendeten Parameter mit ihren entsprechenden Umgebungsvariablen: