Crea ambienti

Questo argomento spiega come creare nuovi ambienti per Apigee Hybrid. Per un'introduzione, consulta Informazioni su ambienti e gruppi di ambienti.

Informazioni sulla creazione dell'ambiente

La creazione dell'ambiente è un processo in due passaggi:

  • Crea un ambiente nel piano di gestione utilizzando l'interfaccia utente o un'API Apigee.
  • Aggiungi la configurazione per quell'ambiente al file delle sostituzioni e applicala al cluster.

I passaggi per aggiungere un ambiente sono descritti in Passaggio 5: aggiungi un ambiente e Specifica le sostituzioni di configurazione.

Come creare un ambiente

  1. Crea uno o più nuovi ambienti nell'interfaccia utente di Apigee o con l'API Create environments. Per i passaggi di base, consulta Passaggio 5: aggiunta di un ambiente.

  2. Aggiungi una nuova definizione dell'ambiente alla proprietà envs[] nel file delle sostituzioni. Tieni presente che la proprietà è un array, pertanto puoi aggiungere più di una definizione di ambiente. Assegna al nuovo ambiente lo stesso nome dell'ambiente creato nell'interfaccia utente. Ad esempio, la seguente configurazione definisce due ambienti: test e 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. Applica le modifiche al cluster:

    Helm

    Con i grafici Helm, applica le modifiche a ogni ambiente in sequenza con i seguenti comandi.

    Ad esempio:

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

      ENV_RELEASE_NAME è un nome utilizzato per monitorare l'installazione e gli upgrade del apigee-env grafico. I nomi delle release di Helm devono essere univoci all'interno dell'installazione ibrida di Apigee. Se il nome dell'ambiente è univoco, può essere uguale a ENV_NAME. Tuttavia, se hai lo stesso nome per l'ambiente e il gruppo di ambienti, assicurati di inserire un nome univoco per ogni release di Helm. Ad esempio, se entrambi sono denominati dev, puoi utilizzare qualcosa come dev-env-release e dev-envgroup-release.

      Per ulteriori informazioni sulle release in Helm, consulta Tre concetti fondamentali nella documentazione di Helm.

    L'ambiente test:

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

    L'ambiente prod:

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

    apigeectl

    Con apigeectl puoi applicare le modifiche a ciascun ambiente singolarmente con il flag --env ENV_NAME o a tutti gli ambienti contemporaneamente con il flag --all-envs. Ad esempio:

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

Per ulteriori informazioni sulla configurazione degli host virtuali, consulta Configurare gli host virtuali. Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nel riferimento per le proprietà di configurazione.