Configurar hosts virtuais

Neste tópico, abordamos a propriedade de configuração virtualhosts. Os hosts virtuais permitem que a Apigee híbrida processe solicitações de API para hostaliases associados a um grupo de ambiente. Para mais informações, consulte Caminhos de roteamento e base no tópico Sobre ambientes e grupos de ambiente.

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

Quando uma chamada de proxy de API chega, ela é encaminhada para os aliases de host do grupo de ambientes em que o proxy da API está implantado.

Para instruções sobre como aplicar virtualhosts ao cluster, consulte Como aplicar alterações de hosts virtuais. Para ver informações sobre como configurar o TLS, consulte Como configurar o TLS e o mTLS na entrada do Istio.

Como adicionar vários hosts virtuais

A propriedade virtualhosts[] é uma matriz e, portanto, você pode criar mais de uma.

...
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
...

Para ver informações sobre como configurar o TLS, consulte Como configurar o TLS e o mTLS na entrada do Istio.

Como aplicar alterações virtualhosts

Se você só adicionar ou mudar a propriedade virtualhosts, aplique as mudanças com o gráfico apigee-virtualhost e o nome do grupo de ambientes em que as mudanças serão aplicadas:

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

Se, por exemplo, você alterar virtualhosts e env, aplique a alteração com helm upgrade sem usar a sinalização ENV_GROUP apigee-virtualhost/ para atualizar o cluster. Por exemplo:

Execute o upgrade do helm para cada ambiente que você quer atualizar.

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

Certificados e chaves TLS

A propriedade virtualhost requer uma chave TLS e um certificado. A chave/certificado são usados para fornecer uma comunicação segura com o gateway de entrada e precisam ser compatíveis com os aliases de host usados no grupo de ambiente especificado.

Você decide como gerar pares de certificado/chave TLS adequados para sua configuração híbrida. Os tópicos a seguir são fornecidos apenas como exemplos, destinados principalmente a avaliar ou testar uma nova instalação híbrida, se não for possível obter credenciais TLS de outra maneira: