Associando um ambiente, uma conexão de conta e uma função do IAM a uma ação de fluxo de trabalho

Quando você associa um ambiente, uma conexão de conta e uma função do IAM a uma ação de fluxo de trabalho compatível, a função do IAM fica disponível para uso pela ação. Além de obter acesso a uma função do IAM, a ação também pode ter suas informações de implantação importadas para a página Ambientes. Para ter mais informações, consulte Quais ações apoiam os ambientes?.

Use as instruções a seguir para associar um ambiente, uma conexão de conta e uma função do IAM a uma ação.

Etapa 1: associar o ambiente, a conexão da conta e a função a uma ação de fluxo de trabalho

Use o procedimento a seguir para associar um ambiente, uma conexão de conta e uma função a uma ação de fluxo de trabalho.

Visual

Para associar um ambiente, uma conexão de conta e uma função a uma ação de fluxo de trabalho usando o editor visual

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

2. Selecione o projeto.

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

4. Escolha o nome do seu fluxo de trabalho. Você pode filtrar pelo nome do repositório ou ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome do fluxo de trabalho.

5. Selecione a opção Editar.

6. Escolha Visual.

7. No diagrama do fluxo de trabalho, escolha uma ação compatível com ambientes. Para ter mais informações, consulte Quais ações apoiam os ambientes?.

8. Escolha a guia Configuração e especifique as informações nos campos, da seguinte maneira.

   Ambiente

   Especifique o CodeCatalyst ambiente a ser usado com a ação.

   Para obter mais informações sobre ambientes, consulte Implantação em Contas da AWS e VPCs com ambientes CodeCatalyst Criar um ambiente e.

   Conexão de conta ou Conexão - opcional (o que estiver disponível)

   Especifique a conexão da conta a ser associada à ação. Você pode especificar no máximo uma conexão de conta emEnvironment.

   Para obter mais informações sobre conexões de conta, consultePermitindo acesso a AWS recursos com conexão Contas da AWS. Para obter informações sobre como associar uma conexão de conta ao seu ambiente, consulteCriar um ambiente.

   Função

   Especifique o nome da função do IAM que essa ação usa para acessar e operar em AWS serviços como Amazon S3 e Amazon ECR. Certifique-se de que essa função seja adicionada à conexão da sua conta. Para adicionar uma função do IAM a uma conexão de conta, consulteAdicionar funções do IAM às conexões da conta.

   nota

   Você pode especificar o nome da CodeCatalystWorkflowDevelopmentRole-spaceName função aqui, desde que ela tenha permissões suficientes. Para obter mais informações sobre essa função, consulte Criando a CodeCatalystWorkflowDevelopmentRole-spaceNamefunção para sua conta e espaço. Entenda que a CodeCatalystWorkflowDevelopmentRole-spaceName função tem permissões muito amplas que podem representar um risco de segurança. Recomendamos que você use essa função somente em tutoriais e cenários em que a segurança seja menos preocupante.

   Se você não vê a função na lista, é porque você não a associou à conexão da conta. Para ter mais informações, consulte Adicionar funções do IAM às conexões da conta.

9. (Opcional) Escolha Validar para validar o código YAML do fluxo de trabalho antes de confirmar.

10. Escolha Confirmar, insira uma mensagem de confirmação e escolha Confirmar novamente.

YAML

Para associar um ambiente, uma conexão de conta e uma função a uma ação de fluxo de trabalho usando o editor YAML

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

2. Selecione o projeto.

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

4. Escolha o nome do seu fluxo de trabalho. Você pode filtrar pelo nome do repositório ou ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome do fluxo de trabalho.

5. Selecione a opção Editar.

6. Escolha YAML.

7. Na ação do fluxo de trabalho que você deseja associar a um ambiente, adicione um código semelhante ao seguinte:

   action-name
     Environment:
       Name: environment-name
       Connections: 
         - Name: account-connection-name
           Role: iam-role-name

   Para obter mais informações, consulte Definição de fluxo de trabalho YAML para sua ação.

8. (Opcional) Escolha Validar para validar o código YAML do fluxo de trabalho antes de confirmar.

9. Escolha Confirmar, insira uma mensagem de confirmação e escolha Confirmar novamente.

Etapa 2: preencher o ambiente

Depois de associar um ambiente, uma conexão de conta e uma função à ação do fluxo de trabalho, você pode preencher a página Ambientes com informações de implantação. Use as instruções a seguir para preencher a página Ambientes.

nota

A página Ambientes é suportada somente por um subconjunto de ações do fluxo de trabalho. Para ter mais informações, consulte Quais ações apoiam os ambientes?.

Para povoar o meio ambiente

1. Se a execução de um fluxo de trabalho não foi iniciada automaticamente quando você confirmou suas alteraçõesEtapa 1: associar o ambiente, a conexão da conta e a função a uma ação de fluxo de trabalho, inicie manualmente a execução da seguinte forma:

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

   2. Escolha o nome do fluxo de trabalho em que você deseja iniciar uma execução. Você pode filtrar pelo nome do repositório ou ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome do fluxo de trabalho.

   3. Escolha Executar.

   A execução do fluxo de trabalho inicia uma nova implantação, o que faz com que CodeCatalyst as informações de recursos do aplicativo sejam adicionadas em Ambientes.

2. Verifique se os recursos do seu aplicativo aparecem em seu ambiente:

   1. No painel de navegação, escolha CI/CD e, em seguida, escolha Ambientes.

   2. Escolha seu ambiente (por exemplo,Production).

   3. Escolha a guia Atividade de implantação e verifique se uma implantação aparece com o status BEM-SUCEDIDO. Isso indica que a execução de um fluxo de trabalho implantou com êxito os recursos do seu aplicativo.

   4. Escolha a guia Alvos de implantação e verifique se os recursos do seu aplicativo aparecem.