Implantar um aplicativo em clusters do Anthos na AWS

Esta página fornece instruções de início rápido para criar um cluster e um pool de nós e implantar um aplicativo de amostra usando clusters do Anthos na AWS.

Guia de início rápido do cluster com o Terraform

É possível usar o Terraform para criar um cluster e um pool de nós. Antes de criar o cluster, os scripts do Terraform também preparam a VPC da AWS.

Saiba mais sobre o Terraform em um ambiente da AWS na Referência de clusters do Terraform e na Referência de pools de nós do Terraform.

Depois de criar uma VPC e um cluster com o Terraform, pule para Implantar um aplicativo no cluster para implantar um aplicativo de amostra.

Guia de início rápido do cluster sem o Terraform

Se você preferir preparar a VPC da AWS e criar um cluster e um pool de nós sem o Terraform, siga estas instruções.

Antes de começar

Antes de criar um cluster, conclua os pré-requisitos. Especificamente, é necessário fornecer os seguintes recursos:

• Uma VPC da AWS em que o cluster será executado.
• Até três sub-redes da AWS para as três réplicas do plano de controle. Cada um precisa estar em uma zona de disponibilidade diferente da AWS.
• O papel do IAM da AWS que os clusters do Anthos na AWS terão ao gerenciar o cluster. Isso requer um conjunto específico de permissões do IAM.
• Chaves CMK simétricas do KMS para criptografia e configuração de dados do cluster (etcd) em repouso.
• O perfil da instância do IAM da AWS para cada réplica do plano de controle. Isso requer um conjunto específico de permissões do IAM.
• Um par de chaves SSH do EC2 (opcional) se você precisar de acesso SSH às instâncias do EC2 que executam cada réplica do plano de controle.

É sua responsabilidade criar e gerenciar esses recursos, que podem ser compartilhados entre todos os clusters do Anthos nos clusters do Azure. Todos os outros recursos subjacentes da AWS no escopo do cluster são gerenciados por clusters do Anthos na AWS.

Definir as configurações padrão para a CLI gcloud

Use a CLI gcloud para definir as configurações padrão do projeto padrão e da região do Google Cloud.

O projeto tem um ID como identificador exclusivo. Ao criar um projeto, é possível usar o ID do projeto gerado automaticamente ou criar um próprio.

Sua região do Google Cloud é um local onde os clusters serão gerenciados. Por exemplo, us-west1 Consulte as regiões de gerenciamento para mais detalhes.

Ao definir essas configurações padrão, não é necessário incluí-las ao executar a Google Cloud CLI. Também é possível especificar configurações ou modificar as configurações padrão transmitindo as sinalizações --project e --location para a Google Cloud CLI.

Quando você cria recursos de clusters do Anthos no Azure depois de configurar o projeto e o local padrão, os recursos são criados automaticamente nesse projeto e local.

Observação: a CLI gcloud retorna um erro se essas configurações não estiverem configuradas ou não forem especificadas.

Para definir os padrões, siga estas etapas:

1. Defina o projeto padrão.

   gcloud config set project PROJECT_ID
   

   Substitua PROJECT_ID pela ID do seu projeto.

2. Defina o local de gerenciamento padrão:

   gcloud config set container_aws/location GOOGLE_CLOUD_LOCATION
   

   Substitua GOOGLE_CLOUD_LOCATION pela sua localização, por exemplo, us-west1.

Observação: a propriedade container_aws/location era chamada aws/location. Se você já tiver definido a propriedade aws/location, o valor dela será copiado para container_aws/location na próxima vez que você executar um comando.

Selecionar intervalos CIDR para o cluster

O Kubernetes exige que dois intervalos de CIDR sejam fornecidos para o cluster. Esses intervalos de CIDR precisam ser escolhidos para que não se sobreponham aos intervalos de CIDR usados pelas sub-redes VPC. Eles precisam ser grandes o suficiente para o tamanho máximo esperado do cluster.

• Intervalo de CIDR do endereço do pod: quando um novo Pod é criado, ele recebe um endereço IP desse intervalo. Exemplo de intervalo: 192.168.208.0/20

• Intervalo de CIDR do endereço do serviço: quando um novo Service é criado, um endereço IP desse intervalo é alocado para ele. Exemplo de intervalo: 192.168.224.0/20

Crie um cluster

Use o comando a seguir para criar um cluster nos clusters do Anthos no Azure. Para mais informações sobre esse comando, incluindo os parâmetros opcionais, consulte a página de referência gcloud container aws create.

gcloud container aws clusters create aws-cluster-0 \
    --cluster-version 1.24.3-gke.2100 \
    --aws-region AWS_REGION \
    --fleet-project FLEET_PROJECT_ID \
    --vpc-id VPC_ID \
    --subnet-ids CONTROL_PLANE_SUBNET_1,CONTROL_PLANE_SUBNET_2,CONTROL_PLANE_SUBNET_3 \
    --pod-address-cidr-blocks POD_CIDR_BLOCK \
    --service-address-cidr-blocks SERVICE_CIDR_BLOCK \
    --role-arn API_ROLE_ARN \
    --iam-instance-profile CONTROL_PLANE_PROFILE \
    --database-encryption-kms-key-arn DB_KMS_KEY_ARN \
    --config-encryption-kms-key-arn CONFIG_KMS_KEY_ARN \
    --tags "google:gkemulticloud:cluster=aws-cluster-0"

Substitua:

• AWS_REGION: a região da AWS em que o cluster será criado.
• FLEET_PROJECT_ID: o projeto host da frota em que o cluster será registrado.
• VPC_ID: o ID da VPC da AWS para este cluster que você configurou na etapa de pré-requisito Criar sua VPC.
• CONTROL_PLANE_SUBNET_1, CONTROL_PLANE_SUBNET_2, CONTROL_PLANE_SUBNET_3: os IDs da sub-rede das três instâncias do plano de controle do cluster que você criou na etapa de pré-requisito Criar sub-redes particulares.
• POD_CIDR_BLOCK: o intervalo de endereços CIDR dos pods do cluster.
• SERVICE_CIDR_BLOCK o intervalo de endereços CIDR dos serviços do cluster.
• API_ROLE_ARN: o ARN do papel do IAM para o serviço de várias nuvens do Anthos que você criou na etapa de pré-requisito Criar papel da API de várias nuvens do Anthos.
• CONTROL_PLANE_PROFILE: o nome do perfil da instância do IAM associada ao cluster escolhido na etapa de pré-requisito Criar papel do plano de controle.
• DB_KMS_KEY_ARN: o nome do Recurso da Amazon (ARN, na sigla em inglês) de uma das chaves KMS da AWS que você criou na etapa de pré-requisito Criar uma chave KMS da AWS;
• CONFIG_KMS_KEY_ARN: o nome de recurso da Amazon (ARN) das outras chaves de KMS da AWS que você criou na etapa de pré-requisito Criar uma chave de AWS KMS;

Se presente, o parâmetro --tags aplica a tag da AWS fornecida a todos os recursos subjacentes da AWS gerenciados por clusters do Anthos na AWS. Este exemplo marca os nós do plano de controle com o nome do cluster ao qual eles pertencem.

Crie um pool de nós.

Use o seguinte comando para criar um pool de nós:

gcloud container aws node-pools create pool-0 \
    --cluster aws-cluster-0 \
    --node-version 1.24.3-gke.2100 \
    --min-nodes 1 \
    --max-nodes 5 \
    --max-pods-per-node 110 \
    --root-volume-size 50 \
    --subnet-id NODEPOOL_SUBNET_ID \
    --iam-instance-profile NODEPOOL_PROFILE \
    --config-encryption-kms-key-arn CONFIG_KMS_KEY_ARN \
    --ssh-ec2-key-pair EC2_KEY_PAIR \
    --tags "google:gkemulticloud:cluster=aws-cluster-0"

Substitua:

• NODEPOOL_SUBNET_ID: o ID de uma das sub-redes particulares que você criou na etapa de pré-requisito Criar sub-redes particulares.
• NODEPOOL_PROFILE: o nome do perfil da instância do IAM para as instâncias do EC2 no pool de nós escolhido na etapa de pré-requisito Criar um papel do IAM de pool de nós.
• CONFIG_KMS_KEY_ARN: o Nome de Recursos da Amazon (ARN, na sigla em inglês) da chave de AWS KMS para criptografar dados do usuário;
• EC2_KEY_PAIR (opcional): o nome do par de chaves do EC2 criado para o acesso SSH (opcional) criado na etapa de pré-requisito Criar par de chaves SSH.

Observação: se a sub-rede do pool de nós estiver fora do bloco CIDR principal da VPC, será necessário seguir outras etapas para configurar grupos de segurança.

Ver o status do cluster

Depois de criar um cluster e um pool de nós, é possível ver o status de um cluster com a Google Cloud CLI ou o console do Google Cloud. Para ver o status do cluster, escolha se você está usando a Google Cloud CLI ou o console do Google Cloud e siga estas etapas:

gcloud

Use o comando gcloud container aws clusters describe para ver detalhes sobre o cluster:

gcloud container aws clusters describe CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION

Substitua:

• CLUSTER_NAME: o nome do cluster.
• GOOGLE_CLOUD_LOCATION: o nome do local do Google Cloud que gerencia o cluster

Console do Google Cloud

1. No Console do Google Cloud, acesse a página Clusters do Anthos.

   Acesse Clusters do Anthos

2. Localize a seção Clusters gerenciados do Anthos. Os clusters são listados por nome e local.

3. Clique no nome do cluster. Um painel com informações sobre o cluster, incluindo o status e os recursos ativados do Anthos, será exibido.

Receba as credenciais de autenticação para o cluster

Depois de criar o cluster, você precisará das credenciais de autenticação para interagir com o cluster:

gcloud container aws clusters get-credentials aws-cluster-0

Esse comando configura kubectl para acessar o cluster que você criou pelo Gateway do Connect. Você precisa de pelo menos um pool de nós para usar o gateway do Connect porque ele depende do agente do Connect, que é executado como uma implantação no cluster.

Implantar um aplicativo no cluster

Agora que criou um cluster, é possível implantar um aplicativo conteinerizado nele. Para este guia de início rápido, implante nosso aplicativo da Web de exemplo, hello-app.

Você usa objetos do Kubernetes para criar e gerenciar os recursos do cluster. Use o objeto de implantação para implantar aplicativos sem estado, como servidores da Web. Os objetos de Serviço definem as regras e os balanceadores de carga para acessar o aplicativo pela Internet.

Criar a implantação

Para executar hello-app no cluster, você precisa implantar o aplicativo executando o seguinte comando:

kubectl create deployment hello-server --image=us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

Este comando do Kubernetes, kubectl create deployment, cria uma implantação chamada hello-server. O pod da implantação executa a imagem de contêiner hello-app.

Nesse comando, você:

• --image especifica uma imagem de contêiner a ser implantada. Nesse caso, o comando extrai a imagem de exemplo de um repositório do Artifact Registry, us-docker.pkg.dev/google-samples/containers/gke/hello-app. :1.0 indica a versão da imagem específica a ser extraída. Se você não especificar uma versão, a imagem marcada com latest será usada.

Expor a implantação

Após a implantação do aplicativo, você precisará expô-lo na Internet para que os usuários possam acessá-lo. Você pode expor seu aplicativo criando um serviço, um recurso do Kubernetes que expõe seu aplicativo ao tráfego externo.

Para expor seu aplicativo, execute o seguinte comando kubectl expose:

kubectl expose deployment hello-server --type LoadBalancer --port 80 --target-port 8080

Passar na sinalização --type LoadBalancer cria um balanceador de carga da AWS para seu contêiner. A sinalização --port inicializa a porta pública 80 na Internet e a sinalização --target-port encaminha o tráfego para a porta 8080 do aplicativo.

Os balanceadores de carga são cobrados de acordo com os preços do balanceador de carga da AWS.

Inspecionar e ver o aplicativo

1. Inspecione os pods em execução usando kubectl get pods:

   kubectl get pods
   

   Você verá um pod hello-server em execução no cluster.

2. Use kubectl get service para inspecionar o serviço hello-server:

   kubectl get service hello-server
   

   Na saída desse comando, copie o endereço IP externo do serviço da coluna EXTERNAL-IP.

   Observação: talvez você precise aguardar vários minutos até que o endereço IP externo do serviço fique disponível. Se o IP externo do aplicativo for <pending>, execute kubectl get service novamente.

3. Use o IP externo com a porta exposta a seguir para ver o aplicativo pelo navegador da Web:

   http://EXTERNAL-IP
   

Você acabou de implantar um aplicativo da Web conteinerizado nos clusters do Anthos no Azure.

Limpar

1. Exclua o Serviço e a implantação do aplicativo:

   kubectl delete service hello-server
   kubectl delete deployment hello-server
   

2. Execute gcloud container aws node-pools delete para excluir o pool de nós:

   gcloud container aws node-pools delete pool-0 --cluster aws-cluster-0
   

3. Execute gcloud container aws clusters delete para excluir o cluster:

   gcloud container aws clusters delete aws-cluster-0
   

A seguir

• Instale o Anthos Config Management