API Gateway:Expor uma aplicação do ACK por meio de uma API HTTP

Pré-requisitos

1. Crie um cluster de contêineres. Para mais informações, consulte Create an ACK managed cluster.

2. Implante um microsserviço de exemplo no cluster ACK.

   Implantar um microsserviço de exemplo

   Faça login no console do Container Service for Kubernetes. No painel de navegação à esquerda, clique em Clusters.

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

   No canto superior direito da página Deployments, clique em Create from YAML. Use o yaml abaixo para implantar um Deployment chamado httpbin e um Service chamado 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

   Na página Deployments, clique no deployment httpbin para confirmar a implantação bem-sucedida da aplicação.

   A implantação será considerada bem-sucedida quando o status do Pod for Running.

Visão geral da solução

Esta solução envolve criar uma instância do Cloud-native API Gateway e associá-la ao cluster ACK. Em seguida, configure rotas no gateway para direcionar o tráfego à aplicação conteinerizada, permitindo que os clientes acessem o service pelo gateway de API.

1. Create a Cloud-native API Gateway instance.

   Crie uma instância do Cloud-native API Gateway com base no ambiente de microsserviços existente.

2. Create an HTTP API.

   Crie uma API HTTP.

3. Create a route.

   Adicione e publique uma rota para o service.

   1. Crie uma source de service.

      Adicione uma source de service no Cloud-native API Gateway e selecione ACK como tipo de source.

   2. Adicione um service.

      O Cloud-native API Gateway recupera o namespace do service da source ACK e adiciona o service existente como service de backend.

4. Debug the route.

   Teste a rota do microsserviço.

Etapa 1: Criar uma instância do Cloud-native API Gateway

1. Faça login no console do Cloud-native API Gateway. Se esta for a primeira vez que você usa o Cloud-native API Gateway, siga as etapas abaixo:

   Nota

   No primeiro acesso ao Cloud-native API Gateway, o sistema solicita autorização para criar uma função vinculada ao service.

   1. Clique em Authorize Now. Na caixa de diálogo exibida, clique em OK.

   2. Clique em Experience Cloud-native API Gateway Now para acessar o console.

2. No painel de navegação à esquerda, escolha Instance. Na barra de menu superior, selecione uma região e clique em Create Instance.

   Importante

   A instância do Cloud-native API Gateway deve estar na mesma região do cluster ACK.

3. Na página de compra do Cloud-native API Gateway, configure os parâmetros da instância e clique em Buy Now.

   Configure os parâmetros principais, incluindo Region, Gateway Name, Gateway Specification, VPC e VSwitch.

4. Na página Confirm Order, marque a caixa de seleção I have read and agree to the Cloud-native API Gateway (Pay-As-You-Go) Terms of Service e clique em Activate Now.

   Nota

   A criação da instância pode levar de 2 a 3 minutos.

5. Clique em Management Console e retorne à página Instance para visualizar as informações e o status do gateway.

   O gateway foi criado com sucesso se o Status for Running.

Etapa 2: Criar uma API HTTP

1. No painel de navegação à esquerda, acesse APIs e clique em Create API.

2. No cartão HTTP API, clique em Create. No painel Create HTTP API, insira um API Name e clique em Create.

Etapa 3: Criar uma rota

1. No painel de navegação à esquerda, acesse a página APIs e clique no nome da API.

   Clique em Create Route. No painel Create Route, configure os parâmetros.

Informações básicas da rota

• Domínio: Clique em Add Domain à direita para criar um nome de domínio no painel Add Domain.

• Caminho: Corresponde a solicitações HTTP cujo caminho começa com /.

Instância e service de backend

1. Na lista suspensa Instance, selecione a instância criada na Etapa 1.

   Na seção Backend Service, configure Service Name, Service Port e Protocol.

2. Cenários: Na lista Scenario, selecione Single Service.

3. Na seção Backend Services, clique em Associated Service na lista suspensa Service Name.

4. Crie uma source de service e um service.

   1. Em Source Type, selecione ACK.

   2. Clique em Add Source e selecione o cluster criado na seção Pré-requisitos.

   3. Em Services, selecione o service httpbin e clique em OK.

   4. Na seção Backend Services, selecione o service httpbin adicionado na lista suspensa Service Name.

5. Clique em Save and Publish.

Etapa 4: Depurar a rota

1. No painel de navegação à esquerda, acesse a página APIs e clique no nome da API.

2. Na lista de rotas, localize a rota httpbin-demo e clique em Debug na coluna Actions.

3. Insira version como parâmetro de solicitação e clique em Send para visualizar a resposta do service.

   A resposta inclui version: v1 e hostname: httpbin-xxx, onde xxx representa o sufixo do nome real do Pod.

Documentos relacionados

• Para saber como gerenciar vários clusters ACK, consulte Use Cloud-native API Gateway to manage multiple ACK clusters.

• Se encontrar problemas ao usar o Cloud-native API Gateway, consulte FAQ.