Umgebungen erstellen

In diesem Thema erfahren Sie, wie Sie neue Umgebungen erstellen. Eine Einführung finden Sie unter Umgebungen und Umgebungsgruppen.

Umgebung erstellen

Die Erstellung einer Umgebung erfolgt in zwei Schritten:

• Eine Umgebung auf der Verwaltungsebene erstellen Sie entweder ü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. Fügen Sie ein virtualhosts-Attribut hinzu, das seine routingRules der Umgebung zuordnet.

   virtualhosts:
     - name: default
       hostAliases: ["api.example.com"]
       sslCertPath: ./certs/fullchain.pem
       sslKeyPath: ./certs/privkey.pem
       routingRules:
         - env: test

4. Übernehmen Sie alle Änderungen für den Cluster. Wenn Sie die Attribute envs[] und virtualhosts[] geändert haben, wenden Sie Änderungen mit dem folgenden Befehl an:

   apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

   Wenn Sie nur das Attribut virtualhosts ändern, wenden Sie diese Konfigurationsänderungen mit dem Flag --settings an:

   apigeectl apply -f overrides-file.yaml --settings virtualhosts

Weitere Informationen zur Konfiguration für virtuelle Hosts und zum Konfigurieren mehrerer Basispfad-Routingregeln finden Sie unter Virtuelle Hosts konfigurieren. Eine vollständige Liste der Umgebungskonfigurationselemente finden Sie in der Referenzdatei zu Konfigurationsattributen unter env..