Implantar um gateway de Gerenciamento de API do Azure no Azure Arc (visualização)

  • Artigo

APLICA-SE A: Developer | Prémio

Com a integração entre o Gerenciamento de API do Azure e o Azure Arc no Kubernetes, você pode implantar o componente de gateway de Gerenciamento de API como uma extensão em um cluster Kubernetes habilitado para Azure Arc.

A implantação do gateway de Gerenciamento de API em um cluster Kubernetes habilitado para Azure Arc expande o suporte ao Gerenciamento de API para ambientes híbridos e multicloud. Habilite a implantação usando uma extensão de cluster para tornar o gerenciamento e a aplicação de políticas ao cluster habilitado para ArcGIS do Azure uma experiência consistente.

Importante

O gateway auto-hospedado do Gerenciamento de API no Azure Arc está atualmente em visualização. Durante a visualização, a extensão do gateway de Gerenciamento de API está disponível nas seguintes regiões:

  • Ásia (Leste, Sudeste)
  • Austrália (Central, Central 2, Leste e Sudeste)
  • Brasil (Sul e Sudeste)
  • Canadá (Central, Leste)
  • Europa (Norte, Oeste)
  • França (Centro e Sul)
  • Alemanha (Norte e Centro-Oeste)
  • Índia (Central, Sul, Oeste, Jio central & Jio Oeste)
  • Japão (Leste e Oeste)
  • Coreia (Central e Sul)
  • Noruega (Leste e Oeste)
  • África do Sul (Norte e Oeste)
  • Suécia (Central)
  • Suíça (Norte e Oeste)
  • Emirados Árabes Unidos (EAU - Central & Norte)
  • Reino Unido (Reino Unido -Sul)
  • Estados Unidos (EUA - Central, Central EUAP, Leste, Leste 2, Leste 2 EUAP, Centro-Norte, Centro-Sul, Centro-Oeste, Oeste, Oeste 2, Oeste 3)

Nota

Você também pode implantar o gateway auto-hospedado diretamente no Kubernetes.

Pré-requisitos

Implantar a extensão de gateway de Gerenciamento de API usando a CLI do Azure

  1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Selecione Gateways no menu de navegação lateral.

  3. Selecione e abra seu recurso de gateway provisionado na lista.

  4. No recurso de gateway provisionado, clique em Implantação no menu de navegação lateral.

  5. Anote os valores de Token e URL de configuração para a próxima etapa.

  6. Na CLI do Azure, implante a extensão de gateway usando o az k8s-extension create comando. Preencha os token valores e configuration URL .

    • O exemplo a seguir usa a configuração de service.type='LoadBalancer' extensão. Veja mais configurações de extensão disponíveis.
    az k8s-extension create --cluster-type connectedClusters --cluster-name <cluster-name> \
    --resource-group <rg-name> --name <extension-name> --extension-type Microsoft.ApiManagement.Gateway \
    --scope namespace --target-namespace <namespace> \
    --configuration-settings gateway.configuration.uri='<Configuration URL>' \
    --config-protected-settings gateway.auth.token='<token>' \
    --configuration-settings service.type='LoadBalancer' --release-train preview

    Gorjeta

    -protected- flag for gateway.auth.token é opcional, mas recomendado.

  7. Verifique o status da implantação usando o seguinte comando da CLI:

    az k8s-extension show --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <rg-name> --name <extension-name>

  8. Navegue de volta para a lista Gateways para verificar se o status do gateway mostra uma marca de seleção verde com uma contagem de nós. 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.
    • Ter um "batimento cardíaco" regular.

Implantar a extensão do gateway de Gerenciamento de API usando o portal do Azure

  1. No portal do Azure, navegue até o cluster conectado ao Azure Arc.

  2. No menu à esquerda, selecione Extensões>+ Adicionar>gateway de gerenciamento de API (visualização).

  3. Selecione Criar.

  4. Na janela Instalar gateway de Gerenciamento de API, configure a extensão do gateway:

    • Selecione a assinatura e o grupo de recursos para sua instância de Gerenciamento de API.
    • Em Detalhes do gateway, selecione a instância de Gerenciamento de API e o nome do gateway. Insira um escopo de namespace para sua extensão e, opcionalmente, um número de réplicas, se suportado em sua camada de serviço de gerenciamento de API.
    • Em Configuração do Kubernetes, selecione a configuração padrão ou uma configuração diferente para o cluster. Para obter opções, consulte Configurações de extensão disponíveis.

    Captura de ecrã a mostrar a implementação da extensão no portal do Azure

  5. Na guia Monitoramento, habilite opcionalmente o monitoramento para carregar solicitações de rastreamento de métricas para o gateway e o back-end. Se habilitado, selecione um espaço de trabalho existente do Log Analytics .

  6. Selecione Rever + instalar e, em seguida, Instalar.

Configurações de extensão disponíveis

A extensão de gateway auto-hospedado para Azure Arc fornece muitas definições de configuração para personalizar a extensão para seu ambiente. Esta seção lista as configurações de implantação necessárias e as configurações opcionais para integração com o Log Analytics. Para obter uma lista completa de configurações, consulte a referência da extensão de gateway auto-hospedado.

Configurações necessárias

As seguintes configurações de extensão são necessárias.

Definição Descrição
gateway.configuration.uri Ponto de extremidade de configuração no serviço de Gerenciamento de API para o gateway auto-hospedado.
gateway.auth.token Token de gateway (chave de autenticação) para autenticar no serviço de Gerenciamento de API. Normalmente começa com GatewayKey.
service.type Configuração do serviço Kubernetes para o gateway: LoadBalancer, NodePortou ClusterIP.

Configurações do Log Analytics

Para habilitar o monitoramento do gateway auto-hospedado, defina as seguintes configurações do Log Analytics:

Definição Descrição
monitoring.customResourceId ID de recurso do Azure Resource Manager para a instância de Gerenciamento de API.
monitoring.workspaceId ID do espaço de trabalho do Log Analytics.
monitoring.ingestionKey Segredo com chave de ingestão do Log Analytics.

Nota

Se você não ativou o Log Analytics:

  1. Percorra o início rápido do espaço de trabalho Criar um Log Analytics.
  2. Saiba onde encontrar as configurações do agente do Log Analytics.

Passos Seguintes