Tutorial: Implantar um aplicativo na Amazon EKS

Para iniciar um ambiente de desenvolvimento

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

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

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

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

5. Na parte superior, escolha Create Dev Environment e, em seguida, escolha AWS Cloud9 (no navegador).

6. Certifique-se de que Trabalhar na ramificação e principal existentes estejam selecionadas e, em seguida, escolha Criar.

   Seu 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 Dev Environment, digite:

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

2. Digite:

   chmod +x ./kubectl

3. Digite:

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

4. Digite:

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

5. Digite:

   kubectl version --short --client

6. Verifique se uma versão aparece.

   Agora você instaloukubectl.

Para instalar e configurar o eksctl

1. No terminal do Dev Environment, digite:

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

2. Digite:

   sudo cp /tmp/eksctl /usr/bin

3. Digite:

   eksctl version

4. Verifique se uma versão aparece.

   Agora você instaloueksctl.

Para verificar se o AWS CLI está instalado

1. No terminal do Dev Environment, digite:

   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 escolher Ativar se 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 de AWScontas. Para obter mais informações, consulte Criando 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, escolha 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 Primeiro nome, digite:

      codecatalyst-eks-user

   7. Em Sobrenome, digite:

      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 aos grupos, escolha Avançar.

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

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

   12. Escolha Copiar e cole as informações de login em um arquivo de texto. As informações de login consistem no portal de AWS acessoURL, 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, em seguida, escolha Criar conjunto de permissões.

   2. Escolha Conjunto de permissões predefinido e, em seguida, selecione AdministratorAccess. Essa política fornece permissões completas para todos 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 paracodecatalyst-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 codecatalyst-eks-user de acesso e o token de sessão da seguinte forma:

   1. Verifique se você tem o portal URL 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, vá para a página de codecatalyst-eks-user detalhes no IAM Identity Center, escolha Redefinir senha, Gerar uma senha de uso único [...] e redefina a senha novamente para exibir as informações na tela.

   2. Sair de AWS.

   3. Cole o portal de AWS acesso URL 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 escolha Definir nova senha.

      Uma caixa de Conta da AWS aparece na tela.

   6. Escolha e Conta da AWS, em seguida, escolha o nome do Conta da AWS ao qual você atribuiu o codecatalyst-eks-user usuário e o conjunto de permissões.

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

   8. Copie os comandos no meio da página. Eles são parecidos com os seguintes:

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

      ... onde session-token é 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ê ver 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 aws configure comando. 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 seu 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 waiting for CloudFormation stack mensagens ao AWS criar seu cluster. Isso é esperado.

3. Verifique se seu cluster foi criado com sucesso:

   kubectl cluster-info

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

   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 na Amazon ECR

1. Acesse seu ambiente de desenvolvimento.

2. Crie um repositório vazio na AmazonECR:

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

   Substituir codecatalyst-eks-image-repo com o nome que você deseja dar ao ECR repositório da Amazon.

   Este tutorial pressupõe que você nomeou seu repositóriocodecatalyst-eks-image-repo.

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

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

4. Observe o “repositoryUri”: valor, 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.

Para adicionar o arquivo index.html

1. Acesse seu ambiente de desenvolvimento.

2. Emcodecatalyst-eks-source-repository, crie uma pasta chamadapublic-html.

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

   <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, digite:

   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 public-html pasta.

Para adicionar o Dockerfile

1. Emcodecatalyst-eks-source-repository, crie um arquivo chamado Dockerfile com o seguinte conteúdo:

   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 seu repositório. O Docker build comando 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 seu repositório.

Para adicionar um arquivo deployment.yaml

1. Emcodecatalyst-eks-source-repository, crie uma pasta chamadaKubernetes.

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

   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 deployment.yaml arquivo é adicionado ao seu repositório em uma pasta chamadaKubernetes.

1. Para criar uma política de confiança para ambas as funções

1. Acesse seu ambiente de desenvolvimento.

2. No Cloud9-long-string diretório, 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 para a função de construção

• No Cloud9-long-string diretório, 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 a função for usada para executar ações de fluxo de trabalho, use o caractere curinga na declaração de política de recursos e, em seguida, defina o escopo da política com o nome do recurso depois que ele estiver disponível.

  "Resource": "*"

3. Para criar a política de implantação para a função de implantação

• No Cloud9-long-string diretório, 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 a função for usada para executar ações de fluxo de trabalho, use o caractere curinga na declaração de política de recursos e, em seguida, 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 Dev Environment, digite:

   cd /projects

2. Digite:

   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 "arn": valor, por exemplo,arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy. Você precisa disso ARN mais tarde.

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

1. Digite:

   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 "arn": valor da política de implantação, por exemplo,arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy. Você precisa disso ARN mais tarde.

6. Para criar a função de criação

1. Digite:

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

2. Pressione Enter.

3. Digite:

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

   Em que arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy é substituída pela política ARN de compilação que você anotou anteriormente.

4. Pressione Enter.

5. No prompt do terminal, digite:

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

6. Pressione Enter.

7. Observe o "Arn": valor da função, por exemplo,arn:aws:iam::111122223333:role/codecatalyst-eks-build-role. Você precisa disso ARN mais tarde.

7. Para criar a função de implantação

1. Digite:

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

2. Pressione Enter.

3. Digite:

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

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

4. Pressione Enter.

5. Digite:

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

6. Pressione Enter.

7. Observe o "Arn": valor da função, por exemplo,arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role. Você precisa disso ARN mais tarde.

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, escolha Configurações.

3. No painel de navegação, escolha AWS contas. 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.) Você precisará desse valor 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 IAM função ao CodeCatalyst espaço da Amazon é exibida. Talvez seja necessário fazer login para acessar a página.

7. Selecione Adicionar uma função existente na qual você criou IAM.

   Uma lista suspensa é exibida. A lista exibe as funções de criação e implantação e quaisquer outras IAM funções com uma política de confiança que inclua os diretores de codecatalyst.amazonaws.com serviços codecatalyst-runner.amazonaws.com e os principais.

8. Na lista suspensa, adicione:

   • codecatalyst-eks-build-role

   • codecatalyst-eks-deploy-role

   nota

   Se você verThe 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.

   As funções de criação e implantação agora devem aparecer em IAMfunções.

   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 Dev Environment, digite:

  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 da AmazonEKS.

  • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role é substituída pela função ARN de implantação que você criou emEtapa 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, substitua codecatalyst-eks-deploy-role com o 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 obter detalhes sobre esse comando, consulte Gerenciar IAM usuários e funções.

  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 Dev Environment, digite:

   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ída pela função ARN de implantação que você criou emEtapa 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, substitua codecatalyst-eks-deploy-role com o nome da CodeCatalystWorkflowDevelopmentRole-spaceName função. Para obter mais informações sobre essa função, consulte Etapa 5: criar AWS funções.

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

Para criar um fluxo de trabalho

1. Vá para o CodeCatalyst console.

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

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

4. Escolha Criar fluxo de trabalho.

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

6. Para Branch, escolhamain.

7. Escolha Criar.

8. Exclua o código de YAML amostra.

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

   nota

   Para obter mais informações sobre o arquivo de definição do fluxo de trabalho, consulteYAMLDefinição de fluxo de trabalho.

   nota

   No YAML código a seguir, você pode omitir as Connections: seções se quiser. Se você omitir essas seções, deverá garantir que a função especificada no campo Função padrão IAM em seu ambiente inclua as permissões e as políticas de confiança de ambas as funções descritas emEtapa 6: Adicionar AWS funções a CodeCatalyst. Para obter mais informações sobre como configurar um ambiente com uma IAM função padrão, consulteCriar 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 de 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-role com 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 do ECR repositório URI da Amazon em Etapa 3: criar um repositório de ECR imagens da Amazon que você criou.

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

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

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

   nota

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

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

11. Escolha Commit (Confirmar).

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

    1. Em Confirmar mensagem, remova o texto e digite:

       Add first workflow

    2. Para Repositório, escolhacodecatalyst-eks-source-repository.

    3. Em Nome da filial, escolha principal.

    4. Escolha Commit (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 workflow.yaml arquivo ao seu repositório de origem, o gatilho iniciou a execução do fluxo de trabalho.

Para ver o progresso 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 compilação.

4. Escolha DeployToEKSver o progresso da implantação.

   Para obter mais informações sobre a visualização dos detalhes da execução, consulteVisualizando o status e os detalhes da execução do fluxo de trabalho.

Para verificar a implantação

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

2. À esquerda, na parte inferior, escolha Load Balancers.

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 DNSdo nome na barra de endereço do seu navegador.

   O 'Hello, World! ' A página da web aparece em seu navegador, indicando que você implantou seu aplicativo com sucesso.

Para alterar o index.html

1. Acesse seu 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 Hello, World! texto paraTutorial complete!.

6. Adicione, confirme e envie:

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

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

7. (Opcional) Digite:

   git show HEAD

   Anote o ID de confirmação da index.html alteração. 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 progresso 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 ver a última execução.

   3. Escolha BuildBackende veja DeployToEKSo progresso da execução do fluxo de trabalho.

9. Verifique se seu aplicativo foi atualizado, da seguinte forma:

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

   2. À esquerda, na parte inferior, escolha Load Balancers.

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

   4. Copie e cole o valor DNSdo nome na barra de endereço do seu navegador.

      O 'Tutorial concluído! ' A página da web aparece no seu navegador, indicando que você implantou com sucesso uma nova revisão do seu aplicativo.

10. (Opcional) Em AWS, mude para o ECR console da Amazon 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 Dev Environment, digite:

      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.

      Após 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 AmazonEC2) 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 AWS credenciais, consulte. Como faço para corrigir os erros “Não é possível localizar credenciais” e ExpiredToken "”? Para atualizar suas kubectl credenciais, consulte. Como faço para corrigir os erros “Não é possível conectar-se ao servidor”?

2. No AWS console, limpe da seguinte forma:

   1. Na AmazonECR, excluacodecatalyst-eks-image-repo.

   2. No IAM Identity Center, exclua:

      1. codecatalyst-eks-user

      2. codecatalyst-eks-permission-set

   3. EmIAM, 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. Excluircodecatalyst-eks-workflow.

   2. Excluircodecatalyst-eks-environment.

   3. Excluircodecatalyst-eks-source-repository.

   4. Exclua seu ambiente de desenvolvimento.

   5. Excluircodecatalyst-eks-project.