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. Wenden Sie die Änderungen nacheinander auf jede Umgebung an. 
    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 Umgebungsname eindeutig ist, kann er mit ENV_NAME übereinstimmen. Wenn Sie jedoch denselben Namen für Ihre Umgebung und 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

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..