Crea ambienti

Questo argomento spiega come creare nuovi ambienti. 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 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 all'ambiente o 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 sia le proprietà envs[] che 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 degli host virtuali, incluso come configurare più regole di routing basepath, consulta Configurare gli host virtuali. Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nel riferimento alle proprietà di configurazione.