Informazioni sugli ambienti

Un ambiente fornisce un contesto isolato o una "sandbox" per l'esecuzione di proxy API. In una singola organizzazione puoi creare più ambienti. Per ulteriori informazioni, consulta Informazioni sugli ambienti e sui gruppi di ambienti.

Il codice seguente mostra un esempio di override della configurazione in cui sono presenti più ambienti definito. Tieni presente che gli ambienti prod e test hanno alias host diversi:

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
...
  • 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
    virtualhosts:
      - name: external
        hostAliases: ["apiprod.example.com"]
        sslCertPath: ./certs/fullchain.pem
        sslKeyPath: ./certs/privkey.pem
        routingRules:
          - env: prod

    Supponiamo che un proxy con il percorso di base /foo1 sia di cui è stato eseguito il deployment nell'ambiente test. Puoi chiamare il proxy come segue:

    curl -k https://api.example.com/foo1

    Quando questa chiamata raggiunge il traffico in entrata, il componente in entrata sa di inviarla al processore di messaggi associati all'ambiente test, che gestisce la richiesta.

    Allo stesso modo, se il deployment di foo1 viene eseguito anche nell'ambiente prod, potresti creare un proxy come questa, all'alias host apiprod.mydomain.net:

    curl -k https://apiprod.example.com/foo1

    La chiamata viene instradata dal server in entrata al MP associato a quell'host.

    Antipattern: esegui il deployment di tutti i proxy in un ambiente ibrido.

    Best practice: crea più ambienti ed esegui il deployment di un numero limitato di proxy a ciascuno. Puoi creare regole di routing che specificano quali ambienti per indirizzare percorsi di base del proxy API specifici. Per maggiori dettagli, vedi Configurazione dell'host virtuale.

    Limita il numero di deployment dei proxy

    Per l'ambiente ibrido, il fatto che molti ambienti possano condividere lo stesso host virtuale significa che devi riflettere attentamente su come gestire i deployment dei proxy in un determinato ambiente. Nel caso di ambienti ibridi, la best practice consiste nel creare più ambienti ed eseguire il deployment a ciascuno di essi è associato un numero limitato di proxy.

    Quanti proxy devi implementare in un ambiente? Non c'è una risposta impostata a questa domanda: tuttavia, la tabella seguente fornisce indicazioni generali sul motivo per cui si tratta di un è buona norma limitare il numero di proxy di cui è stato eseguito il deployment in ciascun ambiente e il numero devi pensare quando gestisci i deployment proxy:

    Problema da considerare Descrizione
    Tempo di avvio del processore di messaggi Esiste una correlazione diretta tra la quantità di tempo in cui un processore di messaggi (MP) per l'avvio e il numero di proxy di cui è stato eseguito il deployment su quel MP. In un ambiente Kubernetes con scalabilità automatica, un aumento del tempo di avvio potrebbe essere un problema. Maggiore è il numero di proxy deployment al MP, più tempo impiegherà quell'MP deve essere scalato o ricreato.
    Scalabilità del rendimento Se hai implementato più proxy in un ambiente e uno di questi riceve molto traffico, quindi viene scalato automaticamente di frequente, tutti i proxy nell'ambiente verranno scalati di conseguenza. L'effetto sulle prestazioni della scalabilità con un singolo proxy a traffico elevato potrebbe essere un problema.
    Vicino rumoroso Se hai eseguito il deployment di più proxy nello stesso ambiente, si arresta in modo anomalo, tutti i proxy nell'ambiente vengono rimossi mentre I MP vengono riavviati. Se limiti il numero di proxy di cui è stato eseguito il deployment in un ambiente, riduci al minimo l'impatto del crash di un singolo proxy.

    Riferimento per la configurazione dell'ambiente

    Per un elenco completo degli elementi di configurazione dell'ambiente, consulta envs nella Riferimento alle proprietà di configurazione.

    Utilizzo degli ambienti

    Per ulteriori informazioni sulla configurazione, consulta i seguenti argomenti: