A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Implantação em e Contas da AWS VPCs
Usando [CodeCatalyst fluxos de trabalho](workflow.md), você pode implantar aplicativos e outros recursos para atingir Conta da AWS s e Amazon VPCs na AWS nuvem. Para habilitar essas implantações, você deve configurar CodeCatalyst ambientes.
Um CodeCatalyst *ambiente*, que não deve ser confundido com um [ambiente de desenvolvimento](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html), define o Amazon VPC de destino Conta da AWS e opcional ao qual um CodeCatalyst [fluxo de trabalho](workflow.md) se conecta. Um ambiente também define a [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que um fluxo de trabalho precisa para acessar os AWS serviços e recursos na conta de destino.
É possível configurar vários ambientes e atribuir a eles nomes, como desenvolvimento, teste, preparação e produção. Quando você implanta nesses ambientes, as informações sobre as implantações aparecem nas CodeCatalyst guias **Atividade** de **implantação e Destinos** de implantação no ambiente.
## Como começo a usar ambientes?
As etapas de alto nível para adicionar e usar um CodeCatalyst ambiente são as seguintes:
1. No seu CodeCatalyst espaço, **conecte uma ou mais AWS contas**. Durante esse processo, adicione os perfis do IAM que seu fluxo de trabalho exige para acessar recursos na sua Conta da AWS. Para obter mais informações, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md).
1. Em seu CodeCatalyst projeto, **crie um ambiente** que inclua uma das funções Conta da AWS s e IAM da etapa 1. Para obter mais informações, consulte [Criar um ambiente](deploy-environments-creating-environment.md).
1. Em seu CodeCatalyst projeto, em um fluxo de trabalho, **adicione uma [ação](workflows-actions.md) que aponte para o ambiente** que você criou na etapa 2. Para obter mais informações, consulte [Adição de uma ação a um fluxo de trabalho](workflows-add-action.md).
Agora você configurou um ambiente. A ação agora pode implantar recursos na Conta da AWS especificada no ambiente.
**nota**
Você também pode adicionar uma Amazon VPC ao ambiente. Para obter mais informações, consulte [Adicionar conexões VPC a um espaço](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) no *Guia de CodeCatalyst Administração e.* [Associação de uma VPC a um ambiente](deploy-environments-associate-vpc.md)
## Podem existir vários ambientes em um único fluxo de trabalho?
Sim. Se um fluxo de trabalho incluir várias ações, cada uma dessas ações poderá ser atribuída a um ambiente. Por exemplo, você pode ter um fluxo de trabalho que inclua duas ações de implantação, em que uma é atribuída a um ambiente `my-staging-enviroment` e outra a um ambiente `my-production-environment`.
## Quais ações de fluxo de trabalho oferecem suporte aos ambientes?
Qualquer ação de fluxo de trabalho que implanta recursos na AWS nuvem ou se comunica com os AWS serviços por outros motivos (como monitoramento e geração de relatórios) oferece suporte aos ambientes.
## Quais ações permitem que suas informações de implantação sejam exibidas CodeCatalyst?
Das ações de fluxo de trabalho que oferecem suporte a ambientes, apenas algumas oferecem suporte para que suas informações de implantação sejam exibidas nas páginas **Atividade** de **implantação e Destinos** de implantação do CodeCatalyst console.
As ações de fluxo de trabalho a seguir permitem que as informações de implantação sejam exibidas:
+ **Deploy CloudFormation stack** — Para obter mais informações, consulte [Implantação de uma pilha CloudFormation](deploy-action-cfn.md)
+ **Implantar no Amazon ECS**: para ter mais informações, consulte [Implantação no Amazon ECS com um fluxo de trabalho](deploy-action-ecs.md)
+ **Implantar no cluster do Kubernetes**: para ter mais informações, consulte [Implantar no Amazon EKS com um fluxo de trabalho](deploy-action-eks.md)
+ **AWS CDK implantar** — Para obter mais informações, consulte [Implantando um AWS CDK aplicativo com um fluxo de trabalho](cdk-dep-action.md)
## Regiões aceitas
A página **Ambientes** pode exibir recursos em qualquer região da AWS .
## Um ambiente é obrigatório?
Um ambiente é obrigatório se a ação do fluxo de trabalho à qual ele está atribuído implantar recursos na AWS nuvem ou se comunicar com os AWS serviços por outros motivos (como monitoramento e geração de relatórios).
Por exemplo, se você tem uma ação de criação que cria um aplicativo, mas não precisa se comunicar com sua VPC Conta da AWS ou com a Amazon VPC, não é necessário atribuir um ambiente à ação. Se, no entanto, a ação de criação enviar registros para o CloudWatch serviço da Amazon em seu Conta da AWS, a ação deverá ter um ambiente atribuído.
**Topics**
+ [Como começo a usar ambientes?](#deploy-environments-get-started)
+ [Podem existir vários ambientes em um único fluxo de trabalho?](#deploy-environments-multiple)
+ [Quais ações de fluxo de trabalho oferecem suporte aos ambientes?](#deploy-environments-supported)
+ [Quais ações permitem que suas informações de implantação sejam exibidas CodeCatalyst?](#deploy-environments-supported-targets)
+ [Regiões aceitas](#deploy-environments-supported-regions)
+ [Um ambiente é obrigatório?](#deploy-environments-optional-or-mandatory)
+ [Criar um ambiente](deploy-environments-creating-environment.md)
+ [Associação de um ambiente a uma ação](deploy-environments-add-app-to-environment.md)
+ [Associação de uma VPC a um ambiente](deploy-environments-associate-vpc.md)
+ [Associando um Conta da AWS a um ambiente](deploy-environments-associate-account.md)
+ [Alteração do perfil do IAM de uma ação](deploy-environments-switch-role.md)
# Criar um ambiente
Use as instruções a seguir para criar um ambiente que você possa associar posteriormente a uma ação de fluxo de trabalho.
**Antes de começar**
Você precisará do seguinte:
+ Um CodeCatalyst espaço. Para obter mais informações, consulte [Configuração e login no CodeCatalystConfiguração e login no CodeCatalyst](setting-up-topnode.md).
+ Um CodeCatalyst projeto. Para obter mais informações, consulte [Criar um projeto com um esquema](projects-create.md#projects-create-console-template).
+ Uma conexão de AWS conta que inclui as funções do IAM que sua ação de fluxo de trabalho precisará acessar AWS. Para ter informações sobre a criação de uma conexão de conta, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md). Você pode usar no máximo uma conexão de conta por ambiente.
**nota**
Você pode criar um ambiente sem uma conexão de conta. No entanto, você precisará voltar e adicionar a conexão posteriormente.
+ Uma das seguintes CodeCatalyst funções:
+ **Administrador do espaço**
+ **Administrador do projeto**
+ **Contributor (Colaborador)**
**nota**
Se você tiver o **Perfil de colaborador**, poderá criar um ambiente, mas não poderá associá-lo a uma conexão de Conta da AWS . Você precisará pedir a alguém com a função de **administrador do Space** ou **administrador do projeto** que associe o ambiente a uma Conta da AWS conexão.
Para ter mais informações sobre permissões e perfis, consulte [Concessão de permissões de projeto aos usuários](projects-members.md).
**Para criar um ambiente**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, selecione **CI/CD** e **Ambientes**.
1. Em **Nome do ambiente**, insira um nome, como **Production** ou **Staging**.
1. Em **Tipo de ambiente**, selecione uma das seguintes opções:
+ **Não produção**: um ambiente em que você pode testar a aplicação para garantir que ela esteja funcionando conforme o esperado antes de colocá-la em produção.
+ **Produção**: um ambiente “ativo” que está disponível publicamente e hospeda a aplicação finalizada.
Se você selecionar **Produção**, um selo **Produção** aparecerá na interface de usuário ao lado de todas as ações às quais o ambiente esteja associado. O selo ajuda você a ver rapidamente quais ações estão sendo implantadas na produção. Além da aparência do selo, não há diferenças entre ambientes de produção e não produção.
1. (Opcional) Em **Descrição**, insira uma descrição como **Production environment for the hello-world app**.
1. Em **Conta da AWS conexão - opcional**, escolha a conexão de AWS conta que você deseja associar a esse ambiente. As ações de fluxo de trabalho atribuídas a esse ambiente poderão se conectar à Conta da AWS associada. Para obter mais informações sobre a criação de Conta da AWS conexões em CodeCatalyst, consulte[Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md).
Se a Conta da AWS conexão que você deseja usar não estiver listada, talvez seja porque ela não é permitida em seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst * Administrator Guide.
1. Em **Perfil do IAM padrão**, escolha o perfil do IAM que você deseja associar a esse ambiente. As ações de fluxo de trabalho atribuídas a esse ambiente herdarão essa função do IAM e poderão usá-la para se conectar aos serviços e recursos em seu Conta da AWS.
Se você precisar atribuir o ambiente a várias ações e essas ações precisarem de perfis do IAM diferentes do padrão especificado aqui, você poderá especificar os diferentes perfis na guia **Configuração** de cada ação, usando a opção **Alternar perfil**. Para obter mais informações, consulte [Alteração do perfil do IAM de uma ação](deploy-environments-switch-role.md).
Se a função do IAM que você deseja usar como padrão não estiver listada, pode ser porque você ainda não a adicionou à sua Conta da AWS conexão. Para adicionar um perfil do IAM a uma conexão de conta, consulte [Adicionar perfis do IAM às conexões da conta](ipa-connect-account-addroles.md).
1. (Opcional) Em **Conexão VPC**, escolha uma conexão VPC que você deseja associar a esse ambiente. Para obter mais informações sobre a criação de conexões VPC, consulte Gerenciando [Amazon Virtual Private Clouds](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) no *Amazon CodeCatalyst Administrator Guide*.
Se a conexão VPC que você deseja usar não estiver listada, talvez seja porque ela inclui uma Conta da AWS conexão que não é permitida em seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst * Administrator Guide.
1. Escolha **Criar ambiente**. CodeCatalyst cria um ambiente vazio.
**Próximas etapas**
+ Agora que criou um ambiente, você pode associá-lo a uma ação de fluxo de trabalho. Para obter mais informações, consulte [Associação de um ambiente a uma ação](deploy-environments-add-app-to-environment.md).
# Associação de um ambiente a uma ação
Quando você associa um ambiente a uma [ação de fluxo de trabalho compatível](deploy-environments.md#deploy-environments-supported), a função padrão do IAM do ambiente e a Amazon VPC opcional são atribuídas à ação. Conta da AWS A ação pode se conectar e implantar na Conta da AWS usando o perfil do IAM e também se conectar à Amazon VPC opcional.
Use as instruções a seguir para associar um ambiente a uma ação.
## Etapa 1: associar o ambiente a uma ação de fluxo de trabalho
Use o procedimento a seguir para associar um ambiente a uma ação de fluxo de trabalho.
------
#### [ Visual ]
**Para associar um ambiente a uma ação de fluxo de trabalho usando o editor visual**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.
1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.
1. Escolha **Editar**.
1. Selecione **Visual**.
1. No diagrama do fluxo de trabalho, escolha uma ação compatível com ambientes. Para obter mais informações, consulte [Quais ações permitem que suas informações de implantação sejam exibidas CodeCatalyst?](deploy-environments.md#deploy-environments-supported-targets).
1. Escolha a guia **Configuração** e especifique as informações no campo **Ambiente**, da seguinte forma.
**Ambiente**
Especifique o CodeCatalyst ambiente a ser usado com a ação. A ação se conecta à Conta da AWS Amazon VPC opcional especificada no ambiente escolhido. A ação usa a função padrão do IAM especificada no ambiente para se conectar ao e usa a Conta da AWS função do IAM especificada na [conexão da Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) para se conectar à Amazon VPC.
**nota**
Se o perfil do IAM padrão não tiver as permissões exigidas pela ação, você poderá configurar a ação para usar um perfil diferente. Para obter mais informações, consulte [Alteração do perfil do IAM de uma ação](deploy-environments-switch-role.md).
Para ter mais informações sobre ambientes, consulte [Implantação em e Contas da AWS VPCs](deploy-environments.md) e [Criar um ambiente](deploy-environments-creating-environment.md).
1. (Opcional) Altere o perfil do IAM associado à ação. Você talvez queira alterar o perfil se ele contiver o conjunto errado de permissões para a ação.
Para alterar o perfil:
1. No **What's in*my-environment*?** caixa e escolha o ícone de elipse vertical (). ![\[Ellipsis.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/flows/elipsis.png)
1. Escolha uma das seguintes opções:
+ **Alternar perfil**. Escolha essa opção para alterar o perfil do IAM usado por essa ação, e somente essa ação. Outras ações continuam usando o perfil do IAM padrão especificado no ambiente associado. Para obter mais informações, consulte [Alteração do perfil do IAM de uma ação](deploy-environments-switch-role.md).
+ **Editar ambiente**. Escolha essa opção para alterar o perfil do IAM padrão listado em seu ambiente. Quando você escolhe essa opção, sua ação — e qualquer outra ação associada ao mesmo ambiente — começa a usar o novo perfil do IAM padrão.
**Importante**
Tenha cuidado ao atualizar o perfil do IAM padrão. Alterar o perfil pode levar a falhas de ação se as permissões no perfil não forem suficientes para todas as ações que compartilham o ambiente.
1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.
1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.
------
#### [ YAML ]
**Para associar um ambiente a uma ação de fluxo de trabalho usando o editor YAML**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.
1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.
1. Escolha **Editar**.
1. Selecione **YAML**.
1. 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
```
Para ter mais informações, consulte o tópico [Tipos de ação](workflows-actions.md#workflows-actions-types). Este tópico tem links para a documentação de cada ação, incluindo a referência YAML.
1. (Opcional) Se você quiser que a ação use um perfil diferente do perfil do IAM padrão listado no ambiente, adicione uma seção `Connections:` que inclua o perfil que você deseja usar. Para obter mais informações, consulte [Alteração do perfil do IAM de uma ação](deploy-environments-switch-role.md).
1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.
1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.
------
## Etapa 2: preencher a página de atividades de implantação
Depois de associar um ambiente a uma ação de fluxo de trabalho, você pode preencher as páginas **Atividade de implantação** **e Destino** de implantação na seção **Ambientes** do CodeCatalyst console com informações de implantação. Use as instruções a seguir para preencher essas páginas.
**nota**
Apenas algumas ações permitem que suas informações de implantação sejam exibidas no CodeCatalyst console. Para obter mais informações, consulte [Quais ações permitem que suas informações de implantação sejam exibidas CodeCatalyst?](deploy-environments.md#deploy-environments-supported-targets).
**Para adicionar informações de implantação ao CodeCatalyst**
1. Se a execução de um fluxo de trabalho não foi iniciada automaticamente quando você confirmou as alterações em [Etapa 1: associar o ambiente a uma ação de fluxo de trabalho](#deploy-environments-add-app-to-environment-assoc), inicie manualmente a execução da seguinte forma:
1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.
1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.
1. Escolha **Executar**.
A execução do fluxo de trabalho inicia uma nova implantação, o que faz com que CodeCatalyst as informações de implantação sejam adicionadas CodeCatalyst a.
1. Verifique se a atividade de implantação foi adicionada ao CodeCatalyst console:
1. No painel de navegação, selecione **CI/CD** e **Ambientes**.
1. Escolha seu ambiente (por exemplo, `Production`).
1. 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 os recursos da aplicação.
1. Escolha a guia **Destinos de implantação** e verifique se os recursos da aplicação aparecem.
# Associação de uma VPC a um ambiente
Quando uma ação é configurada com um ambiente que tem uma conexão VPC, a ação é executada conectada à VPC, aderindo às regras de rede e aos recursos de acesso especificados pela VPC associada. A mesma conexão VPC pode ser usada por um ou mais ambientes.
Use as instruções a seguir para associar uma conexão VPC a um ambiente.
**Para associar uma conexão VPC a um ambiente**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, selecione **CI/CD** e **Ambientes**.
1. Escolha seu ambiente (por exemplo, `Production`).
1. Escolha a guia **Propriedades do ambiente**.
1. Selecione **Gerenciar conexão VPC**, escolha a conexão VPC desejada e selecione **Confirmar**. Isso associa a conexão VPC selecionada a esse ambiente.
**nota**
Se a conexão VPC que você deseja usar não estiver listada, talvez seja porque ela inclui uma Conta da AWS conexão que não é permitida em seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst* Administrator Guide.
Para obter mais informações, consulte [Gerenciando Amazon Virtual Private Clouds](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) no *Guia CodeCatalyst do Administrador*.
# Associando um Conta da AWS a um ambiente
Use as instruções a seguir para associar um Conta da AWS a um ambiente. Quando você associa um Conta da AWS a um ambiente, as ações do fluxo de trabalho atribuídas ao ambiente poderão se conectar ao Conta da AWS.
Para ter mais informações sobre conexões de conta, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md).
**Antes de começar**
Você precisará do seguinte:
+ Uma conexão de AWS conta que inclui as funções do IAM que sua ação de fluxo de trabalho precisará acessar AWS. Para ter informações sobre a criação de uma conexão de conta, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md). Você pode usar no máximo uma conexão de conta por ambiente.
+ Uma das seguintes CodeCatalyst funções: **administrador do espaço ou administrador** **do projeto**. Para obter mais informações, consulte [Concessão de permissões de projeto aos usuários](projects-members.md).
**Para associar um Conta da AWS a um ambiente**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, selecione **CI/CD** e **Ambientes**.
1. Escolha seu ambiente (por exemplo, `Production`).
1. Selecione **Editar ambiente**.
1. Em **Propriedades do ambiente**, na lista suspensa **Conexão da Conta da AWS - opcional**, escolha a Conta da AWS desejada.
Se a Conta da AWS conexão que você deseja usar não estiver listada, talvez seja porque ela não é permitida em seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst * Administrator Guide.
1. Em **Perfil do IAM padrão**, escolha o perfil do IAM que você deseja associar a esse ambiente. As ações de fluxo de trabalho atribuídas a esse ambiente herdarão essa função do IAM e poderão usá-la para se conectar aos serviços e recursos em seu Conta da AWS.
Se a função do IAM que você deseja usar como padrão não estiver listada, pode ser porque você ainda não a adicionou à sua Conta da AWS conexão. Para adicionar um perfil do IAM a uma conexão de conta, consulte [Adicionar perfis do IAM às conexões da conta](ipa-connect-account-addroles.md).
# Alteração do perfil do IAM de uma ação
Por padrão, quando você associa um [ambiente](deploy-environments.md) a uma [ação](workflows-actions.md) de fluxo de trabalho, a ação herda o perfil do IAM padrão especificado no ambiente. Você pode alterar esse comportamento para que a ação use um perfil diferente. Talvez você queira que uma ação use um perfil diferente se o perfil do IAM padrão não tiver as permissões de que a ação precisa para operar na nuvem da AWS .
Para atribuir um perfil do IAM diferente a uma ação, você pode usar a opção **Alternar perfil** no editor visual ou a propriedade `Connections:` no editor YAML. O novo perfil substitui o perfil do IAM padrão especificado no ambiente, permitindo que você mantenha o perfil do IAM padrão como está. Talvez você queira manter o perfil do IAM padrão como está se houver outras ações que o usem.
Use as instruções a seguir para configurar uma ação para usar um perfil do IAM diferente do especificado no ambiente.
------
#### [ Visual ]
**Para atribuir um perfil do IAM diferente a uma ação (editor visual)**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.
1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.
1. Escolha **Editar**.
1. Escolha a caixa que representa a ação cujo perfil do IAM você deseja atualizar.
1. Escolha a guia **Configuração**.
1. No **What's in*my-environment*?** caixa, escolha o ícone de elipse vertical (). ![\[Ellipsis.\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/flows/elipsis.png)
1. Selecione **Alternar perfil**.
1. Na caixa de diálogo **Alternar perfil**, na lista suspensa **Perfil do IAM**, escolha o perfil do IAM que você deseja que a ação use. Esse perfil substituirá o perfil do IAM padrão no ambiente. Se o perfil que você deseja usar não estiver na lista, adicione-o ao seu espaço. Para obter mais informações, consulte [Adicionar perfis do IAM às conexões da conta](ipa-connect-account-addroles.md).
A função escolhida agora aparece na seção **What's in*my-environment*?** caixa junto com um selo **Definido no fluxo de trabalho**. O perfil também aparece no arquivo de definição do fluxo de trabalho, na seção `Connections:`.
1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.
1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.
------
#### [ YAML ]
**Para atribuir um perfil do IAM diferente a uma ação (editor YAML)**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Selecione o projeto.
1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.
1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.
1. Escolha **Editar**.
1. Selecione **YAML**.
1. Na ação do fluxo de trabalho em que você deseja usar um perfil do IAM diferente, adicione uma seção `Connections:` semelhante à seguinte:
```
action-name:
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
```
No código anterior, *account-connection-name* substitua pelo nome da [conexão da conta](ipa-connect-account.md) que contém a função do IAM e *iam-role-name* substitua pelo nome da função do IAM que você deseja que a ação use. Esse perfil substituirá o perfil do IAM padrão no ambiente. Verifique se adicionou o perfil ao seu espaço. Para obter mais informações, consulte [Adicionar perfis do IAM às conexões da conta](ipa-connect-account-addroles.md).
Para ter mais informações, consulte o tópico [Tipos de ação](workflows-actions.md#workflows-actions-types). Este tópico tem links para a documentação de cada ação, incluindo a referência YAML.
------