Share via

Desative e reative o complemento AGIC para seu cluster AKS

  • Artigo

O Application Gateway Ingress Controller (AGIC) implantado como um complemento AKS permite habilitar e desabilitar o complemento com uma linha na CLI do Azure. O ciclo de vida do Application Gateway será diferente quando você desabilitar o complemento AGIC, dependendo se o Application Gateway foi criado pelo complemento AGIC ou se foi implantado separadamente do complemento AGIC. Você pode executar o mesmo comando para reativar o complemento AGIC se alguma vez o desativar, ou para habilitar o complemento AGIC usando um cluster AKS existente e o Application Gateway.

Desativando o complemento AGIC com o Application Gateway associado

Se o complemento AGIC implantou automaticamente o Application Gateway para você quando você configurou tudo pela primeira vez, a desativação do complemento AGIC excluirá, por padrão, o Application Gateway com base em alguns critérios. Há dois critérios que o complemento AGIC procura para determinar se ele deve excluir o Application Gateway associado quando você o desabilita:

  • O Application Gateway ao qual o complemento AGIC está associado está implantado no grupo de recursos do nó MC_*?
  • O Application Gateway ao qual o complemento AGIC está associado tem a tag "created-by: ingress-appgw"? A tag é usada pela AGIC para determinar se o Application Gateway foi implantado pelo complemento ou não.

Se ambos os critérios forem atendidos, o complemento AGIC excluirá o Application Gateway criado quando o complemento for desativado; no entanto, ele não excluirá o IP público ou a sub-rede na qual o Application Gateway foi implantado com/em. Se o primeiro critério não for atendido, não importará se o Application Gateway tiver a tag "created-by: ingress-appgw" - desativar o complemento não excluirá o Application Gateway. Da mesma forma, se o segundo critério não for atendido, ou seja, o Application Gateway não tiver essa tag, desativar o complemento não excluirá o Application Gateway no grupo de recursos do nó MC_*.

Gorjeta

Se você não quiser que o Application Gateway seja excluído ao desabilitar o complemento, mas ele atender aos dois critérios, remova a tag "created-by: ingress-appgw" para impedir que o complemento exclua seu Application Gateway.

Para desativar o complemento AGIC, execute o seguinte comando:

az aks disable-addons -n <AKS-cluster-name> -g <AKS-resource-group-name> -a ingress-appgw

Habilite o complemento AGIC no Application Gateway e no AKS Cluster existentes

Se você desabilitar o complemento AGIC e precisar reativá-lo ou quiser habilitá-lo usando um cluster existente do Application Gateway e do AKS, execute o seguinte comando:

appgwId=$(az network application-gateway show -n <application-gateway-name> -g <resource-group-name> -o tsv --query "id") 
az aks enable-addons -n <AKS-cluster-name> -g <AKS-cluster-resource-group> -a ingress-appgw --appgw-id $appgwId

Próximos passos

Para obter mais detalhes sobre como habilitar o complemento AGIC usando um cluster existente do Application Gateway e do AKS, consulte Implantação de brownfield do complemento AGIC.