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á. # Como AWS Proton funciona Com AWS Proton, você provisiona *ambientes* e, em seguida, *serviços* executados nesses ambientes. Ambientes e serviços são baseados em *modelos* de ambiente e serviço, respectivamente, que você escolhe em sua biblioteca de modelos AWS Proton versionados. ![\[Um diagrama que descreve um processo de como criar um pacote de modelos para um conjunto de recursos de AWS Proton infraestrutura.\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/works.png) ![\[Red circle with the number 1 inside, typically used as a notification icon.\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/label-one.png)Quando você, como administrador, seleciona um modelo de ambiente com AWS Proton, você fornece valores para os *parâmetros de entrada* necessários. ![\[Number 2 icon in a pink circle.\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/label-two.png) AWS Proton usa o modelo do ambiente e os valores dos parâmetros para provisionar seu ambiente. ![\[Pink square icon with a white exclamation mark inside a circle.\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/label-three.png)Quando você, como desenvolvedor ou administrador, seleciona um modelo de serviço com AWS Proton, você fornece valores para os parâmetros de entrada necessários. Você também seleciona um ambiente para implantar sua aplicação ou serviço. ![\[Number 4 in a red circle icon, commonly used to indicate a notification count.\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/label-four.png) AWS Proton usa o modelo de serviço e os valores dos parâmetros do seu serviço e do ambiente selecionado para provisionar seu serviço. Você fornece valores para os parâmetros de entrada para personalizar seu modelo para reutilização e vários casos de uso, aplicações ou serviços. Para fazer isso funcionar, você cria pacotes de modelos de ambiente ou serviço e os carrega em modelos de ambiente ou serviço registrados, respectivamente. Os [pacotes de modelos](ag-template-authoring.md#ag-template-bundles) contêm tudo o que é AWS Proton necessário para provisionar ambientes ou serviços. Quando você cria um modelo de ambiente ou de serviço, você envia um pacote de modelos que contém os arquivos parametrizados de infraestrutura como código (IaC) que o AWS Proton usa para provisionar ambientes ou serviços. Ao selecionar um modelo de ambiente ou serviço para criar ou atualizar um ambiente ou serviço, você fornece valores para os parâmetros do arquivo IaC do pacote de modelos. **Topics** + [AWS Proton objetos](ag-works-objects.md) + [Como AWS Proton provisiona a infraestrutura](ag-works-prov-methods.md) + [AWS Proton terminologia](terminology.md) # AWS Proton objetos O diagrama a seguir mostra os AWS Proton objetos principais e sua relação com outros objetos AWS e objetos de terceiros. As setas representam a direção do fluxo de dados (a direção inversa da dependência). Seguimos o diagrama com breves descrições e links de referência para esses AWS Proton objetos. ![\[Diagrama ilustrando o AWS provisionamento gerenciado em AWS Proton\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/object-diagram.png) + **Modelo de ambiente**: Uma coleção de versões de modelo de ambiente que podem ser usadas para criar ambientes do AWS Proton . Para obter mais informações, consulte [Criação e pacotes de modelos](ag-template-authoring.md) e [AWS Proton modelos](ag-templates.md). + **Versão do modelo de ambiente**: Uma versão específica de um modelo de ambiente. Usa um *pacote de modelos* como entrada, seja de um bucket do S3 ou de um repositório Git. O pacote especifica a Infraestrutura como Código (IaC) e os parâmetros de entrada relacionados para um ambiente. AWS Proton Para ter mais informações, consulte [Modelos versionados](ag-template-versions.md), [Registre e publique modelos](template-create.md) e [Configurações de sincronização de modelo](ag-template-sync-configs.md). + **Ambiente** — O conjunto de recursos de AWS infraestrutura compartilhada e políticas de acesso em que AWS Proton os serviços são implantados. AWS os recursos são provisionados usando uma versão de modelo de ambiente invocada com valores de parâmetros específicos. As políticas de acesso são fornecidas em um perfil de serviço. Para obter mais informações, consulte [AWS Proton ambientes](ag-environments.md). + **Modelo de serviço**: Uma coleção de versões de modelo de serviço que podem ser usadas para criar serviços do AWS Proton . Para obter mais informações, consulte [Criação e pacotes de modelos](ag-template-authoring.md) e [AWS Proton modelos](ag-templates.md). + **Versão de modelo de serviço**: Uma versão específica de um modelo de serviço. Usa um *pacote de modelos* como entrada, seja de um bucket do S3 ou de um repositório Git. O pacote especifica a Infraestrutura como Código (IaC) e os parâmetros de entrada relacionados para um serviço. AWS Proton Uma versão do modelo de serviço também especifica essas restrições nas instâncias de serviço com base na versão: + **Modelos de ambiente compatíveis**: As instâncias só podem ser executadas em ambientes baseados nesses modelos de ambiente compatíveis. + **Fontes de componentes compatíveis**: Os tipos de componentes que os desenvolvedores podem associar às instâncias. Para ter mais informações, consulte [Modelos versionados](ag-template-versions.md), [Registre e publique modelos](template-create.md) e [Configurações de sincronização de modelo](ag-template-sync-configs.md). + **Serviço** — Uma coleção de instâncias de serviço que executam um aplicativo usando recursos especificados em um modelo de serviço e, opcionalmente, um CI/CD pipeline que implanta o código do aplicativo nessas instâncias. No diagrama, a linha tracejada do **modelo de serviço** significa que o serviço passa o modelo para as instâncias de serviço e para o pipeline. Para obter mais informações, consulte [AWS Proton serviços](ag-services.md). + **Instância de serviço** — O conjunto de recursos de AWS infraestrutura que executam um aplicativo em um AWS Proton ambiente específico. AWS os recursos são provisionados usando uma versão do modelo de serviço invocada com valores de parâmetros específicos. Para obter mais informações, consulte [AWS Proton serviços](ag-services.md) e [Atualize uma instância de serviço](ag-svc-instance-update.md). + **Pipeline** — Um CI/CD pipeline opcional que implanta um aplicativo nas instâncias de um serviço, com políticas de acesso para provisionar esse pipeline. As políticas de acesso são fornecidas em um perfil de serviço. Um serviço nem sempre tem um AWS Proton pipeline associado. Você pode optar por gerenciar suas implantações de código de aplicativo fora dele. AWS Proton No diagrama, a linha tracejada de **Service** e a caixa tracejada ao redor do **Pipeline** significam que, se você optar por gerenciar suas CI/CD implantações sozinho, o AWS Proton pipeline pode não ser criado e seu próprio pipeline pode não estar em sua conta. AWS Para obter mais informações, consulte [AWS Proton serviços](ag-services.md) e [Atualizar um pipeline de serviço](ag-svc-pipeline-update.md). + **Componente**: Uma extensão definida pelo desenvolvedor para uma instância de serviço. Especifica recursos adicionais de AWS infraestrutura que um aplicativo específico pode precisar, além dos recursos fornecidos pelo ambiente e pela instância do serviço. As equipes de plataforma controlam a infraestrutura que um componente pode provisionar ao atribuir um perfil de componente ao ambiente. Para obter mais informações, consulte [AWS Proton componentes](ag-components.md). # Como AWS Proton provisiona a infraestrutura AWS Proton pode provisionar a infraestrutura de várias maneiras: + **AWS-provisionamento gerenciado** — AWS Proton chama o mecanismo de provisionamento em seu nome. Esse método oferece suporte somente a pacotes de modelos do AWS CloudFormation . Para obter mais informações, consulte [CloudFormation Arquivos IaC](ag-infrastructure-tmp-files-cloudformation.md). + **CodeBuild provisionamento** — AWS Proton usa AWS CodeBuild para executar comandos de shell fornecidos por você. Seus comandos podem ler as entradas que AWS Proton fornecem e são responsáveis por provisionar ou desprovisionar a infraestrutura e gerar valores de saída. Um pacote de modelos para esse método inclui seus comandos em um arquivo de manifesto e quaisquer programas, scripts ou outros arquivos que esses comandos possam precisar. Como exemplo do uso do CodeBuild provisionamento, você pode incluir um código que usa o AWS Cloud Development Kit (AWS CDK) para provisionar AWS recursos e um manifesto que instala o CDK e executa seu código CDK. Para obter mais informações, consulte [CodeBuild pacote de modelos de provisionamento](ag-infrastructure-tmp-files-codebuild.md). **nota** Você pode usar o CodeBuild provisionamento com ambientes e serviços. No momento, você não pode provisionar componentes dessa forma. + **Provisionamento autogerenciado** — AWS Proton emite uma pull request (PR) para um repositório que você fornece, onde seu próprio sistema de implantação de infraestrutura executa o processo de provisionamento. Esse método oferece suporte somente a pacotes de modelos do Terraform. Para obter mais informações, consulte [Arquivos Terraform IaC](ag-infrastructure-tmp-files-terraform.md). AWS Proton determina e define o método de provisionamento para cada ambiente e serviço separadamente. Quando você cria ou atualiza um ambiente ou serviço, o AWS Proton examina o pacote de modelos que você fornece e determina o método de provisionamento indicado pelo pacote de modelos. No nível do ambiente, você fornece os parâmetros que o ambiente e seus possíveis serviços podem precisar para seus métodos de provisionamento — funções AWS Identity and Access Management (IAM), uma conexão de conta de ambiente ou um repositório de infraestrutura. Os desenvolvedores que costumam AWS Proton provisionar um serviço têm a mesma experiência, independentemente do método de provisionamento. Os desenvolvedores não precisam conhecer o método de provisionamento e não precisam alterar nada no processo de provisionamento de serviços. O modelo de serviço define o método de provisionamento, e cada ambiente no qual um desenvolvedor implanta o serviço fornece os parâmetros necessários para o provisionamento da instância de serviço. O diagrama a seguir resume algumas características principais dos diferentes métodos de provisionamento. As seções que seguem a tabela fornecem detalhes sobre cada método. | Método de provisionamento | Modelos | Provisionado por | Status rastreado por | | --- | --- | --- | --- | | Gerenciado pela AWS | manifesto, esquema, arquivo IaC () CloudFormation | AWS Proton (por meio de CloudFormation) | AWS Proton (por meio de CloudFormation) | | CodeBuild | manifesto (com comandos), esquema, dependências de comando (por exemplo AWS CDK , código) | AWS Proton (por meio de CodeBuild) | AWS Proton (seus comandos retornam o status por meio de CodeBuild) | | autogerenciado | manifesto, esquema, arquivos IaC (Terraform) | Seu código (por meio de ações do Git) | Seu código (passado AWS por meio de uma chamada de API) | ## Como funciona o provisionamento AWS gerenciado Quando um ambiente ou serviço usa provisionamento AWS gerenciado, a infraestrutura é provisionada da seguinte forma: 1. Um AWS Proton cliente (administrador ou desenvolvedor) cria o AWS Proton recurso (um ambiente ou um serviço). O cliente seleciona um modelo para o recurso e fornece os parâmetros necessários. Para obter mais informações, consulte a seção [Considerações sobre o provisionamento AWS gerenciado](#ag-works-prov-methods-direct-consider) a seguir. 1. AWS Proton renderiza um CloudFormation modelo completo para provisionar o recurso. 1. AWS Proton chamadas CloudFormation para iniciar o provisionamento usando o modelo renderizado. 1. AWS Proton monitora continuamente a CloudFormation implantação. 1. Quando o provisionamento é concluído, AWS Proton reporta os erros em caso de falha e captura as saídas do provisionamento, como o Amazon VPC ID, em caso de sucesso. O diagrama a seguir mostra AWS Proton que ele executa a maioria dessas etapas diretamente. ![\[Diagrama ilustrando o AWS provisionamento gerenciado em AWS Proton\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/provisioning-direct.png) ### Considerações sobre o provisionamento AWS gerenciado + *Função de provisionamento de infraestrutura* — Quando um ambiente ou qualquer uma das instâncias de serviço em execução nele pode usar o provisionamento AWS gerenciado, um administrador precisa configurar uma função do IAM (diretamente ou como parte de uma AWS Proton conexão de conta do ambiente). AWS Proton usa essa função para provisionar a infraestrutura desses recursos de provisionamento AWS gerenciados. A função deve ter permissões de uso CloudFormation para criar todos os recursos que os modelos desses recursos incluem. Para obter mais informações, consulte [Perfis do IAM](ag-environment-roles.md) e [AWS Proton Exemplos de políticas de função de serviço do IAM](security_iam_service-role-policy-examples.md). + *Provisionamento de serviços* — Quando um desenvolvedor implanta uma instância de serviço que usa provisionamento AWS gerenciado no ambiente, AWS Proton usa a função fornecida a esse ambiente para provisionar a infraestrutura para a instância de serviço. Os desenvolvedores não veem esse perfil e não podem alterá-lo. + *Serviço com pipeline* — Um modelo de serviço que usa provisionamento AWS gerenciado pode incluir uma definição de pipeline escrita no esquema YAML. CloudFormation AWS Proton também cria o pipeline chamando CloudFormation. A função AWS Proton usada para criar um pipeline é separada da função de cada ambiente individual. Essa função é fornecida AWS Proton separadamente, apenas uma vez no nível da AWS conta, e é usada para provisionar e gerenciar todos os pipelines AWS gerenciados. Esse perfil deve ter permissões para criar pipelines e outros recursos de que seus pipelines precisam. Os procedimentos a seguir mostram como fornecer o perfil de pipeline para o AWS Proton. ------ #### [ AWS Proton console ] **Para fornecer o perfil do pipeline** 1. No [console do AWS Proton](https://console.aws.amazon.com//proton/), no painel de navegação, escolha **Configurações > Configurações da conta** e, em seguida, escolha **Configurar**. 1. Use a seção **Função AWS gerenciada por pipeline para configurar uma função** de pipeline nova ou existente para provisionamento AWS gerenciado. ------ #### [ AWS Proton API ] **Para fornecer o perfil do pipeline** 1. Use a ação [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)da API. 1. Forneça o nome do recurso da Amazon (ARN) do seu perfil de serviço de pipeline no parâmetro do `pipelineServiceRoleArn`. ------ #### [ AWS CLI ] **Para fornecer o perfil do pipeline** Execute o seguinte comando: ``` $ aws proton update-account-settings \ --pipeline-service-role-arn \ "arn:aws:iam::123456789012:role/my-pipeline-role" ``` ------ ## Como funciona o CodeBuild provisionamento Quando um ambiente ou serviço usa CodeBuild provisionamento, a infraestrutura é provisionada da seguinte forma: 1. Um AWS Proton cliente (administrador ou desenvolvedor) cria o AWS Proton recurso (um ambiente ou um serviço). O cliente seleciona um modelo para o recurso e fornece os parâmetros necessários. Para obter mais informações, consulte a seção [Considerações sobre o CodeBuild provisionamento](#ag-works-prov-methods-codebuild-consider) a seguir. 1. AWS Proton renderiza um arquivo de entrada com valores de parâmetros de entrada para provisionar o recurso. 1. AWS Proton chamadas CodeBuild para começar um trabalho. O CodeBuild trabalho executa os comandos do shell do cliente especificados no modelo. Esses comandos provisionam a infraestrutura desejada e, opcionalmente, leem os valores de entrada. 1. Quando o provisionamento é concluído, o comando final do cliente retorna o status do provisionamento CodeBuild e chama a ação da [NotifyResourceDeploymentStatusChange](https://docs.aws.amazon.com/proton/latest/APIReference/API_NotifyResourceDeploymentStatusChange.html) AWS Proton API para fornecer resultados, como o Amazon VPC ID, se houver. **Importante** Certifique-se de que seus comandos retornem corretamente o status de provisionamento CodeBuild e forneçam as saídas. Caso contrário, AWS Proton não conseguirão rastrear adequadamente o status do provisionamento e não poderão fornecer resultados corretos para as instâncias de serviço. O diagrama a seguir ilustra as etapas que são AWS Proton executadas e as etapas que seus comandos executam em uma CodeBuild tarefa. ![\[Diagrama ilustrando o provisionamento CodeBuild baseado em AWS Proton\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/provisioning-codebuild.png) ### Considerações sobre o CodeBuild provisionamento + *Função de provisionamento de infraestrutura* — Quando um ambiente ou qualquer uma das instâncias de serviço em execução nele pode usar o provisionamento CodeBuild baseado, um administrador precisa configurar uma função do IAM (diretamente ou como parte de uma conexão de conta do AWS Proton ambiente). AWS Proton usa essa função para provisionar a infraestrutura desses recursos de CodeBuild provisionamento. A função deve ter permissões de uso CodeBuild para criar todos os recursos que seus comandos nos modelos desses recursos fornecem. Para obter mais informações, consulte [Perfis do IAM](ag-environment-roles.md) e [AWS Proton Exemplos de políticas de função de serviço do IAM](security_iam_service-role-policy-examples.md). + *Provisionamento de serviços* — Quando um desenvolvedor implanta uma instância de serviço que usa CodeBuild provisionamento no ambiente, AWS Proton usa a função fornecida a esse ambiente para provisionar a infraestrutura para a instância de serviço. Os desenvolvedores não veem esse perfil e não podem alterá-lo. + *Serviço com pipeline* — Um modelo de serviço que usa CodeBuild provisionamento pode incluir comandos para provisionar um pipeline. AWS Proton também cria o pipeline chamando CodeBuild. A função AWS Proton usada para criar um pipeline é separada da função de cada ambiente individual. Essa função é fornecida AWS Proton separadamente, apenas uma vez no nível da AWS conta, e é usada para provisionar e gerenciar todos os pipelines CodeBuild baseados. Esse perfil deve ter permissões para criar pipelines e outros recursos de que seus pipelines precisam. Os procedimentos a seguir mostram como fornecer o perfil de pipeline para o AWS Proton. ------ #### [ AWS Proton console ] **Para fornecer o perfil do pipeline** 1. No [console do AWS Proton](https://console.aws.amazon.com//proton/), no painel de navegação, escolha **Configurações > Configurações da conta** e, em seguida, escolha **Configurar**. 1. Use a seção **Função de provisionamento de pipeline do Codebuild para configurar uma função** de pipeline nova ou existente para provisionamento. CodeBuild ------ #### [ AWS Proton API ] **Para fornecer o perfil do pipeline** 1. Use a ação [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)da API. 1. Forneça o nome do recurso da Amazon (ARN) do seu perfil de serviço de pipeline no parâmetro do `pipelineCodebuildRoleArn`. ------ #### [ AWS CLI ] **Para fornecer o perfil do pipeline** Execute o seguinte comando: ``` $ aws proton update-account-settings \ --pipeline-codebuild-role-arn \ "arn:aws:iam::123456789012:role/my-pipeline-role" ``` ------ ## Como funciona o provisionamento autogerenciado Quando um ambiente é configurado para usar provisionamento autogerenciado, a infraestrutura é provisionada da seguinte forma: 1. Um AWS Proton cliente (administrador ou desenvolvedor) cria o AWS Proton recurso (um ambiente ou um serviço). O cliente seleciona um modelo para o recurso e fornece os parâmetros necessários. Para um ambiente, o cliente também fornece um repositório de infraestrutura vinculado. Para obter mais informações, consulte a seção [Considerações sobre o provisionamento autogerenciado](#ag-works-prov-methods-self-consider) a seguir. 1. AWS Proton renderiza um modelo completo do Terraform. Ele consiste em um ou mais arquivos do Terraform, potencialmente em várias pastas, e um arquivo de `.tfvars` variáveis. AWS Proton grava os valores dos parâmetros fornecidos na chamada de criação do recurso nesse arquivo de variáveis. 1. AWS Proton envia um PR para o repositório de infraestrutura com o modelo renderizado do Terraform. 1. Quando o cliente (administrador ou desenvolvedor) mescla o PR, a automação do cliente aciona o mecanismo de provisionamento para iniciar o provisionamento da infraestrutura usando o modelo mesclado. **nota** Se o cliente (administrador ou desenvolvedor) fechar o PR, AWS Proton reconhecerá o PR como fechado e marcará a implantação como cancelada. 1. Quando o provisionamento é concluído, a automação do cliente chama a ação da [NotifyResourceDeploymentStatusChange](https://docs.aws.amazon.com/proton/latest/APIReference/API_NotifyResourceDeploymentStatusChange.html) AWS Proton API para indicar a conclusão, fornecer o status (sucesso ou falha) e fornecer resultados, como o Amazon VPC ID, se houver. **Importante** Certifique-se de que seu código de automação seja retornado AWS Proton com o status e as saídas do provisionamento. Caso contrário, AWS Proton considere o provisionamento pendente por mais tempo do que deveria e continue mostrando o status **Em andamento**. O diagrama a seguir ilustra as etapas que são AWS Proton executadas e as etapas que seu próprio sistema de provisionamento executa. ![\[Diagrama ilustrando o provisionamento autogerenciado em AWS Proton\]](http://docs.aws.amazon.com/pt_br/proton/latest/userguide/images/provisioning-self.png) ### Considerações sobre o provisionamento autogerenciado + *Repositório de infraestrutura* — Quando um administrador configura um ambiente para provisionamento autogerenciado, ele precisa fornecer um repositório de infraestrutura vinculado. AWS Proton se submete PRs a esse repositório para provisionar a infraestrutura do ambiente e todas as instâncias de serviço que são implantadas nele. A ação de automação de propriedade do cliente no repositório deve assumir uma função do IAM com permissões para criar todos os recursos que seus modelos de ambiente e serviço incluem e uma identidade que reflita a conta de destino. AWS Para ver um exemplo de GitHub ação que assume uma função, consulte [Assumindo uma função na documentação](https://github.com/aws-actions/configure-aws-credentials#assuming-a-role) *“Configurar AWS credenciais” da ação para GitHub ações.* + *Permissões* — Seu código de provisionamento precisa ser autenticado com uma conta conforme necessário (por exemplo, autenticar-se em uma AWS conta) e fornecer autorização de provisionamento de recursos (por exemplo, fornecer uma função). + *Provisionamento de serviços* — Quando um desenvolvedor implanta uma instância de serviço que usa provisionamento autogerenciado no ambiente, AWS Proton envia um PR ao repositório associado ao ambiente para provisionar a infraestrutura para a instância de serviço. Os desenvolvedores não veem o repositório e não podem alterá-lo. **nota** Os desenvolvedores que criam serviços usam o mesmo processo, independentemente do método de provisionamento, e a diferença é abstraída deles. No entanto, com o provisionamento autogerenciado, os desenvolvedores podem ter uma resposta mais lenta, porque precisam esperar até que alguém (que pode não ser eles mesmos) mescle o PR no repositório de infraestrutura antes que o provisionamento possa começar. + *Serviço com pipeline* — Um modelo de serviço para um ambiente com provisionamento autogerenciado pode incluir uma definição de pipeline (por exemplo, um AWS CodePipeline pipeline), escrita em Terraform HCL. AWS Proton Para permitir o provisionamento desses pipelines, um administrador fornece um repositório de pipeline vinculado a. AWS Proton Ao provisionar um pipeline, a ação de automação de propriedade do cliente no repositório deve assumir uma função do IAM com permissões para provisionar o pipeline e uma identidade que reflita a conta de destino. AWS O repositório e o perfil do pipeline são separados daqueles usados para cada ambiente individual. O repositório vinculado é fornecido AWS Proton separadamente, somente uma vez no nível da AWS conta, e é usado para provisionar e gerenciar todos os pipelines. O perfil deve ter permissões para criar pipelines e outros recursos de que seus pipelines precisam. Os procedimentos a seguir mostram como fornecer o repositório e o perfil de pipeline para o AWS Proton. ------ #### [ AWS Proton console ] **Para fornecer o perfil do pipeline** 1. No [console do AWS Proton](https://console.aws.amazon.com//proton/), no painel de navegação, escolha **Configurações > Configurações da conta** e, em seguida, escolha **Configurar**. 1. Use a seção de **repositório de pipeline de CI/CD** para configurar um link de repositório novo ou existente. ------ #### [ AWS Proton API ] **Para fornecer o perfil do pipeline** 1. Use a ação [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)da API. 1. Forneça o provedor, o nome e a ramificação do seu repositório de pipeline no parâmetro do `pipelineProvisioningRepository`. ------ #### [ AWS CLI ] **Para fornecer o perfil do pipeline** Execute o seguinte comando: ``` $ aws proton update-account-settings \ --pipeline-provisioning-repository \ "provider=GITHUB,name=my-pipeline-repo-name,branch=my-branch" ``` ------ + *Exclusão de recursos provisionados autogerenciados*: os módulos do Terraform podem incluir elementos de configuração necessários para a operação do Terraform, além das definições de recursos. Portanto, não é AWS Proton possível excluir todos os arquivos do Terraform de um ambiente ou instância de serviço. Em vez disso, AWS Proton marca os arquivos para exclusão e atualiza um sinalizador nos metadados do PR. Sua automação pode ler essa bandeira e usá-la para acionar um comando terraform destroy. # AWS Proton terminologia **Modelo de ambiente** Define a infraestrutura compartilhada, como um VPC ou cluster, que é usada por várias aplicações ou recursos. **Pacote de modelos de ambiente** Uma coleção de arquivos que você carrega para criar e registrar um modelo de ambiente no AWS Proton. Um pacote de modelos de ambiente contém o seguinte: 1. Um arquivo de esquema que define parâmetros de entrada de infraestrutura como código. 1. Um arquivo de infraestrutura como código (IaC) que define a infraestrutura compartilhada, como um VPC ou cluster, que é usada por várias aplicações ou recursos. 1. Um arquivo de manifesto que lista o arquivo IaC. **Environment** Infraestrutura compartilhada provisionada, como um VPC ou cluster, que é usada por várias aplicações ou recursos. **Modelo de serviço** Define o tipo de infraestrutura necessária para implantar e manter uma aplicação ou um microsserviço em um ambiente. **Pacote de modelos de serviço** Uma coleção de arquivos que você carrega para criar e registrar um modelo de serviço no AWS Proton. Um pacote de modelos de serviço contém o seguinte: 1. Um arquivo de esquema que define parâmetros de entrada de infraestrutura como código (Iac). 1. Um arquivo IaC que define a infraestrutura necessária para implantar e manter uma aplicação ou um microsserviço em um ambiente. 1. Um arquivo de manifesto que lista o arquivo IaC. 1. Opcional 1. Um arquivo IaC que define a infraestrutura do pipeline de serviços. 1. Um arquivo de manifesto que lista o arquivo IaC. **Serviço** A infraestrutura provisionada necessária para implantar e manter uma aplicação ou um microsserviço em um ambiente. **Instância de serviço** A infraestrutura que suporta uma aplicação ou um microsserviço em um ambiente. **Pipeline de serviço** Infraestrutura provisionada que dá suporte a um pipeline. **Versão do modelo** Uma versão principal ou secundária de um modelo. Para obter mais informações, consulte [Modelos versionados](ag-template-versions.md). **Parâmetros de entrada** Definido em um arquivo de esquema e usado em um arquivo de infraestrutura como código (IaC) para que o arquivo IaC possa ser usado de forma repetida e para uma variedade de casos de uso. **Arquivo de esquema** Define a infraestrutura como parâmetros de entrada de arquivo de código. **Arquivo de especificação** Especifica valores para infraestrutura como parâmetros de entrada do arquivo de código, conforme definido em um arquivo de esquema. **Arquivo manifesto** Lista uma infraestrutura como arquivo de código.