Informazioni sugli ambienti

Un ambiente fornisce un contesto o una "sandbox" isolati per l'esecuzione di proxy API. In una singola organizzazione puoi creare più ambienti. Per saperne di più, consulta Informazioni su ambienti e gruppi di ambienti.

Il seguente codice mostra un esempio di configurazione delle sostituzioni in cui sono definiti più ambienti. 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 arriva all'ingresso, quest'ultimo sa di inviarla all'elaboratore di messaggi associato all'ambiente test, che gestisce la richiesta.

    Analogamente, se foo1 viene implementato anche nell'ambiente prod, puoi effettuare una richiesta proxy come questa all'alias host apiprod.mydomain.net: 

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

    La chiamata viene inoltrata dall'ingresso all'MP associato all'host.

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

    Best practice: crea più ambienti e implementa un numero limitato di proxy in ciascuno. Puoi creare regole di routing che specificano gli ambienti a cui indirizzare percorsi base di 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. In un ambiente ibrido, la best practice è creare più ambienti e implementare un numero limitato di proxy in ciascuno.

    Quanti proxy devi implementare in un ambiente? Non esiste una risposta fissa a questa domanda. Tuttavia, la tabella seguente fornisce indicazioni generali sul perché è consigliabile limitare il numero di proxy di cui è stato eseguito il deployment in ogni ambiente e su cosa occorre tenere presente quando si gestiscono i deployment dei proxy:

    Problema da considerare Descrizione
    Tempo di avvio del processore di messaggi Esiste una correlazione diretta tra il tempo necessario per l'avvio di un elaboratore di messaggi (MP) e il numero di proxy di cui è stato eseguito il deployment in quell'MP. In un ambiente Kubernetes con scalabilità automatica, un aumento del tempo di avvio potrebbe essere un problema. Più proxy vengono di'implementati nel pool di proxy, più tempo occorrerà per la sua attivazione se deve essere scalato o ricreato.
    Prestazioni di scalabilità 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 sul rendimento della scalabilità di più proxy con un singolo proxy ad alto traffico potrebbe essere un problema.
    Vicino rumoroso Se hai diversi proxy di cui è stato eseguito il deployment nello stesso ambiente e uno si arresta in modo anomalo, tutti i proxy nell'ambiente verranno disattivati durante il riavvio degli MP. 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 nel riferimento per le proprietà di configurazione.

    Utilizzo degli ambienti

    Per ulteriori informazioni sulla configurazione, consulta i seguenti argomenti: