Configura host virtuali

Questo argomento illustra la proprietà di configurazione virtualhosts. Gli host virtuali consentono ad Apigee hybrid di gestire Richieste API ad alias host associati a un gruppo di ambiente. Per ulteriori informazioni, vedi Routing e base di percorsi nella sezione Informazioni ambienti e gruppi di ambienti. 

...
virtualhosts:
  - name: my-env-group
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.key
...

Quando arriva una chiamata proxy API, questa viene instradata all'alias host del gruppo di ambiente in cui viene eseguito il deployment del proxy API.

Per istruzioni su come applicare virtualhosts al cluster, consulta Applicazione delle modifiche a virtualhosts. Per informazioni sulla configurazione TLS, consulta Configurare TLS e mTLS su Istio in entrata.

Aggiunta di più host virtuali

La proprietà virtualhosts[] è un array, quindi puoi creare più di uno. 

...
virtualhosts:
  - name: my-env-group-1
    sslCertPath: ./certs/fullchain1.pem
    sslKeyPath: ./certs/privkey1.key

  - name: my-env-group-2
    sslCertPath: ./certs/fullchain2.pem
    sslKeyPath: ./certs/privkey2.key
...

Per informazioni sulla configurazione TLS, consulta Configurare TLS e mTLS su Istio in entrata.

Applicazione di virtualhosts di modifiche in corso...

Se aggiungi o modifichi solo virtualhosts e nient'altro, puoi applicare queste modifiche con il flag ‑‑settings:

Helm

helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml ‑‑settings virtualhosts

Se, ad esempio, modifichi virtualhosts e env, poi tu deve applicare la modifica senza utilizzare ENV_GROUP_NAME apigee-virtualhost/ per Helm o ‑‑settings virtualhosts per apigeectl, in questo modo, per aggiornare il cluster. Ad esempio:

Helm

Esegui l'upgrade di Helm per ogni ambiente che vuoi aggiornare.

helm upgrade ENV_NAME apigee-env/ \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE.yaml

apigeectl

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --env ENV_NAME

o per aggiornare il componente per tutti gli ambienti: 

$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --all-envs

Chiavi e certificati TLS

La proprietà virtualhost richiede una chiave TLS e un certificato. La chiave o il certificato vengono utilizzati per fornire una comunicazione sicura con il gateway in entrata e deve essere compatibile con gli alias host utilizzati nel gruppo di ambiente specificato.

Spetta a te generare le coppie di certificati/chiavi TLS appropriate per il tuo modello configurazione. I seguenti argomenti vengono forniti solo a titolo di esempio, pensati principalmente per provare o testare una nuova installazione ibrida se non è possibile ottenere Credenziali TLS in un altro modo: