Container Service for Kubernetes:Access container services with an MSE Ingress

Pré-requisitos

Verifique se você tem:

• Um cluster ACK gerenciado, um cluster ACK Serverless ou um cluster ACS executando Kubernetes V1.18 ou posterior. Crie um cluster ACK gerenciado, Crie um cluster ACK Serverless ou Crie um cluster ACS. Atualize se estiver em uma versão anterior.

• Permissões RAM concedidas ao MSE Ingress Controller:

  • Cluster ACK gerenciado ou cluster ACK Serverless: Conceder permissões

  • Cluster ACS: Conceder permissões

Considerações:

• Se já existir um recurso IngressClass chamado mse no cluster antes da instalação do MSE Ingress Controller, o gateway e o recurso MseIngressConfig não serão criados automaticamente durante a instalação.

• No novo modo de instalação, instale o MSE Ingress Controller cria um recurso MseIngressConfig cujo ciclo de vida está vinculado à instância do gateway nativo da nuvem MSE. Exclua o recurso MseIngressConfig causa a exclusão em cascata do gateway nativo da nuvem MSE associado. Não exclua recursos MseIngressConfig salvo se instruído.

Etapa 1: Instale o MSE Ingress Controller

1. Faça logon no console ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, localize o cluster desejado e clique no nome dele. No painel de navegação à esquerda, clique em Add-ons.

3. Na página Add-ons, pesquise mse e clique em Install no cartão MSE Ingress Controller.

   

4. Na caixa de diálogo Install MSE Ingress Controller, crie ou selecione um gateway nativo da nuvem e clique em OK. Se as verificações prévias falharem, autorize o MSE Ingress Controller a acessar o MSE.

5. Após a instalação, um recurso MseIngressConfig e um gateway nativo da nuvem são criados automaticamente, ambos com o nome mse-ingress-premium-{clusterid}. Para verificar o status do gateway, acesse a página de detalhes do cluster e escolha Workloads > Deployments > Custom Resources. Na aba Resource Objects, pesquise mse na seção API Group. Aguarde de 3 a 5 minutos até que o campo phase atinja Listening antes de prosseguir. Verifique pela linha de comando:

   Status	Descrição
   Pending	O gateway está sendo criado. Aguarde cerca de 3 minutos.
   Running	O gateway foi criado e está em execução.
   Listening	O gateway está em execução e ouvindo recursos Ingress.
   Failed	O gateway está em um estado inválido. Verifique o campo Message em Status para identificar a causa.

   kubectl get mseingressconfig -A

   O gateway estará pronto quando a coluna PHASE exibir Listening.

   

6. Faça logon no console MSE para confirme que existe um gateway nativo da nuvem chamado mse-ingress-premium-{clusterid} na sua região.

   

Etapa 2: Implantar um serviço de back-end

1. Faça logon no console ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, localize o cluster desejado e clique no nome dele. No painel de navegação à esquerda, escolha Workloads > Deployments.

3. Na página Deployments, clique em Create from YAML e aplique o manifesto a seguir para implantar o Deployment e o Service httpbin:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: httpbin
     template:
       metadata:
         labels:
           app: httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse-ingress/go-httpbin
             args:
               - "--version=v1"
             imagePullPolicy: Always
             name: httpbin
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: httpbin
     namespace: default
   spec:
     ports:
       - port: 8080
         protocol: TCP
     selector:
       app: httpbin

   Verifique se o Deployment está em execução:

   kubectl get deployment httpbin -n default

   Saída esperada:

   NAME      READY   UP-TO-DATE   AVAILABLE   AGE
   httpbin   1/1     1            1           30s

Etapa 3: Configure uma rota MSE Ingress

1. Faça logon no console ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, localize o cluster desejado e clique no nome dele. No painel de navegação à esquerda, escolha Network > Ingresses.

3. Na página Ingresses, clique em Create Ingress.

4. Na caixa de diálogo Create Ingress, defina Gateway Type como MSE Ingress e configure a rota. Clique em OK.

   • Defina Ingress Class como mse.

   • Em Rule, selecione Prefix (Prefix-based Match).

   • Defina Path como /.

   • Defina Service como httpbin.

   

5. Faça logon no console MSE para confirme que uma rota contendo httpbin está configurada. Verifique pela linha de comando:

   kubectl get ingress -n default

   Saída esperada:

   NAME      CLASS   HOSTS   ADDRESS                                               PORTS   AGE
   httpbin   mse     *       nlb-b4ewsj2******.cn-hangzhou.nlb.aliyuncsslb.com    80      30s

   

Etapa 4: Acesse o serviço

1. Faça logon no console ACK. No painel de navegação à esquerda, clique em Clusters.

2. Na página Clusters, localize o cluster desejado e clique no nome dele. No painel de navegação à esquerda, escolha Network > Ingresses.

3. Na página Ingresses, localize o endpoint do Ingress na coluna Address. A coluna Address exibe o endereço do balanceador de carga NLB alocado automaticamente, que corresponde ao endpoint de acesso do MSE Ingress.

   

4. Acesse o serviço usando o nome de domínio NLB ou o IP público do gateway. Por exemplo:

   curl http://nlb-b4ewsj2******.cn-hangzhou.nlb.aliyuncsslb.com/version

   Uma resposta bem-sucedida confirme que o serviço está acessível.

   

Próximas etapas

• Roteamento avançado: Configure anotações de Ingress para ative divisão de tráfego, lançamentos canário e reescrita de requisições.

• Terminação TLS: Configure um certificado no gateway nativo da nuvem MSE para HTTPS.

• Monitoramento: Visualize métricas do gateway e logs de acesso no console MSE.

• Limpeza: Exclua o Deployment, o Service e o Ingress httpbin pelo console ACK ou execute kubectl delete deployment,service,ingress httpbin -n default.