Configura hosts virtuales

En este tema, se analiza la propiedad de configuración virtualhosts. Los hosts virtuales permiten que Apigee Hybrid controle solicitudes a la API a alias de host asociados a un grupo de entorno. Para obtener más información, consulta Enrutamiento y rutas base en el tema Información acerca de los entornos y grupos de entornos.

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

Cuando llega una llamada al proxy de API, se enruta a los alias de host del grupo de entornos en el que se implementa el proxy de API.

A fin de obtener instrucciones para aplicar virtualhosts al clúster, consulta Aplica cambios de virtualhosts. Para obtener información sobre la configuración de TLS, consulta Configura TLS y mTLS en Istio ingress.

Agrega varios hosts virtuales

La propiedad virtualhosts[] es un arreglo y, por lo tanto, puedes crear más de una.

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

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

Para obtener información sobre la configuración de TLS, consulta Configura TLS y mTLS en Istio ingress.

Aplicando cambios virtualhosts

Si solo agregas o cambias la propiedad virtualhosts, y nada más, puedes aplicar esos cambios con la marca ‑‑settings:

apigeectl apply -f overrides-file.yaml ‑‑settings virtualhosts

Si, por ejemplo, cambias virtualhosts y env, debes aplicar el cambio sin usar ‑‑settings, de la siguiente manera, para actualizar el clúster. Por ejemplo:

apigeectl apply -f overrides-file.yaml --env my-environment

O bien, para actualizar el componente en todos los entornos, de la siguiente manera:

apigeectl apply -f overrides-file.yaml --all-envs

Claves y certificados TLS

La propiedad virtualhost requiere una clave y un certificado TLS. La clave o el certificado se usan para proporcionar una comunicación segura con la puerta de enlace de entrada y debe ser compatible con los alias de host usados en el grupo de entorno especificado.

Tú decides la forma en la que generas pares de claves y certificados TLS adecuados para tu configuración híbrida. Los siguientes temas solo se proporcionan como muestras, destinadas principalmente a probar una instalación híbrida nueva si no es posible obtener credenciales TLS de otra manera: