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 prevede due passaggi:

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

I passaggi per aggiungere un ambiente sono descritti nella sezione relativa all'aggiunta e alla configurazione di un ambiente in Passaggio 5: aggiungi un ambiente e Specifica gli override della configurazione.

Creare un ambiente

  1. Crea uno o più nuovi ambienti nell'interfaccia utente di Apigee o con l'API Creazione di ambienti. Per i passaggi di base, vedi Passaggio 5: aggiungi un ambiente.
  2. Aggiungi una nuova definizione di ambiente alla proprietà envs[] nel file di override. Tieni presente che la proprietà è un array, quindi puoi aggiungerne più di una definizione di ambiente. Assegna al nuovo ambiente lo stesso nome di quello 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 i suoi routingRules agli ambienti.
    virtualhosts:
      - name: default
        hostAliases: ["api.example.com"]
        sslCertPath: ./certs/fullchain.pem
        sslKeyPath: ./certs/privkey.pem
        routingRules:
          - env: test
  4. Applica eventuali 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 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 basepath, consulta Configurare gli host virtuali. Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nel riferimento delle proprietà di configurazione.