Umgebungen erstellen

In diesem Thema wird erläutert, wie Sie neue Umgebungen für Apigee hybrid erstellen. Eine Einführung finden Sie unter Umgebungen und Umgebungsgruppen.

Umgebung erstellen

Die Erstellung einer Umgebung erfolgt in zwei Schritten:

• Erstellen Sie eine Umgebung auf Verwaltungsebene über die Benutzeroberfläche oder eine Apigee API.
• Fügen Sie der Überschreibungendatei eine Konfiguration für diese Umgebung hinzu und wenden Sie sie auf den Cluster an.

Die Schritte zum Hinzufügen einer Umgebung werden beim Hinzufügen und Konfigurieren einer Umgebung erläutert: Schritt 5: Umgebung hinzufügen und Konfigurationsüberschreibungen festlegen.

So erstellen Sie eine Umgebung

1. Erstellen Sie eine oder mehrere neue Umgebungen in der Apigee-Benutzeroberfläche oder mit der Create Environments API. Die grundlegenden Schritte finden Sie unter Schritt 5: Umgebung hinzufügen.

2. Fügen Sie dem Attribut envs[] in Ihrer Überschreibungendatei eine neue Umgebungsdefinition hinzu. Beachten Sie, dass das Attribut ein Array ist. Sie können also mehrere Umgebungsdefinitionen hinzufügen. Geben Sie der neuen Umgebung denselben Namen wie in der Benutzeroberfläche. Die folgende Konfiguration definiert beispielsweise zwei Umgebungen: test und prod:

   namespace: my-namespace
   org: my-organization
   ...
   envs:
     - name: test
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   
     - name: prod
       serviceAccountPaths:
         synchronizer: "your_keypath/synchronizer-manager-service-account.json
         udca: "your_keypath/analytic-agent-service-account.json
   ...

3. Übernehmen Sie alle Änderungen für den Cluster:

   Helm

   Wenden Sie die Änderungen in Helm-Diagrammen mit den folgenden Befehlen nacheinander auf jede Umgebung an.

   Beispiel:

   helm upgrade ENV_RELEASE_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --set env=ENV_NAME \
     -f OVERRIDES_FILE \
     --dry-run=server
   

   ENV_RELEASE_NAME ist ein Name, mit dem Installationen und Upgrades des Diagramms apigee-env nachverfolgt werden. Helm-Release-Namen müssen innerhalb Ihrer Apigee-Hybridinstallation eindeutig sein. Wenn der Name der Umgebung eindeutig ist, kann er mit ENV_NAME übereinstimmen. Wenn Sie jedoch denselben Namen für die Umgebung und die Umgebungsgruppe verwenden, müssen Sie für jede Umgebung einen eindeutigen Helm-Release-Namen eingeben. Wenn beide beispielsweise den Namen dev haben, könnten Sie dev-env-release und dev-envgroup-release verwenden.

   Weitere Informationen zu Releases in Helm finden Sie in der Helm-Dokumentation unter Drei wichtige Konzepte.

   Die test-Umgebung:

   helm upgrade test-release apigee-env/ \
     --namespace apigee \
     --atomic \
     --set env=test \
     -f OVERRIDES_FILE.yaml
   

   Die prod-Umgebung:

   helm upgrade prod-release apigee-env/ \
     --namespace apigee \
     --set env=prod \
     --atomic \
     -f OVERRIDES_FILE.yaml
   

   apigeectl

   Mit apigeectl können Sie die Änderungen mit dem Flag --env ENV_NAME auf alle Umgebungen oder gleichzeitig mit dem Flag --all-envs auf alle Umgebungen anwenden. Beispiel:

   $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

Weitere Informationen zur Konfiguration für virtuelle Hosts finden sich unter Virtuelle Hosts konfigurieren. Eine vollständige Liste der Umgebungskonfigurationselemente finden Sie in der Referenzdatei zu Konfigurationsattributen unter env..