Crea ambienti

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

Informazioni sulla creazione dell'ambiente

La creazione dell'ambiente è una procedura in due passaggi:

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

I passaggi per aggiungere un ambiente sono descritti in Aggiunta e configurazione di un ambiente e spiegati in Passaggio 5: aggiunta di un ambiente e Specifica degli override di configurazione.

Come creare un ambiente

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

  2. Aggiungi una nuova definizione dell'ambiente alla proprietà envs[] nel file di override. Tieni presente che la proprietà è un array, pertanto puoi aggiungervi più di una definizione di ambiente. Assegna al nuovo ambiente lo stesso nome dell'ambiente creato nella UI. 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 grafico apigee-env. I nomi delle release di Helm devono essere univoci all'interno dell'installazione di Apigee Hybrid. Se il nome dell'ambiente è univoco, può essere uguale a ENV_NAME. Tuttavia, se l'ambiente e il gruppo di ambienti hanno lo stesso nome, assicurati di inserire un nome di release Helm univoco per ciascuno. Ad esempio, se entrambi si chiamano dev, puoi utilizzare dev-env-release e dev-envgroup-release.

      Per saperne di più sulle release in Helm, consulta la sezione Tre concetti importanti 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 ogni 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 saperne di più sulla configurazione degli host virtuali, consulta Configura gli host virtuali. Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nel riferimento alle proprietà di configurazione.