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

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

Esta página fornece informações de referência para o AWS Serverless Application Model `sam local pipeline bootstrap` subcomando Command Line Interface (AWS SAMCLI).

Para uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam pipeline bootstrap` subcomando gera os recursos de AWS infraestrutura necessários para se conectar ao seu sistema de CI/CD. Essa etapa deve ser executada em cada estágio de implantação em seu pipeline antes de executar o comando **sam pipeline init**.

Esse subcomando configura os seguintes recursos de AWS infraestrutura:
+ Opção de configurar as permissões do pipeline por meio de:
  + Um usuário do pipeline IAM com ID da chave de acesso e credenciais de acesso à chave secreta a serem compartilhadas com o CI/CD sistema.
**nota**  
Recomendamos alternar as chaves de acesso regularmente. Para obter mais informações, consulte [Alterne as chaves de acesso regularmente para casos de uso que exijam credenciais de longo prazo](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) no *Guia do usuário do IAM*.
  +  CI/CD Plataformas suportadas por meio do OIDC. Para uma introdução sobre o uso do OIDC com pipeline AWS SAM , vá para [Como usar a autenticação OIDC com pipelines AWS SAM](deploying-with-oidc.md).
+ Uma função CloudFormation de execução do IAM assumida pela CloudFormation para implantar o AWS SAM aplicativo.
+ Um bucket Amazon S3 para armazenar os AWS SAM artefatos.
+ Opcionalmente, um repositório de imagens do Amazon ECR para armazenar pacotes de implantação Lambda de imagens de contêiner (se você tiver um recurso do tipo de pacote `Image`).

## Usage
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Opções
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 O UUID do repositório do Bitbucket. Essa opção é específica ao uso do Bitbucket OIDC para obter permissões.  
Esse valor pode ser encontrado em https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
O ARN do bucket Amazon S3 que contém os artefatos. AWS SAM 

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
A CI/CD plataforma para o AWS SAM gasoduto.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
O ARN da função do IAM a ser assumida CloudFormation durante a implantação da pilha do aplicativo. Forneça somente se quiser usar sua própria função. Caso contrário, o comando criará uma nova função.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é **default**. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo os valores de parâmetros padrão a serem usados. O valor padrão é `samconfig.toml` na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Solicite a confirmação da implantação de seus recursos.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Especifique se deseja criar um repositório de imagens do Amazon ECR se nenhum for fornecido. O repositório Amazon ECR contém as imagens de contêiner das funções do Lambda, ou camadas com um tipo de pacote de `Image`. O padrão é `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Ativa o registro de depuração e imprime as mensagens de depuração que o AWS SAMCLI gera e para exibir timestamps.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nome da filial a partir da qual as implantações ocorrerão. Essa opção é específica para usar GitHub Ações OIDC para obter permissões.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
A GitHub organização à qual o repositório pertence. Se nenhuma organização existir, insira o nome de usuário do proprietário do repositório. Essa opção é específica para usar GitHub Ações OIDC para obter permissões.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nome do GitHub repositório a partir do qual as implantações ocorrerão. Essa opção é específica para usar GitHub Ações OIDC para obter permissões.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
O GitLab grupo ao qual o repositório pertence. Essa opção é específica para usar o GitLab OIDC para obter permissões.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
O nome GitLab do projeto. Essa opção é específica para usar o GitLab OIDC para obter permissões.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Mostra esta mensagem e sai.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
O ARN de um repositório de imagens do Amazon ECR que contém as imagens de contêiner das funções do Lambda, ou camadas que têm um tipo de pacote de `Image`. Se fornecidas, as opções `--create-image-repository` serão ignoradas. Se não for fornecido e `--create-image-repository` for especificado, o comando cria um.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Desative a solicitação interativa para parâmetros de bootstrap e falhe se algum parâmetro necessário estiver ausente. O valor padrão é `--interactive`. Para esse comando, `--stage` é o único parâmetro obrigatório.  
Se `--no-interactive` for especificado junto com `--use-oidc-provider`, todos os parâmetros necessários para seu provedor de OIDC devem ser incluídos.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
O ID do cliente configurado para uso com seu provedor OIDC.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nome do CI/CD provedor que será usado para permissões do OIDC. GitLab GitHub, e o Bitbucket são compatíveis.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
O URL do provedor de OIDC. O valor deve começar com **https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Escolha um provedor de permissões para assumir a função de execução do pipeline. O valor padrão é **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
O ARN do perfil do IAM a ser assumida pelo usuário do pipeline para operar nesse estágio. Forneça somente se quiser usar sua própria função. Se não for fornecido, esse comando criará uma nova função.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
O Amazon Resource Name (ARN) do usuário do IAM com o ID da chave de acesso e a chave de acesso secreta compartilhados com o CI/CD sistema. Ele é usado para conceder permissão a esse usuário do IAM para acessar a AWS conta correspondente. Se não for fornecido, o comando criará um usuário do IAM junto com o ID da chave de acesso e as credenciais da chave de acesso secreta.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
A AWS região para a qual implantar. Por exemplo, .`us-east-1`

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
O nome do estágio de implantação correspondente. Ele é usado como um sufixo para os recursos de AWS infraestrutura criados.

## Solução de problemas
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Erro: Falta o parâmetro necessário
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Quando `--no-interactive` for especificado junto com `--use-oidc-provider` e nenhum dos parâmetros necessários for fornecido, essa mensagem de erro será exibida junto com uma descrição dos parâmetros ausentes.

## Exemplo
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

O exemplo a seguir cria os AWS recursos necessários para criar seu CI/CD sistema, ativa o registro de depuração e imprime mensagens de depuração geradas pelo AWS SAMCLI: usa um evento gerado para testes locais usando um evento para invocar uma função `s3.json` Lambda localmente.

```
$ sam pipeline bootstrap --debug
```