Aviso de fim do suporte: em 7 de outubro de 2026, AWS encerrará o suporte para AWS Proton. Depois de 7 de outubro de 2026, você não poderá mais acessar o AWS Proton console ou os AWS Proton recursos. Sua infraestrutura implantada permanecerá intacta. Para obter mais informações, consulte o Guia [AWS Proton de descontinuação e migração de serviços](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html).

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á.

# Configurando com AWS Proton
<a name="setting-up-for-service"></a>

Se você quiser usar o AWS CLI para executar AWS Proton APIs, verifique se você o instalou. Se ainda não o tiver instalado, consulte [Configurando o AWS CLI](#ag-setting-up-cli).

**AWS Proton configuração específica:**
+ **Para criar e gerenciar modelos:**
  + Se você estiver usando [configurações de sincronização de modelos](ag-template-sync-configs.md), configure uma [conexão do AWS CodeStar](#setting-up-vcontrol).
  + Caso contrário, configure um [bucket do Amazon S3](#setting-up-bucket).
+ **Para provisionar infraestrutura:**
  + Para o [provisionamento autogerenciado](ag-works-prov-methods.md#ag-works-prov-methods-self), você deve configurar uma [conexão do AWS CodeStar](#setting-up-vcontrol).
+ **(Opcional) Para provisionar pipelines:**
  + [Para [provisionamento AWS gerenciado e provisionamento CodeBuild](ag-works-prov-methods.md#ag-works-prov-methods-direct)[baseado, configure as funções do](ag-works-prov-methods.md#ag-works-prov-methods-codebuild) pipeline.](#setting-up-pr-role)
  + Para [provisionamento autogerenciado](ag-works-prov-methods.md#ag-works-prov-methods-self), configure um [repositório de pipeline](#setting-up-pr-repo). 

Para obter mais informações sobre métodos de provisionamento, consulte [Como funciona o provisionamento AWS gerenciado](ag-works-prov-methods.md#ag-works-prov-methods-direct).

## Configurar um bucket do Amazon S3
<a name="setting-up-bucket"></a>

Para configurar um bucket do S3, siga as instruções em [Crie seu primeiro bucket do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) para configurar um bucket do S3. Coloque suas entradas AWS Proton no bucket onde AWS Proton você pode recuperá-las. Essas entradas são conhecidas como pacotes de modelos. Você pode aprender mais sobre eles em outras seções deste guia.

## Configurando uma AWS CodeStar conexão
<a name="setting-up-vcontrol"></a>

Para se conectar AWS Proton a um repositório, você cria uma AWS CodeStar conexão que ativa um pipeline quando um novo commit é feito em um repositório de código-fonte de terceiros.

**AWS Proton usa a conexão para:**
+ Ativar um pipeline de serviço quando um novo commit for feito no código-fonte do seu repositório.
+ Faça uma pull request em uma infraestrutura como repositório de código.
+ Crie uma nova versão secundária ou principal do modelo sempre que um commit for enviado para um repositório de modelos que altera um dos seus modelos, caso a versão ainda não exista.

Você pode se conectar aos repositórios Bitbucket GitHub, GitHub Enterprise e GitHub Enterprise Server com o. CodeConnections Consulte mais informações em [CodeConnections](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html) no *Guia de Usuário AWS CodePipeline *.

**Para configurar uma CodeStar conexão.**

1. Abra o [console de AWS Proton](https://console.aws.amazon.com//proton/).

1. No painel de navegação, selecione **Configurações** e, em seguida, **Conexões do repositório** para ir até a página **Conexões** nas **Configurações** das **Ferramentas do Desenvolvedor**. A página exibe uma lista de conexões.

1. Escolha **Criar conexão** e siga as instruções.

## Configurando as configurações do CI/CD funil da conta
<a name="setting-up-pr-pipelines"></a>

AWS Proton pode provisionar CI/CD pipelines para implantar o código do aplicativo em suas instâncias de serviço. As AWS Proton configurações necessárias para o provisionamento do pipeline dependem do método de provisionamento escolhido para o pipeline.

### AWS-provisionamento gerenciado e CodeBuild baseado — configure funções de pipeline
<a name="setting-up-pr-role"></a>

Com provisionamento e [provisionamento AWS gerenciados, CodeBuild ](ag-works-prov-methods.md#ag-works-prov-methods-direct) [provisiona pipelines para](ag-works-prov-methods.md#ag-works-prov-methods-codebuild) você. AWS Proton Portanto, AWS Proton precisa de uma função de serviço que forneça permissões para o provisionamento de pipelines. Cada um desses dois métodos de provisionamento usa seu próprio perfil de serviço. Essas funções são compartilhadas em todos os pipelines AWS Proton de serviço e você as configura uma vez nas configurações da sua conta.

**Para criar perfis de serviços do pipeline usando o console**

1. Abra o [console de AWS Proton](https://console.aws.amazon.com//proton/).

1. No painel de navegação, selecione **Configurações** e em seguida **Configurações de conta**.

1. Na página ** CI/CD Configurações da conta**, escolha **Configurar**.

1. Execute um destes procedimentos:
   + **Ter AWS Proton criado uma função de serviço de pipeline para você**

     [Para habilitar o provisionamento de pipelines gerenciado pela AWS] Na página **Definir configurações da conta**, na seção **perfil de pipeline de provisionamento gerenciado pela AWS**:

     1. Selecione **Novo perfil de serviço**.

     1. Forneça um nome para o perfil, por exemplo, **myProtonPipelineServiceRole**.

     1. Marque a caixa de seleção para concordar em criar uma AWS Proton função com privilégios administrativos em sua conta.

     [Para ativar o provisionamento CodeBuild baseado em pipelines] Na página **Definir configurações da conta**, na seção **Função do CodeBuild pipeline**, escolha Função de **serviço existente e escolha a função** de serviço que você criou na seção Função do **CloudFormation pipeline**. Ou, se você não atribuiu uma função de CloudFormation pipeline, repita as três etapas anteriores para criar uma nova função de serviço.
   + **Para escolher perfis de serviço de pipeline existentes**

     [Para ativar o provisionamento de pipelines gerenciado pela AWS] Na página **Definir configurações de conta**, na seção **Perfil do pipeline de provisionamento gerenciado pela AWS**, escolha **Perfil de serviço existente** e escolha um perfil de serviço em sua conta da AWS .

     [Para habilitar o CodeBuild provisionamento de pipelines] Na página **Configurar configurações da conta**, na seção **Função de aprovisionamento de CodeBuild pipeline, escolha Função** de **serviço existente e escolha uma função** de serviço em sua conta. AWS 

1. Escolha **Salvar alterações**.

   Seu novo perfil de serviço de pipeline é exibido na página de **configurações da conta**.

### Provisionamento autogerenciado—configure um repositório de pipeline.
<a name="setting-up-pr-repo"></a>

Com o [provisionamento autogerenciado](ag-works-prov-methods.md#ag-works-prov-methods-self), AWS Proton envia uma pull request (PR) para um repositório de provisionamento que você configurou, e seu código de automação é responsável pelo provisionamento de pipelines. Portanto, AWS Proton não precisa de uma função de serviço para provisionar pipelines. Em vez disso, ele precisa de um repositório de provisionamento registrado. Seu código de automação no repositório deve assumir um perfil apropriado que forneça permissões para o provisionamento de pipelines.

**Para registrar um repositório de provisionamento de pipeline usando o console**

1. Crie um repositório de provisionamento de CI/CD pipeline se você ainda não tiver criado um. Para obter mais informações sobre pipelines no provisionamento autogerenciado, consulte [Como funciona o provisionamento autogerenciado](ag-works-prov-methods.md#ag-works-prov-methods-self).

1. No painel de navegação, selecione **Configurações** e em seguida **Configurações de conta**.

1. Na página ** CI/CD Configurações da conta**, escolha **Configurar**.

1. Na página **Definir configurações da conta**, na seção **Repositório do pipeline de CI/CD**:

   1. Selecione **Novo repositório** e, em seguida, escolha um dos provedores de repositório.

   1. Para **CodeStar conexão**, escolha uma de suas conexões.
**nota**  
Se você ainda não tiver uma conexão com a conta do provedor de repositório relevante, escolha **Adicionar uma nova CodeStar conexão**, conclua o processo de criação da conexão e escolha o botão Atualizar ao lado do menu de **CodeStarconexão**. Agora você deve ser capaz de escolher sua nova conexão no menu.

   1. Em **Nome do repositório**, escolha seu repositório de provisionamento de pipeline. O menu suspenso mostra a lista de repositórios na conta do provedor.

   1. Em **Nome da ramificação**, escolha uma das ramificações do repositório.

1. Escolha **Salvar alterações**.

   Seu repositório de pipeline é exibido na página de **configurações da conta**.

## Configurando o AWS CLI
<a name="ag-setting-up-cli"></a>

Para usar o AWS CLI para fazer chamadas de AWS Proton API, verifique se você instalou a versão mais recente do AWS CLI. Para obter mais informações, consulte [Conceitos básicos do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) no *Manual do usuário do AWS Command Line Interface *. Em seguida, para começar a usar o AWS CLI with AWS Proton, consulte[Começando com o AWS CLI](ag-getting-started-cli.md).