Tutorial: Implantar uma aplicação no Amazon EKS

Como iniciar um novo ambiente de desenvolvimento

1. Abra o CodeCatalyst console em https://codecatalyst.aws/.

2. Navegue até o projeto, codecatalyst-eks-project.

3. No painel de navegação, selecione Código e, depois, selecione Repositórios de origem.

4. Escolha o nome para o seu repositório de origem, codecatalyst-eks-source-repository.

5. Na parte superior, escolha Criar ambiente de desenvolvimento e AWS Cloud9 (no navegador).

6. Verifique se Trabalhar na ramificação existente e principal estão selecionados e, depois, selecione Criar.

   O Ambiente de Desenvolvimento é iniciado em uma nova guia do navegador e seu repositório (codecatalyst-eks-source-repository) é clonado nela.

Para instalar e configurar o kubectl

1. No terminal do Ambiente de Desenvolvimento, insira:

   curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl

2. Insira:

   chmod +x ./kubectl

3. Insira:

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin

4. Insira:

   echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

5. Insira:

   kubectl version --short --client

6. Confira se uma versão é exibida.

   Você agora tem o kubectl instalado.

Para instalar e configurar o eksctl

1. No terminal do Ambiente de Desenvolvimento, insira:

   curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp

2. Insira:

   sudo cp /tmp/eksctl /usr/bin

3. Insira:

   eksctl version

4. Confira se uma versão é exibida.

   Você agora tem o eksctl instalado.

Para verificar se o AWS CLI está instalado

1. No terminal do Ambiente de Desenvolvimento, insira:

   aws --version

2. Verifique se uma versão aparece para verificar se o AWS CLI está instalado.

   Conclua os procedimentos restantes para configurar o AWS CLI com as permissões necessárias para acessar AWS.

1. Crie um usuário do IAM Identity Center, da seguinte forma:

   1. Faça login no AWS Management Console e abra o AWS IAM Identity Center console em https://console.aws.amazon.com/singlesignon/.

      (Talvez seja necessário selecionar Ativar se você nunca tiver feito login no IAM Identity Center antes.)

      nota

      Certifique-se de fazer login usando o Conta da AWS que está conectado ao seu CodeCatalyst espaço. Você pode verificar qual conta está conectada navegando até seu espaço e escolhendo a guia Contas da AWS. Para obter mais informações, consulte Criar um espaço.

   2. No painel de navegação, escolha Usuários e depois Adicionar usuário.

   3. Em Nome de usuário, digite:

      codecatalyst-eks-user

   4. Em Senha, selecione Gerar uma senha de uso único que você possa compartilhar com esse usuário.

   5. Em Endereço de e-mail e Confirmar endereço de e-mail, insira um endereço de e-mail que ainda não exista no IAM Identity Center.

   6. Em Nome, insira:

      codecatalyst-eks-user

   7. Em Sobrenome, insira:

      codecatalyst-eks-user

   8. Em Nome de exibição, mantenha:

      codecatalyst-eks-user codecatalyst-eks-user

   9. Escolha Próximo.

   10. Na página Adicionar usuário a grupos, selecione Avançar.

   11. Na página Revisar e adicionar usuário, revise as informações e selecione Adicionar usuário.

       Uma caixa de diálogo Senha de uso único é exibida.

   12. Selecione Copiar e cole as informações de login em um arquivo de texto. As informações de login consistem na URL do portal de AWS acesso, um nome de usuário e uma senha de uso único.

   13. Escolha Fechar.

2. Crie um conjunto de permissões, da seguinte forma:

   1. No painel de navegação, escolha Conjuntos de permissões e, depois, escolha Criar conjunto de permissões.

   2. Escolha Conjunto de permissões predefinido e, em seguida, selecione AdministratorAccess. Esta política fornece permissões totais para todos os Serviços da AWS.

   3. Escolha Próximo.

   4. Em Nome do conjunto de permissões, remova AdministratorAccess e digite:

      codecatalyst-eks-permission-set

   5. Escolha Próximo.

   6. Na página Revisar e criar, revise as informações e selecione Criar.

3. Atribua o conjunto de permissões para codecatalyst-eks-user, da seguinte forma:

   1. No painel de navegação Contas da AWS, escolha e marque a caixa de seleção ao lado da caixa de seleção na Conta da AWS qual você está conectado no momento.

   2. Escolha Atribuir usuários ou grupos.

   3. Escolha a guia Users.

   4. Marque a caixa de seleção ao lado dos logs do codecatalyst-eks-user.

   5. Escolha Próximo.

   6. Marque a caixa de seleção ao lado dos logs do codecatalyst-eks-permission-set.

   7. Escolha Próximo.

   8. Revise suas informações e selecione Enviar.

      Agora você designou codecatalyst-eks-user e codecatalyst-eks-permission-set para o seu Conta da AWS, unindo-os.

4. Obtenha as chaves de acesso de codecatalyst-eks-user e o token de sessão, da seguinte forma:

   1. Verifique se você tem a URL do portal de AWS acesso, o nome de usuário e a senha de uso único paracodecatalyst-eks-user. Você deveria ter copiado essas informações para um editor de texto anteriormente.

      nota

      Se você não tiver essas informações, acesse a página de detalhes do codecatalyst-eks-user no IAM Identity Center, selecione Redefinir senha, Gerar uma senha de uso único [...] e Redefinir senha novamente para exibir as informações na tela.

   2. Sair de AWS.

   3. Cole o URL do portal de AWS acesso na barra de endereço do seu navegador.

   4. Faça login com:

      • Nome de usuário:

        codecatalyst-eks-user

      • Senha:

        one-time-password

   5. Em Definir nova senha, insira uma nova senha e selecione Definir nova senha.

      Uma caixa de Conta da AWS aparece na tela.

   6. Selecione Conta da AWS e, depois, escolha o nome da Conta da AWS a que você atribuiu o usuário codecatalyst-eks-user e o conjunto de permissões.

   7. Ao lado de codecatalyst-eks-permission-set, selecione Linha de comando ou acesso programático.

   8. Copie os comandos no meio da página. Eles são semelhantes a:

      export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
      export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
      export AWS_SESSION_TOKEN="session-token"

      ... onde session-token está uma longa sequência aleatória.

5. Adicione as chaves de acesso e o token de sessão ao AWS CLI, da seguinte forma:

   1. Retorne ao seu ambiente de CodeCatalyst desenvolvimento.

   2. No prompt do terminal, cole os comandos que você copiou. Pressione Enter.

      Agora você configurou o AWS CLI com chaves de acesso e um token de sessão. Agora você pode usar AWS CLI para concluir as tarefas exigidas por este tutorial.

      Importante

      Se, em algum momento durante este tutorial, você vir mensagens semelhantes a:

      Unable to locate credentials. You can configure credentials by running "aws configure".

      Ou:

      ExpiredToken: The security token included in the request is expired

      ... é porque sua AWS CLI sessão expirou. Nesse caso, não execute o comando aws configure. Em vez disso, use as instruções na etapa 4 desse procedimento, que começa com Obtain codecatalyst-eks-user's access key and session token, para atualizar sua sessão.

Para criar um cluster

1. Acesse o Ambiente de Desenvolvimento.

2. Crie um cluster e nós:

   eksctl create cluster --name codecatalyst-eks-cluster --region us-west-2

   Em que:

   • codecatalyst-eks-clusteré substituído pelo nome que você deseja dar ao seu cluster.

   • us-west-2é substituído pela sua região.

   Depois de 10 a 20 minutos, uma mensagem semelhante à seguinte é exibida:

   EKS cluster "codecatalyst-eks-cluster" in "us-west-2" region is ready

   nota

   Você verá várias mensagens waiting for CloudFormation stack enquanto a AWS cria seu cluster. Isso é esperado.

3. Verifique se o cluster foi criado:

   kubectl cluster-info

   Você verá uma mensagem semelhante à seguinte, indicando uma criação de cluster bem-sucedida:

   Kubernetes master is running at https://long-string.gr7.us-west-2.eks.amazonaws.com
   CoreDNS is running at https://long-string.gr7.us-west-2.eks.amazonaws.com/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

Para criar um repositório de imagens no Amazon ECR

1. Acesse o Ambiente de Desenvolvimento.

2. Crie um repositório vazio no Amazon ECR:

   aws ecr create-repository --repository-name codecatalyst-eks-image-repo

   codecatalyst-eks-image-repoSubstitua pelo nome que você deseja dar ao repositório Amazon ECR.

   Este tutorial pressupõe que você tem um repositório chamado codecatalyst-eks-image-repo.

3. Exiba os detalhes do repositório do Amazon ECR:

   aws ecr describe-repositories \
         --repository-names codecatalyst-eks-image-repo
   

4. Observe o valor “repositoryUri”:, por exemplo, 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo.

   Você precisará dele mais tarde ao adicionar o repositório ao seu fluxo de trabalho.

Como adicionar o arquivo index.html

1. Acesse o Ambiente de Desenvolvimento.

2. Em codecatalyst-eks-source-repository, crie uma pasta chamada public-html.

3. Em /public-html, crie um arquivo chamado index.html com o conteúdo a seguir:

   <html>
     <head>
       <title>Hello World</title>
       <style>
         body {
         background-color: black;
         text-align: center;
         color: white;
         font-family: Arial, Helvetica, sans-serif;
         }  
       </style>
     </head>
     <body>
       <h1>Hello, World!</h1>
     </body>
   </html>

4. No prompt do terminal, insira:

   cd /projects/codecatalyst-eks-source-repository

5. Adicione, confirme e envie:

   git add .
   git commit -m "add public-html/index.html"
   git push

   O index.html é adicionado ao seu repositório em uma pasta public-html.

Para adicionar o Dockerfile

1. Em codecatalyst-eks-source-repository, crie um arquivo chamado Dockerfile com o conteúdo a seguir:

   FROM httpd:2.4
   COPY ./public-html/index.html /usr/local/apache2/htdocs/index.html
   EXPOSE 80

   Não inclua uma extensão de arquivo.

   Importante

   O Dockerfile deve residir na pasta raiz do repositório. O comando Docker build do fluxo de trabalho espera que ele esteja lá.

2. Adicione, confirme e envie:

   git add .
   git commit -m "add Dockerfile"
   git push

   O Dockerfile é adicionado ao repositório.

Para adicionar um arquivo deployment.yaml

1. Em codecatalyst-eks-source-repository, crie uma pasta chamada Kubernetes.

2. Em /Kubernetes, crie um arquivo chamado deployment.yaml com o conteúdo a seguir:

   apiVersion: v1
   kind: Service
   metadata:
     name: my-service
     labels:
       app: my-app
   spec:
     type: LoadBalancer
     selector:
       app: my-app
     ports:
       - protocol: TCP
         port: 80
         targetPort: 80
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: codecatalyst-eks-container
           # The $REPOSITORY_URI and $IMAGE_TAG placeholders will be replaced by actual values supplied by the build action in your workflow
           image: $REPOSITORY_URI:$IMAGE_TAG
           ports:
           - containerPort: 80

3. Adicione, confirme e envie:

   git add .
   git commit -m "add Kubernetes/deployment.yaml"
   git push

   O arquivo deployment.yaml é adicionado ao seu repositório em uma pasta chamada Kubernetes.

1. Para criar uma política de confiança para os dois perfis

1. Acesse o Ambiente de Desenvolvimento.

2. No diretório Cloud9-long-string, crie um arquivo chamado codecatalyst-eks-trust-policy.json com o seguinte conteúdo:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                   "Service":  [
                      "codecatalyst-runner.amazonaws.com",
                      "codecatalyst.amazonaws.com"
                    ]
               },
               "Action": "sts:AssumeRole"
           }
       ]
   }

2. Para criar a política de criação do perfil de criação

• No diretório Cloud9-long-string, crie um arquivo chamado codecatalyst-eks-build-policy.json com o seguinte conteúdo:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "ecr:*",
                  "ec2:*"
              ],
              "Resource": "*"
          }
      ]
  }

  nota

  Na primeira vez em que o perfil for usado para executar ações de fluxo de trabalho, use o caractere curinga na declaração de política de recursos e defina o escopo da política com o nome do recurso depois que ele estiver disponível.

  "Resource": "*"

3. Para criar a política do perfil de implantação

• No diretório Cloud9-long-string, crie um arquivo chamado codecatalyst-eks-deploy-policy.json com o seguinte conteúdo:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "eks:DescribeCluster",
                  "eks:ListClusters"
              ],
              "Resource": "*"
          }
      ]
  }

  nota

  Na primeira vez em que o perfil for usado para executar ações de fluxo de trabalho, use o caractere curinga na declaração de política de recursos e defina o escopo da política com o nome do recurso depois que ele estiver disponível.

  "Resource": "*"

4. Para adicionar a política de compilação ao AWS

1. No terminal do Ambiente de Desenvolvimento, insira:

   cd /projects

2. Insira:

   aws iam create-policy \
       --policy-name codecatalyst-eks-build-policy \
       --policy-document file://codecatalyst-eks-build-policy.json

3. Pressione Enter.

4. Na saída do comando, observe o valor "arn":, por exemplo, arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy. Esse ARN será necessário posteriormente.

5. Para adicionar a política de implantação ao AWS

1. Insira:

   aws iam create-policy \
       --policy-name codecatalyst-eks-deploy-policy \
       --policy-document file://codecatalyst-eks-deploy-policy.json

2. Pressione Enter.

3. Na saída do comando, observe o valor "arn": da política de implantação, por exemplo, arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy. Esse ARN será necessário posteriormente.

6. Para criar o perfil de criação

1. Insira:

   aws iam create-role \
         --role-name codecatalyst-eks-build-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Pressione Enter.

3. Insira:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-build-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy

   Onde arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy é substituído pelo ARN da política de construção que você observou anteriormente.

4. Pressione Enter.

5. No prompt do terminal, insira:

   aws iam get-role \
         --role-name codecatalyst-eks-build-role

6. Pressione Enter.

7. Observe o valor "Arn": do perfil, por exemplo, arn:aws:iam::111122223333:role/codecatalyst-eks-build-role. Esse ARN será necessário posteriormente.

7. Para criar o perfil de implantação

1. Insira:

   aws iam create-role \
         --role-name codecatalyst-eks-deploy-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Pressione Enter.

3. Insira:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-deploy-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy

   Onde arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy é substituído pelo ARN da política de implantação que você anotou anteriormente.

4. Pressione Enter.

5. Insira:

   aws iam get-role \
         --role-name codecatalyst-eks-deploy-role

6. Pressione Enter.

7. Observe o valor "Arn": do perfil, por exemplo, arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role. Esse ARN será necessário posteriormente.

Para adicionar funções de criação e implantação ao seu Conta da AWS

1. No CodeCatalyst console, navegue até seu espaço.

2. Na parte superior, selecione Configurações.

3. No painel de navegação, selecione Contas da AWS . Uma lista de contas é exibida.

4. Na coluna Nome de CodeCatalyst exibição da Amazon, copie o nome de exibição de Conta da AWS onde você criou suas funções de criação e implantação. (Pode ser um número.) Esse valor será necessário posteriormente, ao criar seu fluxo de trabalho.

5. Escolha o nome de exibição.

6. Escolha Gerenciar funções no console de AWS gerenciamento.

   A página Adicionar função do IAM ao CodeCatalyst espaço da Amazon é exibida. Talvez seja necessário fazer login para acessá-la.

7. Selecione Adicionar um perfil existente que você criou no IAM.

   Uma lista suspensa aparece. A lista exibe os perfis de criação e implantação e outros perfis do IAM com uma política de confiança que inclui as entidades principais de serviço codecatalyst-runner.amazonaws.com e codecatalyst.amazonaws.com.

8. Na lista suspensa, adicione:

   • codecatalyst-eks-build-role

   • codecatalyst-eks-deploy-role

   nota

   Se você vir The security token included in the request is invalid, pode ser porque você não tem as permissões corretas. Para corrigir esse problema, saia e faça login novamente com a AWS conta que você usou ao criar seu CodeCatalyst espaço. AWS

9. Volte ao CodeCatalyst console e atualize a página.

   Os perfis de criação e implantação agora devem aparecer em Perfis do IAM.

   Essas funções agora estão disponíveis para uso em CodeCatalyst fluxos de trabalho.

Para configurar o arquivo Kubernetes ConfigMap usando eksctl

• No terminal do Ambiente de Desenvolvimento, insira:

  eksctl create iamidentitymapping --cluster codecatalyst-eks-cluster --arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role --group system:masters --username codecatalyst-eks-deploy-role --region us-west-2

  Em que:

  • codecatalyst-eks-clusteré substituído pelo nome do cluster Amazon EKS.

  • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-roleé substituído pelo ARN da função de implantação que você criou em. Etapa 5: criar AWS funções

  • codecatalyst-eks-deploy-role(ao lado de--username) é substituído pelo nome da função de implantação que você criou emEtapa 5: criar AWS funções.

    nota

    Se você decidiu não criar uma função de implantação, codecatalyst-eks-deploy-role substitua pelo nome da CodeCatalystWorkflowDevelopmentRole-spaceName função. Para obter mais informações sobre essa função, consulte Etapa 5: criar AWS funções.

  • us-west-2é substituído pela sua região.

  Para saber detalhes sobre esse comando, consulte Gerenciar usuários e perfis do IAM.

  Uma mensagem semelhante à seguinte é exibida:

  2023-06-09 00:58:29 [ℹ]  checking arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role against entries in the auth ConfigMap
  2023-06-09 00:58:29 [ℹ]  adding identity "arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role" to auth ConfigMap

Para configurar o arquivo Kubernetes ConfigMap usando kubectl

1. No terminal do Ambiente de Desenvolvimento, insira:

   kubectl edit configmap -n kube-system aws-auth

   O ConfigMap arquivo aparece na tela.

2. Adicione o texto em itálico vermelho:

   # Please edit the object below. Lines beginning with a '#' will be ignored,
   # and an empty file will abort the edit. If an error occurs while saving this file will be
   # reopened with the relevant failures.
   #
   apiVersion: v1
   data:
     mapRoles: |
       - groups:
         - system:bootstrappers
         - system:nodes
         rolearn: arn:aws:iam::111122223333:role/eksctl-codecatalyst-eks-cluster-n-NodeInstanceRole-16BC456ME6YR5
         username: system:node:{{EC2PrivateDNSName}}
       - groups:
         - system:masters
         rolearn: arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role
         username: codecatalyst-eks-deploy-role
     mapUsers: |
       []
   kind: ConfigMap
   metadata:
     creationTimestamp: "2023-06-08T19:04:39Z"
     managedFields:
     ...

   Em que:

   • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-roleé substituído pelo ARN da função de implantação que você criou em. Etapa 5: criar AWS funções

   • codecatalyst-eks-deploy-role(ao lado deusername:) é substituído pelo nome da função de implantação que você criou emEtapa 5: criar AWS funções.

     nota

     Se você decidiu não criar uma função de implantação, codecatalyst-eks-deploy-role substitua pelo nome da CodeCatalystWorkflowDevelopmentRole-spaceName função. Para obter mais informações sobre essa função, consulte Etapa 5: criar AWS funções.

   Para saber detalhes, consulte Habilitar o acesso da entidade principal do IAM ao seu cluster no Guia do usuário do Amazon EKS.

Para criar um fluxo de trabalho

1. Vá para o CodeCatalyst console.

2. Navegue até o projeto (codecatalyst-eks-project).

3. No painel de navegação, escolha CI/CD e Fluxos de trabalho.

4. Selecione Criar fluxo de trabalho.

5. Em Repositório de origem, selecione codecatalyst-eks-source-repository.

6. Em Ramificação, selecione main.

7. Escolha Criar.

8. Exclua o código de amostra YAML.

9. Adicione o código YAML a seguir para criar um arquivo de definição de fluxo de trabalho:

   nota

   Para ter mais informações sobre o arquivo de definição de fluxo de trabalho, consulte Definição do YAML do fluxo de trabalho.

   nota

   No código YAML a seguir, você pode omitir as seções Connections: se quiser. Se você omitir essas seções, deverá garantir que o perfil especificado no campo Perfil do IAM padrão em seu ambiente inclua as permissões e as políticas de confiança dos dois perfis descritas em Etapa 6: Adicionar AWS funções a CodeCatalyst. Para ter mais informações sobre como configurar um ambiente com um perfil do IAM padrão, consulte Criar um ambiente.

   Name: codecatalyst-eks-workflow
   SchemaVersion: 1.0
   
   Triggers:
     - Type: PUSH
       Branches:
         - main
   Actions:
     BuildBackend:
       Identifier: aws/build@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-build-role
       Inputs:
         Sources:
           - WorkflowSource
         Variables:
           - Name: REPOSITORY_URI
             Value: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo
           - Name: IMAGE_TAG
             Value: ${WorkflowSource.CommitId}
       Configuration:
         Steps:
           #pre_build:
           - Run: echo Logging in to Amazon ECR...
           - Run: aws --version
           - Run: aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-west-2.amazonaws.com
           #build:
           - Run: echo Build started on `date`
           - Run: echo Building the Docker image...
           - Run: docker build -t $REPOSITORY_URI:latest .
           - Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
           #post_build:
           - Run: echo Build completed on `date`
           - Run: echo Pushing the Docker images...
           - Run: docker push $REPOSITORY_URI:latest
           - Run: docker push $REPOSITORY_URI:$IMAGE_TAG
           # Replace the variables in deployment.yaml
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$REPOSITORY_URI|$REPOSITORY_URI|g"
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$IMAGE_TAG|$IMAGE_TAG|g"
           - Run: cat Kubernetes/*
           # The output artifact will be a zip file that contains Kubernetes manifest files.
       Outputs:
         Artifacts:
           - Name: Manifests
             Files: 
               - "Kubernetes/*"
     DeployToEKS:
       DependsOn: 
         - BuildBackend
       Identifier: aws/kubernetes-deploy@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-deploy-role
       Inputs:
         Artifacts:
           - Manifests
       Configuration:
         Namespace: default
         Region: us-west-2
         Cluster: codecatalyst-eks-cluster
         Manifests: Kubernetes/

   No código anterior, substitua:

   • Ambas as instâncias de codecatalyst-eks-environment com o nome do ambiente em que você criouPré-requisitos.

   • Ambas as instâncias codecatalyst-account-connection com o nome de exibição da conexão da sua conta. O nome de exibição pode ser um número. Para obter mais informações, consulte Etapa 6: Adicionar AWS funções a CodeCatalyst.

   • codecatalyst-eks-build-rolecom o nome da função de construção em que você criouEtapa 5: criar AWS funções.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo(na Value: propriedade) com o URI do repositório Amazon ECR em que você criou. Etapa 3: criar uma imagem de repositório do Amazon ECR

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com(no Run: aws ecr comando) com o URI do repositório Amazon ECR sem o sufixo da imagem (). /codecatalyst-eks-image-repo

   • codecatalyst-eks-deploy-rolecom o nome da função de implantação na qual você criouEtapa 5: criar AWS funções.

   • Ambas as instâncias us-west-2 com seu código de AWS região. Para ver uma lista de códigos de região, consulte Endpoints regionais na Referência geral da AWS.

   nota

   Se você decidiu não criar e implantar funções, codecatalyst-eks-deploy-role substitua codecatalyst-eks-build-role e pelo nome da CodeCatalystWorkflowDevelopmentRole-spaceName função. Para obter mais informações sobre essa função, consulte Etapa 5: criar AWS funções.

10. (Opcional) Selecione Validar para garantir que o código YAML seja válido antes de confirmar.

11. Selecione Confirmar.

12. Na caixa de diálogo Confirmar fluxo de trabalho, insira o seguinte:

    1. Em Mensagem de confirmação, remova o texto e digite:

       Add first workflow

    2. Em Repositório, selecione codecatalyst-eks-source-repository.

    3. Em Nome da ramificação, selecione a principal.

    4. Selecione Confirmar.

    Agora você criou um fluxo de trabalho. A execução de um fluxo de trabalho é iniciada automaticamente devido ao gatilho definido na parte superior do fluxo de trabalho. Especificamente, quando você confirmou (e enviou) o arquivo workflow.yaml ao repositório de origem, o gatilho iniciou a execução do fluxo de trabalho.

Para visualizar o andamento da execução do fluxo de trabalho

1. No painel de navegação do CodeCatalyst console, escolha CI/CD e, em seguida, escolha Fluxos de trabalho.

2. Escolha o fluxo de trabalho que você acabou de criar, codecatalyst-eks-workflow.

3. Escolha BuildBackendver o progresso da construção.

4. Escolha DeployToEKS para ver o progresso da implantação.

   Para ter mais informações sobre como visualizar os detalhes da execução, consulte o Visualização do status e detalhes de execução do fluxo de trabalho.

Como verificar a implantação

1. Abra o EC2 console da Amazon em https://console.aws.amazon.com/ec2/.

2. À esquerda, na parte inferior, escolha Balanceadores de carga.

3. Selecione o balanceador de carga que foi criado como parte da sua implantação do Kubernetes. Se você não tiver certeza de qual balanceador de carga escolher, procure as seguintes tags na guia Tags:

   • kubernetes.io/service-name

   • kubernetes.io/cluster/ekstutorialcluster

4. Com o balanceador de carga correto selecionado, escolha a guia Descrição.

5. Copie e cole o valor do Nome do DNS na barra de endereço do navegador.

   A página da Web “Hello, World!” aparece no navegador, indicando que você implantou a aplicação com êxito.

Para alterar o index.html

1. Acesse o Ambiente de Desenvolvimento.

2. No prompt do terminal, mude para seu repositório de origem:

   cd /projects/codecatalyst-eks-source-repository

3. Obtenha as alterações mais recentes do fluxo de trabalho:

   git pull

4. Abra o codecatalyst-eks-source-repository/public-html/index.html.

5. Na linha 14, altere o texto Hello, World! para Tutorial complete!.

6. Adicione, confirme e envie:

   git add .
   git commit -m "update index.html title"
   git push

   A execução de um fluxo de trabalho é iniciada automaticamente.

7. (Opcional) Insira:

   git show HEAD

   Anote o ID de confirmação da alteração index.html. Esse ID de confirmação será marcado na imagem do Docker que será implantada pela execução do fluxo de trabalho que você acabou de iniciar.

8. Assista ao andamento da implantação:

   1. No CodeCatalyst console, no painel de navegação, escolha CI/CD e, em seguida, escolha Fluxos de trabalho.

   2. Escolha codecatalyst-eks-workflow para ver a última execução.

   3. Escolha BuildBackende DeployToEKS para ver o progresso da execução do fluxo de trabalho.

9. Verifique se a aplicação foi atualizada, da seguinte forma:

   1. Abra o EC2 console da Amazon em https://console.aws.amazon.com/ec2/.

   2. À esquerda, na parte inferior, escolha Balanceadores de carga.

   3. Selecione o balanceador de carga que foi criado como parte da sua implantação do Kubernetes.

   4. Copie e cole o valor do Nome do DNS na barra de endereço do navegador.

      A página da Web “Tutorial concluído!” aparece no navegador, indicando que você implantou uma nova revisão da aplicação com êxito.

10. (Opcional) Em AWS, alterne para o console do Amazon ECR e verifique se a nova imagem do Docker foi marcada com o ID de confirmação da etapa 7 deste procedimento.

Para limpar

1. Exclua seu cluster:

   1. No terminal do Ambiente de Desenvolvimento, insira:

      eksctl delete cluster --region=us-west-2 --name=codecatalyst-eks-cluster

      Em que:

      • us-west-2é substituído pela sua região.

      • codecatalyst-eks-clusteré substituído pelo nome do cluster que você criou.

      Depois de 5 a 10 minutos, o cluster e os recursos associados são excluídos, incluindo, mas não se limitando a, AWS CloudFormation pilhas, grupos de nós (na Amazon EC2) e balanceadores de carga.

   Importante

   Se o eksctl delete cluster comando não funcionar, talvez seja necessário atualizar suas AWS credenciais ou suas kubectl credenciais. Se você não tiver certeza de quais credenciais atualizar, atualize as AWS credenciais primeiro. Para atualizar suas credenciais da AWS , consulte Como faço para corrigir os erros “Não é possível localizar credenciais” e ExpiredToken "”?. Para atualizar suas credenciais do kubectl, consulte Como faço para corrigir os erros “Não foi possível conectar-se ao servidor”?.

2. No AWS console, limpe da seguinte forma:

   1. No Amazon ECR, exclua codecatalyst-eks-image-repo.

   2. No IAM Identity Center, exclua:

      1. codecatalyst-eks-user

      2. codecatalyst-eks-permission-set

   3. No IAM, exclua:

      • codecatalyst-eks-build-role

      • codecatalyst-eks-deploy-role

      • codecatalyst-eks-build-policy

      • codecatalyst-eks-deploy-policy

3. No CodeCatalyst console, limpe da seguinte forma:

   1. Exclua codecatalyst-eks-workflow.

   2. Exclua codecatalyst-eks-environment.

   3. Exclua codecatalyst-eks-source-repository.

   4. Exclua o Ambiente de Desenvolvimento.

   5. Exclua codecatalyst-eks-project.