Crea ambienti

Questo argomento spiega come creare nuovi ambienti. Per un'introduzione, consulta Informazioni sugli ambienti e sui gruppi di ambienti.

Informazioni sulla creazione dell'ambiente

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

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

I passaggi per aggiungere un ambiente sono descritti in aggiungere e configurare un ambiente in Passaggio 5: aggiungi un ambiente e Specifica gli override della configurazione.

Come creare un ambiente

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

  2. Aggiungi una nuova definizione di ambiente alla proprietà envs[] nel file degli override. Tieni presente che la proprietà è un array, di conseguenza, puoi aggiungere più di una definizione di ambiente. Assegna al nuovo ambiente lo stesso nome che hai 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. Aggiungi una proprietà virtualhosts che mappa il suo 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 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 alla configurazione con il flag --settings: 

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

Per ulteriori informazioni sulla configurazione dell'host virtuale, incluso come configurare più regole di routing di basepath, consulta Configurare gli host virtuali. Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nella sezione di riferimento sulle proprietà di configurazione.