Crea ambienti

Questo argomento spiega come creare nuovi ambienti. 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 l'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 di quello 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. Aggiungi una proprietà virtualhosts che mappa il relativo routingRules agli ambienti. 
    virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test
  4. Applica le modifiche al cluster. Se hai modificato entrambe le proprietà envs[] e virtualhosts[], applica le modifiche con il seguente comando: 
    apigeectl apply -f overrides-file.yaml -c synchronizer,udca,runtime

    Se modifichi solo la proprietà virtualhosts, applica le modifiche di configurazione con il flag --settings: 

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

Per ulteriori informazioni sulla configurazione degli host virtuali, inclusa la configurazione di più regole di routing del percorso base, consulta Configurare gli host virtuali. Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nel riferimento per le proprietà di configurazione.