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
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?
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 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.
-
-
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
$sam pipeline bootstrap<options>
Opções
--bitbucket-repo-uuidTEXT-
O UUID do repositório do Bitbucket. Essa opção é específica ao uso do Bitbucket OIDC para obter permissões.
nota
Esse valor pode ser encontrado em https://bitbucket.org/
workspace/repository/admin/addon/admin/pipelines/openid-connect --bucketTEXT-
O ARN do bucket Amazon S3 que contém os artefatos. AWS SAM
--cicd-providerTEXT-
A CI/CD plataforma para o AWS SAM gasoduto.
--cloudformation-execution-roleTEXT-
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-envTEXT-
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. --config-filePATH-
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.tomlna 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. --confirm-changeset | --no-confirm-changeset-
Solicite a confirmação da implantação de seus recursos.
--create-image-repository | --no-create-image-repository-
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-
Ativa o registro de depuração e imprime as mensagens de depuração que o AWS SAMCLI gera e para exibir timestamps.
--deployment-branchTEXT-
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-orgTEXT-
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-repoTEXT-
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-groupTEXT-
O GitLab grupo ao qual o repositório pertence. Essa opção é específica para usar o GitLab OIDC para obter permissões.
--gitlab-projectTEXT-
O nome GitLab do projeto. Essa opção é específica para usar o GitLab OIDC para obter permissões.
--help, -h-
Mostra esta mensagem e sai.
--image-repositoryTEXT-
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-repositoryserão ignoradas. Se não for fornecido e--create-image-repositoryfor especificado, o comando cria um. --interactive | --no-interactive-
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.nota
Se
--no-interactivefor especificado junto com--use-oidc-provider, todos os parâmetros necessários para seu provedor de OIDC devem ser incluídos. --oidc-client-idTEXT-
O ID do cliente configurado para uso com seu provedor OIDC.
--oidc-provider[github-actions | gitlab | bitbucket-pipelines]-
Nome do CI/CD provedor que será usado para permissões do OIDC. GitLab GitHub, e o Bitbucket são compatíveis.
--oidc-provider-urlTEXT-
O URL do provedor de OIDC. O valor deve começar com
https://. --permissions-provider[oidc | iam]-
Escolha um provedor de permissões para assumir a função de execução do pipeline. O valor padrão é
iam. --pipeline-execution-roleTEXT-
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-userTEXT-
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.
--profileTEXT-
O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.
--regionTEXT-
A AWS região para a qual implantar. Por exemplo, .
us-east-1 --save-params-
Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.
--stageTEXT-
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
Erro: Falta o parâmetro necessário
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
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
