Compartilhar via

Implantar um gateway auto-hospedado do Gerenciamento de API do Azure no Serviço de Kubernetes do Azure

  • Artigo

APLICA-SE A: Desenvolvedor | Premium

Este artigo fornece as etapas necessárias para implantar um componente de gateway auto-hospedado do Gerenciamento de API do Azure no Serviço de Kubernetes do Azure. Para implantar o gateway auto-hospedado em um cluster Kubernetes, consulte o artigo de instruções para implantação usando um arquivo de implantação YAML ou com Helm.

Importante

O suporte para as imagens de contêiner do gateway auto-hospedado versão 0 e versão 1 do Gerenciamento de API do Azure termina em 1º de outubro de 2023, acompanhado da API de Configuração correspondente v1. Use nosso guia de migração para usar o gateway auto-hospedado v2.0.0 ou superior com a API de Configuração v2. Saiba mais em nossa documentação de reprovação

Observação

Você também pode implantar o gateway auto-hospedado em um cluster do Kubernetes habilitado para o Azure Arc como uma extensão de cluster.

Pré-requisitos

Implantar um gateway auto-hospedado no AKS

  1. Selecione Gateways na opção Implantação e infraestrutura.

  2. Selecione o recurso de gateway auto-hospedado que deseja implantar.

  3. Selecione a opção Implantação.

  4. Um novo token na caixa de texto Token foi gerado automaticamente para você usando os valores padrão de Vencimento e Chave Secreta. Ajuste um ou ambos, se desejado, e selecione Gerar para criar um novo token.

  5. Verifique se o Kubernetes está selecionado na opção Scripts de implantação.

  6. Selecione o link do arquivo <gateway-name>.yml ao lado da Implantação para baixar o arquivo.

  7. Ajuste o config.service.endpoint, os mapeamentos de porta e o nome de contêiner no arquivo .yml conforme necessário.

  8. Dependendo do seu cenário, talvez seja necessário alterar o tipo de serviço.

    • O valor padrão é LoadBalancer, que é o balanceador de carga externo.
    • Use o balanceador de carga interno para restringir o acesso ao gateway auto-hospedado somente aos usuários internos.
    • O exemplo abaixo usa a NodePort.

  9. Selecione o ícone de Cópia localizado na extremidade direita da caixa de texto Implantar para salvar o comando kubectl na área de transferência.

  10. Cole o comando na janela do terminal (ou comando). O comando espera que o arquivo de ambiente baixado esteja presente no diretório atual.

    kubectl apply -f <gateway-name>.yaml

  11. Execute o comando. O comando instrui o cluster do AKS a:

    • Executar o contêiner usando a imagem do gateway auto-hospedado baixada do Microsoft Container Registry.
    • Configurar o contêiner para expor as portas HTTP (8080) e HTTPS (443).

  12. Execute o comando abaixo para verificar se o pod do gateway está em execução. O nome do pod será diferente.

    kubectl get pods
NAME                                   READY     STATUS    RESTARTS   AGE
contoso-apim-gateway-59f5fb94c-s9stz   1/1       Running   0          1m

  13. Execute o comando abaixo para verificar se o serviço do gateway está em execução. O nome do serviço e os endereços IP serão diferentes.

    kubectl get services
NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
contosogateway   NodePort    10.110.230.87   <none>        80:32504/TCP,443:30043/TCP   1m

  14. Volte ao portal do Azure e confirme se o nó de gateway implantado relata um status íntegro.

Dica

Use o comando kubectl logs <gateway-pod-name> para exibir um instantâneo do log do gateway auto-hospedado.

Próximas etapas