Tutorial: Implantar no Amazon EKS com o CodePipeline

Criar um cluster público

1. Abra o console do EKS e escolha Criar cluster.

2. Em Nome, nomeie o cluster. Escolha Próximo.

3. Escolha Create (Criar).

Criar uma VPC no console

1. Abra o console da VPC e escolha Criar VPC.

2. Em Configurações da VPC, escolha VPC e mais.

3. Opte por criar uma sub-rede pública e 4 privadas. Escolha Criar VPC.

4. Na página de sub-redes, escolha Privada.

Determinar as sub-redes privadas na VPC

1. Navegue até a VPC e escolha a ID da VPC para abrir a página de detalhes da VPC.

2. Na página Detalhes da VPC, escolha a guia Mapa de recursos.

3. Consulte o diagrama e anote as sub-redes privadas. As sub-redes são exibidas com rótulos para indicar o status público ou privado, e cada sub-rede é mapeada para uma tabela de rotas.

   

   Um cluster privado terá todas as sub-redes privadas.

4. Crie uma sub-rede pública para hospedar o gateway NAT. Só é possível anexar um gateway da Internet a uma VPC de cada vez.

Criar um gateway NAT em uma sub-rede pública

1. Na sub-rede pública, crie um gateway NAT. Navegue até o console da VPC e escolha Gateways da Internet. Escolha Criar gateway da Internet.

2. Em Nome, digite um nome para o gateway da internet. Escolha Criar gateway da Internet.

Adicionar o gateway NAT às tabelas de rotas das sub-redes privadas

1. Navegue até o console da VPC e escolha Sub-redes.

2. Para cada sub-rede privada, escolha-a e, em seguida, escolha a tabela de rotas dessa sub-rede na página de detalhes. Escolha Editar tabela de rotas.

3. Atualize a tabela de rotas da sub-rede privada a fim de direcionar o tráfego de internet para o gateway NAT. Selecione Adicionar rota. Escolha o Gateway NAT dentre as opções a serem adicionadas. Escolha o gateway da internet criado por você.

4. Para a sub-rede pública, crie a tabela de rotas personalizada. Verifique se a lista de controle de acesso (ACL) da rede da sub-rede pública permite o tráfego de entrada vindo da sub-rede privada.

5. Escolha Salvar alterações.

Criar um cluster privado

1. Abra o console do EKS e escolha Criar cluster.

2. Em Nome, nomeie o cluster. Escolha Próximo.

3. Especifique a VPC e as outras informações de configuração. Escolha Criar.

Configure seu cluster

1. Só anexe sub-redes privadas no cluster do EKS na guia Redes. Anexe as sub-redes privadas capturadas na seção Determinar as sub-redes privadas na VPC em Etapa 1: (Opcional) Criar um cluster no Amazon EKS.

2. Verifique se as sub-redes privadas têm acesso à Internet, pois o CodePipeline armazena e recupera artefatos do bucket de artefatos do S3 para o pipeline.

Para atualizar a política do perfil de serviço do CodePipeline

1. Abra o console do IAM em https://console.aws.amazon.com/iam/.

2. No painel do console, escolha Roles (Funções).

3. Consulte o perfil de serviço do CodePipeline, como cp-service-role.

4. Adicione uma nova política em linha.

5. No Editor de políticas, insira a opção a seguir.

   • Para um cluster público, adicione as permissões a seguir.

     JSON

     {
         "Version":"2012-10-17",		 	 	 
     
         "Statement": [
             {
                 "Sid": "EksClusterPolicy",
                 "Effect": "Allow",
                 "Action": "eks:DescribeCluster",
                 "Resource": "arn:aws:eks:us-east-1:111122223333:cluster/my-cluster"
             },
             {
                 "Sid": "EksVpcClusterPolicy",
                 "Effect": "Allow",
                 "Action": [
                     "ec2:DescribeDhcpOptions",
                     "ec2:DescribeNetworkInterfaces",
                     "ec2:DescribeRouteTables",
                     "ec2:DescribeSubnets",
                     "ec2:DescribeSecurityGroups",
                     "ec2:DescribeVpcs"
                 ],
                 "Resource": [
                     "*"
                 ]
             }
         ]
     }
     

   • Para um cluster privado, adicione as permissões a seguir. Os clusters privados exigirão permissões adicionais para a VPC, se aplicável.

     JSON

     {
         "Version":"2012-10-17",		 	 	 
     
         "Statement": [
             {
                 "Sid": "EksClusterPolicy",
                 "Effect": "Allow",
                 "Action": "eks:DescribeCluster",
                 "Resource": "arn:aws:eks:us-east-1:111122223333:cluster/my-cluster"
             },
             {
                 "Sid": "EksVpcClusterPolicy",
                 "Effect": "Allow",
                 "Action": [
                     "ec2:DescribeDhcpOptions",
                     "ec2:DescribeNetworkInterfaces",
                     "ec2:DescribeRouteTables",
                     "ec2:DescribeSubnets",
                     "ec2:DescribeSecurityGroups",
                     "ec2:DescribeVpcs"
                 ],
                 "Resource": [
                     "*"
                 ]
             },
             {
                 "Effect": "Allow",
                 "Action": "ec2:CreateNetworkInterface",
                 "Resource": "*",
                 "Condition": {
                     "StringEqualsIfExists": {
                         "ec2:Subnet": [
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-03ebd65daeEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0e377f6036EXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE"
                         ]
                     }
                 }
             },
             {
                 "Effect": "Allow",
                 "Action": "ec2:CreateNetworkInterfacePermission",
                 "Resource": "*",
                 "Condition": {
                     "ArnEquals": {
                         "ec2:Subnet": [
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-03ebd65daeEXAMPLE",
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-0e377f6036EXAMPLE",
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-0db658ba1cEXAMPLE",
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-0db658ba1cEXAMPLE"
                         ]
                     }
                 }
             },
             {
                 "Effect": "Allow",
                 "Action": "ec2:DeleteNetworkInterface",
                 "Resource": "*",
                 "Condition": {
                     "StringEqualsIfExists": {
                         "ec2:Subnet": [
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-03ebd65daeEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0e377f6036EXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE"
                         ]
                     }
                 }
             }
         ]
     }
     

6. Escolha Atualizar política.

1. Abra o console do EKS e navegue até o cluster.

2. Escolha a guia Acesso.

3. Em Entradas de acesso do IAM, escolha Criar entrada de acesso.

4. No ARN da entidade principal do IAM, insira a função recém-atualizada por você para a ação, como cp-service-role. Escolha Próximo.

5. Na página Etapa 2: Adicionar política de acesso, em Nome da política, escolha a política gerenciada para acesso, como AmazonEKSClusterAdminPolicy. Escolha Add policy. Escolha Próximo.

   nota

   Esta é a política usada pela ação do CodePipeline para conversar com o Kubernetes. Como prática recomendada, para diminuir o escopo das permissões na política com o privilégio mínimo em vez da política administrativa, anexe uma política personalizada.

6. Na página de revisão, escolha Criar.

1. Crie ou use um repositório do GitHub existente.

2. Crie uma nova estrutura no repositório para os arquivos de chart do Helm, conforme mostrado no exemplo abaixo.

   mychart
   |-- Chart.yaml
   |-- charts
   |-- templates
   |   |-- NOTES.txt
   |   |-- _helpers.tpl
   |   |-- deployment.yaml
   |   |-- ingress.yaml
   |   `-- service.yaml
   `-- values.yaml
   

3. Adicione o arquivo ao nível raiz do repositório.

Para criar o pipeline

1. Abra o console do CodePipeline em https://console.aws.amazon.com/codesuite/codepipeline/.

2. Na página Welcome (Bem-vindo), Getting started (Conceitos básicos) ou Pipelines, selecione Create pipeline (Criar pipeline).

3. Na página Etapa 1: Escolher opção de criação, em Opções de criação, selecione a opção Criar pipeline personalizado. Escolha Próximo.

4. Em Etapa 2: Escolher as configurações do pipeline, em Nome do pipeline, insira MyEKSPipeline.

5. O CodePipeline disponibiliza pipelines dos tipos V1 e V2, que apresentam características e custos diferentes. O tipo V2 é o único tipo que você pode escolher no console. Para ter mais informações, consulte Pipeline types. Para obter informações sobre preços do CodePipeline, consulte Preços.

6. Em Perfil de serviço, escolha o perfil de serviço atualizado por você na etapa 3.

7. Deixe as configurações em Advanced settings (Configurações avançadas) como padrão e escolha Next (Próximo).

8. Na página Etapa 3: Adicionar etapa de origem, em Provedor de origem, escolha Criar uma conexão o repositório do GitHub.

9. Na página Etapa 4: Adicionar etapa de compilação, escolha Ignorar.

10. Na página Etapa 5: Adicionar etapa de implantação, escolha Amazon EKS.

    

    1. Em Tipo de configuração da implantação, escolha Helm.

    2. Em Local de chart do Helm, insira o nome da versão, como my-release. Para Local de chart do Helm, insira o caminho dos arquivos de chart do Helm, como mychart.

    3. Escolha Próximo.

11. Na página Step 6: Review, revise a configuração do pipeline e escolha Create pipeline para criá-lo.

    

12. Depois que o pipeline for executado com êxito, escolha Visualizar detalhes para exibir os logs na ação a fim de exibir a saída da ação.