Partilhar via

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

  • Artigo

APLICA-SE A: Developer | Prémio

Este artigo fornece as etapas para implantar o componente de gateway auto-hospedado do Gerenciamento de API do Azure no Serviço 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 YAML de implantação ou com o Helm.

Importante

O suporte para imagens de contêiner de gateway auto-hospedado do Azure API Management versão 0 e versão 1 termina em 1º de outubro de 2023, juntamente com sua API de Configuração v1 correspondente. 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 substituição

Nota

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

Pré-requisitos

Implantar o gateway auto-hospedado no AKS

  1. Selecione Gateways em Implantação e infraestrutura.

  2. Selecione o recurso de gateway auto-hospedado que você pretende implantar.

  3. Selecione Implantação.

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

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

  6. Selecione <o link do arquivo gateway-name>.yml ao lado de Deployment para baixar o arquivo.

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

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

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

  9. Selecione o ícone de cópia localizado na extremidade direita da caixa de texto Implantar para salvar o kubectl comando 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 seu cluster AKS a:

    • Execute o contêiner, usando a imagem do gateway auto-hospedado baixada do Microsoft Container Registry.
    • Configure o contêiner para expor 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 seu 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 de 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. Retorne ao portal do Azure e confirme se o nó do gateway implantado está relatando o status íntegro.

Gorjeta

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

Próximos passos