Implantar um gateway auto-hospedado no Kubernetes com o YAML
APLICA-SE A: Developer | Prémio
Este artigo descreve as etapas para implantar o componente de gateway auto-hospedado do Gerenciamento de API do Azure em um cluster Kubernetes.
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
- Conclua o guia de início rápido seguinte: Criar uma instância da Gestão de API do Azure.
- Crie um cluster Kubernetes ou tenha acesso a um existente.
Gorjeta
Os clusters de nó único funcionam bem para fins de desenvolvimento e avaliação. Use clusters de vários nós certificados pelo Kubernetes no local ou na nuvem para cargas de trabalho de produção.
- Provisione um recurso de gateway auto-hospedado em sua instância de Gerenciamento de API.
Implementar no Kubernetes
Gorjeta
As etapas a seguir implantam o gateway auto-hospedado no Kubernetes e habilitam a autenticação para a instância de Gerenciamento de API usando um token de acesso de gateway (chave de autenticação). Você também pode implantar o gateway auto-hospedado no Kubernetes e habilitar a autenticação para a instância de Gerenciamento de API usando o Microsoft Entra ID.
- Selecione Gateways em Implantação e infraestrutura.
- Selecione o recurso de gateway auto-hospedado que você deseja implantar.
- Selecione Implantação.
- Um token de acesso na caixa de texto Token foi gerado automaticamente para você, com base nos valores padrão das chaves Expiração e Segredo. Se necessário, escolha valores em um ou ambos os controles para gerar um novo token.
- Selecione a guia Kubernetes em Scripts de implantação.
- Selecione o <link do arquivo gateway-name>.yml e baixe o arquivo YAML.
- Selecione o ícone de cópia no canto inferior direito da caixa de texto Implantar para salvar os
kubectl
comandos na área de transferência. - Ao usar o Serviço Kubernetes do Azure (AKS), execute
az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin
em uma nova sessão de terminal. - Execute os comandos para criar os objetos Kubernetes necessários no namespace padrão e inicie pods de gateway auto-hospedados a partir da imagem de contêiner baixada do Microsoft Artifact Registry.
- A primeira etapa cria um segredo do Kubernetes que contém o token de acesso gerado na etapa 4. Em seguida, ele cria uma implantação do Kubernetes para o gateway auto-hospedado que usa um ConfigMap com a configuração do gateway.
Confirme se o gateway está em execução
Execute o seguinte comando para verificar se a implantação foi bem-sucedida. Pode levar um pouco de tempo para que todos os objetos sejam criados e para que os pods sejam inicializados.
kubectl get deployments
Deve voltar
NAME READY UP-TO-DATE AVAILABLE AGE <gateway-name> 1/1 1 1 18s
Execute o seguinte comando para verificar se os serviços foram criados com êxito. Os IPs e as portas do seu serviço serão diferentes.
kubectl get services
Deve voltar
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE <gateway-name>-live-traffic ClusterIP None <none> 4290/UDP,4291/UDP 9m1s <gateway-name>-instance-discovery LoadBalancer 10.99.236.168 <pending> 80:31620/TCP,443:30456/TCP 9m1s
Volte para o portal do Azure e selecione Visão geral.
Confirme se Status mostra uma marca de seleção verde, seguida por uma contagem de nós que corresponde ao número de réplicas especificadas no arquivo YAML. Esse status significa que os pods de gateway auto-hospedados implantados estão se comunicando com êxito com o serviço de Gerenciamento de API e têm uma "pulsação" regular.
Gorjeta
- Execute o
kubectl logs deployment/<gateway-name>
comando para visualizar logs de um pod selecionado aleatoriamente se houver mais de um. - Execute
kubectl logs -h
para obter um conjunto completo de opções de comando, como exibir logs para um pod ou contêiner específico.
Próximos passos
- Para saber mais sobre o gateway auto-hospedado, consulte Visão geral do gateway auto-hospedado.
- Saiba como implantar o gateway auto-hospedado do Gerenciamento de API em clusters Kubernetes habilitados para Azure Arc.
- Saiba mais sobre as orientações para executar o gateway auto-hospedado no Kubernetes em produção.