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

APLICA-SE A: Desenvolvedor | Premium

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 (AKS). 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.

Nota

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

Pré-requisitos

• crie uma instância da Gestão de API do Azure
• Crie um cluster do Azure Kubernetes usando a CLI do Azure, usando o Azure PowerShell ou usando o portal do Azure.
• Provisione um recurso de gateway em sua instância de Gerenciamento de API.

Implantar o gateway autogerido 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 <nome do gateway.yml> ao lado de Implementação para baixar o arquivo.

7. Ajuste o config.service.endpoint, os mapeamentos de porta e o nome do contentor no ficheiro .yml como 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 seguinte exemplo 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 ordena o 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 seguinte comando para verificar se o pod do gateway está em execução. Este nome de pod é um exemplo.

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

13. Execute o seguinte comando para verificar se o serviço de gateway está em execução. O nome do serviço e os endereços IP são exemplos.

    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 verifique se o nó de gateway implantado está relatando status funcional.

Gorjeta

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

Conteúdo relacionado

• Para saber mais sobre o gateway auto-hospedado, consulte Visão geral do gateway auto-hospedado do Gerenciamento de API do Azure.
• Saiba como implementar o gateway auto-hospedado da Gestão de API em clusters Kubernetes com Azure Arc.
• Saiba mais sobre as capacidades de observabilidade dos gateways do Gerenciamento de API do Azure.
• Saiba mais sobre as orientações sobre como executar o gateway auto-hospedado no Kubernetes em produção.
• Saiba mais sobre o Serviço Kubernetes do Azure.