Complemento de roteamento de aplicativos HTTP para o Serviço de Kubernetes do Azure (AKS) (desativado)

Artigo
04/05/2023

Cuidado

O complemento de roteamento de aplicativo HTTP (versão prévia) para o Serviço de Kubernetes do Azure (AKS) será desativado em 03 de março de 2025. Recomendamos que migre para o complemento Roteamento de Aplicativos até essa data.

O complemento de roteamento de aplicativos HTTP facilita o acesso a aplicativos implantados em seu cluster do Serviço de Kubernetes do Azure (AKS) por:

Configuração de um controlador de entrada em seu cluster AKS.
Criação de nomes DNS acessíveis ao público para pontos de extremidade do aplicativo
Criação de uma zona DNS em sua assinatura. Para obter mais informações sobre o custo DNS, consulte preços do DNS.

Antes de começar

O complemento de roteamento de aplicativos HTTP não funciona com as versões 1.22.6 e posteriores do AKS.
Se você estiver executando comandos localmente, instale kubectl usando o comando az aks install-cli.

Visão geral do complemento de Roteamento de aplicativos HTTP

O complemento implanta dois componentes: um Controlador de entrada do Kubernetes e um controlador de DNS externo.

Controlador de entrada: O controlador de entrada é exposto à internet usando um serviço LoadBalancer do Kubernetes. O controlador de entrada inspeciona e implementa recursos de entrada do Kubernetes e cria rotas para pontos de extremidade do aplicativo.
Controlador de DNS Externo: O controlador de DNS Externo inspeciona os recursos de Entrada do Kubernetes e cria registros A de DNS na zona DNS específica do cluster.

Habilitar roteamento de aplicativos HTTP

Crie um novo cluster AKS e habilite o complemento de roteamento de aplicativos HTTP usando o comando az aks create com o parâmetro --enable-addons.
```
az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --enable-addons http_application_routing \
    --generate-ssh-keys
```
Você também pode ativar o roteamento HTTP em um cluster AKS existente usando o comando az aks enable-addons com o parâmetro --addons.
```
az aks enable-addons --resource-group myResourceGroup --name myAKSCluster --addons http_application_routing
```

Recupere o nome da zona DNS usando o comando az aks show. Você precisa do nome da zona DNS para implantar aplicativos para o cluster.

az aks show --resource-group myResourceGroup --name myAKSCluster --query addonProfiles.httpApplicationRouting.config.HTTPApplicationRoutingZoneName -o table

Sua saída deve ser semelhante ao seguinte exemplo de saída:

9f9c1fe7-21a1-416d-99cd-3543bb92e4c3.eastus.aksapp.io

Conectar-se ao cluster do AKS

Configure o kubectl para se conectar ao cluster do Kubernetes usando o comando az aks get-credentials. O seguinte exemplo obtém as credenciais para o cluster do AKS chamado myAKSCluster no myResourceGroup:
```
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
```

Usar roteamento de aplicativo HTTP

Importante

O complemento de roteamento de aplicativos HTTP só pode ser disparado nos recursos de entrada com a seguinte anotação:

annotations:
 kubernetes.io/ingress.class: addon-http-application-routing

Crie um arquivo nomeado samples-http-application-routing.yaml e copie no YAML a seguir. Na linha 43, atualize <CLUSTER_SPECIFIC_DNS_ZONE> com o nome da zona DNS que você coletou na etapa anterior.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: aks-helloworld
spec:
  replicas: 1
  selector:
    matchLabels:
      app: aks-helloworld
  template:
    metadata:
      labels:
        app: aks-helloworld
    spec:
      containers:
      - name: aks-helloworld
        image: mcr.microsoft.com/azuredocs/aks-helloworld:v1
        ports:
        - containerPort: 80
        env:
        - name: TITLE
          value: "Welcome to Azure Kubernetes Service (AKS)"
---
apiVersion: v1
kind: Service
metadata:
  name: aks-helloworld
spec:
  type: ClusterIP
  ports:
 - port: 80
  selector:
    app: aks-helloworld
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: aks-helloworld
  annotations:
    kubernetes.io/ingress.class: addon-http-application-routing
spec:
  rules:
 - host: aks-helloworld.<CLUSTER_SPECIFIC_DNS_ZONE>
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: aks-helloworld
            port:
              number: 80

Crie os recursos usando o comando kubectl apply.

kubectl apply -f samples-http-application-routing.yaml

O seguinte exemplo mostra os recursos criados:

deployment.apps/aks-helloworld created
service/aks-helloworld created
ingress.networking.k8s.io/aks-helloworld created

Abra um navegador da Web para aks-helloworld.<CLUSTER_SPECIFIC_DNS_ZONE>, por exemplo, aks-helloworld.9f9c1fe7-21a1-416d-99cd-3543bb92e4c3.eastus.aksapp.io e verifique se você vê o aplicativo de demonstração. O aplicativo pode levar alguns minutos para aparecer.

Remover o roteamento de aplicativos HTTP

Remova o complemento de roteamento de aplicativos HTTP usando o parâmetro [az aks disable-addons][az-aks-disable-addons] command with the addons`.
```
az aks disable-addons --addons http_application_routing --name myAKSCluster --resource-group myResourceGroup --no-wait
```

Quando o complemento de roteamento de aplicativo HTTP está desativado, alguns recursos do Kubernetes podem permanecer no cluster. Estes recursos incluem configmaps e segredos e são criados no namespace kube-system. Para manter um cluster limpo, você talvez queira remover esses recursos. Procure recursos addon-http-application-routing usando os seguintes comandos kubectl get:

kubectl get deployments --namespace kube-system
kubectl get services --namespace kube-system
kubectl get configmaps --namespace kube-system
kubectl get secrets --namespace kube-system

O seguinte exemplo de saída mostra os configmaps que devem ser excluídos:

NAMESPACE     NAME                                                       DATA   AGE
kube-system   addon-http-application-routing-nginx-configuration         0      9m7s
kube-system   addon-http-application-routing-tcp-services                0      9m7s
kube-system   addon-http-application-routing-udp-services                0      9m7s

Exclua os recursos restantes usando o comando kubectl delete. Certifique-se de especificar o tipo de recurso, nome do recurso e o namespace. O exemplo a seguir exclui um dos configmaps anteriores:
```
kubectl delete configmaps addon-http-application-routing-nginx-configuration --namespace kube-system
```
Repita a etapa kubectl delete anterior para todos os recursos addon-http-application-routing que restam em seu cluster.

Solucionar problemas

Exiba os logs do aplicativo para o aplicativo DNS externo usando o comando kubectl logs.

kubectl logs -f deploy/addon-http-application-routing-external-dns -n kube-system

Os logs devem confirmar que um registro DNS A e TXT foram criados com sucesso, como mostrado no seguinte exemplo de saída:

time="2018-04-26T20:36:19Z" level=info msg="Updating A record named 'aks-helloworld' to '52.242.28.189' for Azure DNS zone '471756a6-e744-4aa0-aa01-89c4d162a7a7.canadaeast.aksapp.io'."
time="2018-04-26T20:36:21Z" level=info msg="Updating TXT record named 'aks-helloworld' to '"heritage=external-dns,external-dns/owner=default"' for Azure DNS zone '471756a6-e744-4aa0-aa01-89c4d162a7a7.canadaeast.aksapp.io'."

Exiba os logs de aplicativo para o controlador de entrada NGINX usando o comando kubectl logs.

kubectl logs -f deploy/addon-http-application-routing-nginx-ingress-controller -n kube-system

Os logs devem confirmar o CREATE de um recurso de entrada e a recarga do controlador, como mostrado no seguinte exemplo de saída:

-------------------------------------------------------------------------------
NGINX Ingress controller
  Release:    0.13.0
  Build:      git-4bc943a
  Repository: https://github.com/kubernetes/ingress-nginx
-------------------------------------------------------------------------------

I0426 20:30:12.212936       9 flags.go:162] Watching for ingress class: addon-http-application-routing
W0426 20:30:12.213041       9 flags.go:165] only Ingress with class "addon-http-application-routing" will be processed by this ingress controller
W0426 20:30:12.213505       9 client_config.go:533] Neither --kubeconfig nor --master was specified.  Using the inClusterConfig.  This might not work.
I0426 20:30:12.213752       9 main.go:181] Creating API client for https://10.0.0.1:443
I0426 20:30:12.287928       9 main.go:225] Running in Kubernetes Cluster version v1.8 (v1.8.11) - git (clean) commit 1df6a8381669a6c753f79cb31ca2e3d57ee7c8a3 - platform linux/amd64
I0426 20:30:12.290988       9 main.go:84] validated kube-system/addon-http-application-routing-default-http-backend as the default backend
I0426 20:30:12.294314       9 main.go:105] service kube-system/addon-http-application-routing-nginx-ingress validated as source of Ingress status
I0426 20:30:12.426443       9 stat_collector.go:77] starting new nginx stats collector for Ingress controller running in namespace  (class addon-http-application-routing)
I0426 20:30:12.426509       9 stat_collector.go:78] collector extracting information from port 18080
I0426 20:30:12.448779       9 nginx.go:281] starting Ingress controller
I0426 20:30:12.463585       9 event.go:218] Event(v1.ObjectReference{Kind:"ConfigMap", Namespace:"kube-system", Name:"addon-http-application-routing-nginx-configuration", UID:"2588536c-4990-11e8-a5e1-0a58ac1f0ef2", APIVersion:"v1", ResourceVersion:"559", FieldPath:""}): type: 'Normal' reason: 'CREATE' ConfigMap kube-system/addon-http-application-routing-nginx-configuration
I0426 20:30:12.466945       9 event.go:218] Event(v1.ObjectReference{Kind:"ConfigMap", Namespace:"kube-system", Name:"addon-http-application-routing-tcp-services", UID:"258ca065-4990-11e8-a5e1-0a58ac1f0ef2", APIVersion:"v1", ResourceVersion:"561", FieldPath:""}): type: 'Normal' reason: 'CREATE' ConfigMap kube-system/addon-http-application-routing-tcp-services
I0426 20:30:12.467053       9 event.go:218] Event(v1.ObjectReference{Kind:"ConfigMap", Namespace:"kube-system", Name:"addon-http-application-routing-udp-services", UID:"259023bc-4990-11e8-a5e1-0a58ac1f0ef2", APIVersion:"v1", ResourceVersion:"562", FieldPath:""}): type: 'Normal' reason: 'CREATE' ConfigMap kube-system/addon-http-application-routing-udp-services
I0426 20:30:13.649195       9 nginx.go:302] starting NGINX process...
I0426 20:30:13.649347       9 leaderelection.go:175] attempting to acquire leader lease  kube-system/ingress-controller-leader-addon-http-application-routing...
I0426 20:30:13.649776       9 controller.go:170] backend reload required
I0426 20:30:13.649800       9 stat_collector.go:34] changing prometheus collector from  to default
I0426 20:30:13.662191       9 leaderelection.go:184] successfully acquired lease kube-system/ingress-controller-leader-addon-http-application-routing
I0426 20:30:13.662292       9 status.go:196] new leader elected: addon-http-application-routing-nginx-ingress-controller-5cxntd6
I0426 20:30:13.763362       9 controller.go:179] ingress backend successfully reloaded...
I0426 21:51:55.249327       9 event.go:218] Event(v1.ObjectReference{Kind:"Ingress", Namespace:"default", Name:"aks-helloworld", UID:"092c9599-499c-11e8-a5e1-0a58ac1f0ef2", APIVersion:"extensions", ResourceVersion:"7346", FieldPath:""}): type: 'Normal' reason: 'CREATE' Ingress default/aks-helloworld
W0426 21:51:57.908771       9 controller.go:775] service default/aks-helloworld does not have any active endpoints
I0426 21:51:57.908951       9 controller.go:170] backend reload required
I0426 21:51:58.042932       9 controller.go:179] ingress backend successfully reloaded...
167.220.24.46 - [167.220.24.46] - - [26/Apr/2018:21:53:20 +0000] "GET / HTTP/1.1" 200 234 "" "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)" 197 0.001 [default-aks-helloworld-80] 10.244.0.13:8080 234 0.004 200

Limpar os recursos

Remova os objetos do Kubernetes associados criados neste artigo usando o comando kubectl delete.
```
kubectl delete -f samples-http-application-routing.yaml
```
O seguinte exemplo de saída mostra que os objetos do Kubernetes foram removidos:
```
deployment "aks-helloworld" deleted
service "aks-helloworld" deleted
ingress "aks-helloworld" deleted
```

Próximas etapas

Para obter informações sobre como instalar um controlador de entrada protegido por HTTPS no AKS, consulte Entrada HTTPS no Serviço de Kubernetes do Azure (AKS).

Compartilhar via