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

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.

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

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

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