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á.
# Permitindo acesso a AWS recursos com conexão Contas da AWS
Você pode usar recursos de seus CodeCatalyst espaços Contas da AWS na Amazon. Para fazer isso, você deve configurar uma conexão entre o Contas da AWS e seu espaço em CodeCatalyst. Criar uma conexão como essa significa que projetos e fluxos de trabalho em seu CodeCatalyst espaço podem interagir com recursos em seu Contas da AWS. Você deve criar uma conexão para cada uma que Conta da AWS deseja usar com seu CodeCatalyst espaço.
Depois de criar uma conexão, você pode optar por associar funções AWS do IAM a ela.
**Topics**
+ [Adicionando um Conta da AWS a um espaço](ipa-connect-account-create.md)
+ [Adicionar perfis do IAM às conexões da conta](ipa-connect-account-addroles.md)
+ [Adição da conexão da conta e dos perfis do IAM ao seu ambiente de implantação](ipa-connect-account-addroles-env.md)
+ [Visualização de conexões de conta](ipa-connect-account-list.md)
+ [Excluindo conexões de conta (em CodeCatalyst)](ipa-connect-account-delete.md)
+ [Configurar uma conta de faturamento para um espaço](connect-account-billing-ref.md)
Você pode configurar CodeCatalyst o uso autorizado Contas da AWS adicionando as contas ao seu espaço. Ao adicionar Contas da AWS ao seu CodeCatalyst espaço, você pode dar aos fluxos de trabalho do projeto acesso aos Conta da AWS recursos e à sua configuração de faturamento.
Adicionar um Conta da AWS cria uma conexão que CodeCatalyst autoriza o uso dessa conta. Você pode usar adicionado Contas da AWS para fazer o seguinte:
+ Configure o faturamento de um CodeCatalyst espaço. Consulte [Gerenciamento de faturamento](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) no Guia do CodeCatalyst Administrador da Amazon. O Conta da AWS que é especificado como a conta de cobrança do seu CodeCatalyst espaço tem cotas diferentes de outras conexões de conta para um espaço. Para obter mais informações, consulte [Cotas para o CodeCatalyst](quotas.md).
+ Permita CodeCatalyst que você assuma funções do IAM para acessar AWS recursos e implantá-los Serviços da AWS na conta. Consulte [Configuração de perfis do IAM para contas conectadas](spaces-manage-roles.md).
As conexões da conta são criadas ao concluir a autorização com a Conta da AWS. Depois que a conexão é criada, você configura ainda mais a conexão para fluxos de trabalho e projetos a serem usados adicionando perfis do IAM.
Para ver as etapas para configurar conexões de conta na Console de gerenciamento da AWS página CodeCatalyst como administrador do Conta da AWS e do espaço, consulte [Gerenciando contas conectadas](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) no *Guia do CodeCatalyst administrador*. As conexões da conta podem ser configuradas para restringir projetos específicos. Você só pode associar fluxos de trabalho ou conexões de VPC a Conta da AWS uma que tenha acesso ao seu projeto. Para ter mais informações, consulte [Configuração de conexões de contas restritas ao projeto](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).
# Adicionando um Conta da AWS a um espaço
Você usa o CodeCatalyst console e o Console de gerenciamento da AWS para conectar seu espaço a um Conta da AWS.
Antes de adicionar um Conta da AWS a um espaço em CodeCatalyst, preencha os seguintes pré-requisitos:
+ Crie um Conta da AWS e adquira permissões para criar funções AWS do IAM na conta que você deseja conectar.
+ Crie os perfis do IAM que você deseja associar à conexão da sua conta, incluindo as políticas do IAM com permissões para os perfis.
+ Adquira a função de **administrador** do CodeCatalyst Space no espaço em que você deseja criar a conexão.
**Topics**
+ [Etapa 1: criação de uma solicitação de conexão](#ipa-connect-account-create-request)
+ [Etapa 2: aceitar uma solicitação de conexão de conta](#ipa-connect-account-create-accept)
+ [Etapa 3: revisar uma conexão aprovada](#ipa-connect-account-create-review)
+ [Etapa 4: adicionar perfis do IAM à conexão](#ipa-connect-account-linkedroles)
+ [Próximas etapas: criar perfis adicionais do IAM para a conexão da sua conta](#ipa-connect-account-next)
## Etapa 1: criação de uma solicitação de conexão
A criação de uma solicitação de conexão no CodeCatalyst console gera um token de conexão que você pode usar para concluir a autorização.
Você deve ter a função de **administrador do espaço** ou **usuário avançado** no CodeCatalyst espaço em que deseja criar a conexão. Você também deve ter permissões administrativas para a Conta da AWS que deseja adicionar.
**Para criar uma conexão**
1. No Console de gerenciamento da AWS, verifique se você está logado com a mesma conta com a qual deseja criar uma conexão.
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.
1. Escolha **Adicionar um Conta da AWS**.
1. Na CodeCatalyst página ** Conta da AWS Associar à Amazon**, em **Conta da AWS ID**, insira o ID de doze dígitos da conta que você deseja conectar ao seu espaço. Para obter informações sobre como encontrar seu Conta da AWS ID, consulte [Seu Conta da AWS ID e seu alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html).
1. Em **Nome de CodeCatalyst exibição da Amazon**, insira um nome de referência para a conta.
1. (Opcional) Em **Descrição da conexão**, insira uma descrição para a conta que ajudará você a escolher os projetos aos quais a conta e os perfis serão aplicados.
1. Selecione **Associar Conta da AWS**.
1. A página retorna a **Detalhes da Conta da AWS **, onde um banner de sucesso é exibido.
## Etapa 2: aceitar uma solicitação de conexão de conta
Depois de enviar uma solicitação no CodeCatalyst console para se conectar ao seu Conta da AWS, trabalhe com o AWS administrador para aceitar a solicitação de conexão enviando-a com o token de conexão fornecido.
Verifique se você tem permissões de administrador para sua conta e se está conectado Console de gerenciamento da AWS com a mesma Conta da AWS para a qual está criando a conexão.
**Para aprovar uma solicitação de conexão (console)**
1. No Console de gerenciamento da AWS, verifique se você está logado com a mesma conta com a qual deseja criar uma conexão.
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.
1. Na página **Detalhes da Conta da AWS **, selecione **Configuração completa no Console de gerenciamento da AWS**.
1. A página **Verify Amazon CodeCatalyst Space** é aberta no Console de gerenciamento da AWS. Esta é a página do **Amazon CodeCatalyst Spaces**. Talvez seja necessário fazer login para acessá-la.
Para acessar diretamente a página, faça login no Amazon CodeCatalyst Spaces em Console de gerenciamento da AWS em https://console.aws.amazon.com/codecatalyst/ home/.
O token de verificação é inserido automaticamente no **Token de verificação**. Uma mensagem de sucesso mostra uma mensagem de que o token é válido.
1. (Opcional) Em **Níveis pagos autorizados**, selecione **Autorizar níveis pagos (Standard, Enterprise)** para ativar os níveis pagos na conta de faturamento.
**nota**
Isso não eleva o nível de faturamento para um nível pago. No entanto, isso configura o Conta da AWS para que você possa alterar o nível de cobrança do seu espaço a qualquer momento. CodeCatalyst É possível ativar os níveis pagos a qualquer momento. Sem essa alteração, o espaço só pode usar o nível gratuito.
1. Escolha **Verificar espaço**.
Uma mensagem de sucesso da **conta verificada** é exibida para mostrar que a conta foi adicionada ao espaço.
## Etapa 3: revisar uma conexão aprovada
Depois de ter a aprovação de uma conexão, você pode ver a conexão no console, junto com os perfis do IAM adicionados a ela.
**Como revisar uma conexão aprovada**
1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.
1. A conexão da conta é listada com a data em que foi criada.
1. Escolha o nome de exibição da conta. A página **Detalhes da Conta da AWS ** é exibida.
## Etapa 4: adicionar perfis do IAM à conexão
Se você estiver usando uma função do IAM configurada para uma ação de CodeCatalyst implantação, adicione a função ao seu ambiente de implantação. Para obter mais informações, consulte [Adicionar perfis do IAM às conexões da conta](ipa-connect-account-addroles.md).
## Próximas etapas: criar perfis adicionais do IAM para a conexão da sua conta
Depois de criar uma conexão, você pode criar perfis do IAM adicionais para incluir. Os perfis do IAM adicionados dependem dos seus fluxos de trabalho. Por exemplo, uma ação de CodeCatalyst construção requer a função de CodeCatalyst construção.
Para conectar a conta, você precisará do nome do recurso da Amazon (ARN) para os perfis criados. Copie o ARN dos perfis conforme detalhado aqui. Para obter mais informações sobre como trabalhar com ARNs funções do IAM, consulte [Amazon Resource Name (ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)).
Como acessar o ARN do perfil do IAM
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação, escolha **Perfis**.
1. Na caixa de pesquisa, insira o nome do perfil que você deseja adicionar.
1. Escolha o perfil na lista.
A página **Resumo** do perfil é exibida.
1. Na parte superior, copie o valor do **ARN do perfil**.
# Adicionar perfis do IAM às conexões da conta
Parte da criação da conexão da sua conta inclui adicionar a função ou funções do IAM que você deseja usar com projetos em seu CodeCatalyst espaço.
**nota**
Para usar funções do IAM com uma conexão de conta, certifique-se de que a política de confiança esteja atualizada para usar o CodeCatalyst serviço principal.
**Adicionar perfis do IAM a uma conexão de conta (console)**
1. No Console de gerenciamento da AWS, verifique se você está logado com a mesma conta que deseja gerenciar.
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.
1. Escolha o **nome de CodeCatalyst exibição da Amazon** da conexão da sua conta e, em seguida, escolha **Gerenciar funções** em Console de gerenciamento da AWS.
A página **Adicionar função do IAM ao CodeCatalyst espaço da Amazon** é exibida.
1. Execute um destes procedimentos:
+ Para criar uma função de serviço que contenha a política de permissões e a política de confiança para a função de desenvolvedor, escolha **Criar função de administrador de CodeCatalyst desenvolvimento no IAM**. O perfil terá um nome `CodeCatalystWorkflowDevelopmentRole-spaceName` com um identificador exclusivo anexado. Para ter mais informações sobre o perfil e a política de perfis, consulte [Noções básicas sobre o perfil de serviço **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role).
Selecione **Criar perfil de desenvolvimento**.
+ Para adicionar um perfil que já foi criado no IAM, selecione **Adicionar um perfil do IAM existente**. Em **Selecionar perfil do IAM existente**, escolha o perfil na lista suspensa.
Escolha **Add role (adicionar função)**.
A página é aberta no Console de gerenciamento da AWS. Talvez seja necessário fazer login para acessá-la.
1. No painel de navegação da página **Amazon CodeCatalyst Spaces**, escolha **Spaces**.
Para acessar diretamente a página, faça login no Amazon CodeCatalyst Spaces Console de gerenciamento da AWS em https://console.aws.amazon.com/codecatalyst/ home/.
1. Escolha a conta adicionada ao seu CodeCatalyst espaço. A página de conexão é exibida.
1. Na página de conexão, em **Funções do IAM disponíveis para CodeCatalyst**, veja a lista de funções do IAM adicionadas à sua conta. Escolha **Associar função do IAM CodeCatalyst** a.
1. No pop-up **Associar uma função do IAM**, em **ARN da função**, insira o Amazon Resource Name (ARN) da função do IAM que você deseja associar ao seu espaço. CodeCatalyst
Em **Propósito**, escolha uma finalidade do perfil que descreva como você deseja usar o perfil na conexão da sua conta. Especifique `RUNNER` para os perfis que você usa para executar ações em fluxos de trabalho. Especifique `SERVICE` para os perfis que você usa para acessar outro serviço.
Você pode especificar mais de uma finalidade.
**nota**
É necessário escolher uma finalidade para o ARN do perfil.
1. Selecione **Associar um perfil do IAM**. Repita essas etapas para perfis adicionais do IAM.
# Adição da conexão da conta e dos perfis do IAM ao seu ambiente de implantação
Para acessar AWS recursos, como o Amazon ECS ou AWS Lambda recursos para implantações, as ações de CodeCatalyst criação e implantação exigem funções do IAM com permissões para acessar esses recursos. Com a função de **administrador de espaço** ou **usuário avançado**, você pode conectar sua CodeCatalyst conta ao Conta da AWS local onde seus recursos são criados. Depois, adicione o perfil do IAM à conexão da sua conta. Para implantar ações, você deve então adicionar a função do IAM a um CodeCatalyst ambiente.
Você deve adicionar os perfis do IAM que deseja usar com ambientes de implantação em seus projetos. Adicionar os perfis à conexão da conta não adiciona os perfis e a conexão aos ambientes de implantação do projeto. Para adicionar sua conexão de conta e perfis do IAM ao seu ambiente de implantação, certifique-se de que a conexão da conta e os perfis sejam criados conforme detalhado em[Etapa 4: adicionar perfis do IAM à conexão](ipa-connect-account-create.md#ipa-connect-account-linkedroles).
Em seguida, use a página **Ambientes** no CodeCatalyst console para adicionar sua conexão de conta e função do IAM a um ambiente de implantação em um projeto.
**nota**
Você só adiciona uma função do IAM a um ambiente se a função do IAM for usada para uma CodeCatalyst ação que exija uma função do IAM. Todas as ações de fluxo de trabalho que exigem funções do IAM, incluindo ações de criação, devem usar um CodeCatalyst ambiente.
Para adicionar a conexão da conta e os perfis do IAM ao seu ambiente de implantação
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto com o ambiente de implantação em que você deseja adicionar a conexão da conta e os perfis do IAM.
1. Expanda **CI/CD** e selecione **Ambientes**.
1. Escolha seu ambiente e, depois, as guias adicionais serão exibidas.
1. Escolha a guia **Conexões de Conta da AWS **. Em **Nome da conexão**, as contas que foram adicionadas ao ambiente, se houver, são listadas.
1. Selecione **Associar Conta da AWS**. A página **Associar Conta da AWS a ** é exibida.
1. Em **Conexão**, escolha o nome da conexão da conta com os perfis do IAM que você deseja adicionar. Selecione **Associar **.
# Visualização de conexões de conta
Você pode ver uma lista das conexões e ver detalhes sobre cada conexão.
Você deve ter o perfil de **Administrador do espaço** ou **Usuário avançado** para gerenciar conexões para seu espaço.
**Para ver todas as conexões de um CodeCatalyst espaço**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o espaço com a conexão de conta que você quer exibir.
1. Selecione a guia **Contas da AWS **.
1. Em **Contas da AWS **, veja a lista de conexões de conta do espaço, incluindo o ID da conta e o status de cada conexão.
**Para ver os detalhes da conexão da conta**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.
1. No **nome de CodeCatalyst exibição da Amazon**, escolha o nome da conexão. Na página **Detalhes**, veja a lista de perfis do IAM associados à conexão junto com outros detalhes.
# Excluindo conexões de conta (em CodeCatalyst)
Você pode excluir uma conexão de conta caso não precise mais dela. Para esse procedimento, você usará CodeCatalyst para excluir uma conexão de conta que você adicionou anteriormente ao seu espaço. Isso exclui a conexão da conta do seu espaço, desde que a conta não seja a conta de faturamento do espaço.
**Importante**
Depois que uma conexão de conta for excluída, você não poderá reconectá-la. Você deve criar uma conexão de conta e, depois, associar perfis e ambientes do IAM ou configurar o faturamento, conforme necessário.
Uma conta de cobrança deve ser designada para seu CodeCatalyst espaço, mesmo que o uso do espaço não exceda o nível gratuito. Antes de remover um espaço de uma conta que é uma conta de faturamento designada, você precisará adicionar outra conta ao seu espaço. Consulte [Gerenciamento de faturamento](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) no Guia do CodeCatalyst Administrador da Amazon.
**Importante**
Embora você possa usar essas etapas para remover uma conta, isso não é recomendado. A conta também pode ser configurada para oferecer suporte aos fluxos de trabalho em CodeCatalyst.
Para gerenciar conexões de conta para seu espaço, você deve ter o perfil de **Administrador do espaço** ou **Usuário avançado**.
Uma conta que foi removida pode ser adicionada novamente mais tarde, mas você deve criar uma conexão entre a conta e o espaço. Será necessário reassociar todos os perfis do IAM à conta adicionada.
**Como excluir uma conexão de conta**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o seu CodeCatalyst espaço. Escolha **Settings (Configurações)** e **Contas da AWS**.
1. Em **Nome de CodeCatalyst exibição da Amazon**, escolha o seletor ao lado da conexão da conta que você deseja remover.
1. Escolha **Remover Conta da AWS**. Confirme a exclusão inserindo o nome no campo e selecione **Remover**.
Será exibido um banner de sucesso e a conexão da conta é removida da lista de conexões.
# Configurar uma conta de faturamento para um espaço
Uma conta de cobrança deve ser designada para seu CodeCatalyst espaço, mesmo que o uso do espaço não exceda o nível gratuito.
Para configurar uma conta de faturamento, consulte [Faturamento](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) no Guia do *CodeCatalyst administrador*. O Conta da AWS que é especificado como a conta de cobrança do seu CodeCatalyst espaço tem cotas diferentes de outras conexões de conta para um espaço. Para obter mais informações, consulte [Cotas para o CodeCatalyst](quotas.md).
Para remover uma conta que é uma conta de cobrança designada para seu CodeCatalyst espaço, certifique-se primeiro de especificar uma nova conta de cobrança.