sam deploy

Defina a variável de SAM_CLI_POLL_DELAY ambiente com um valor de segundos em seu shell para configurar com que frequência a CLI do AWS SAM verifica o estado da AWS CloudFormation pilha, o que é útil ao ver a limitação de. AWS CloudFormation Essa variável de ambiente é usada para a sondagem de chamadas de API describe_stack, que são feitas durante a execução de sam deploy.

Veja um exemplo dessa variável:

$ SAM_CLI_POLL_DELAY=5 sam deploy

Uma lista de recursos que você deve especificar para permitir AWS CloudFormation a criação de determinadas pilhas. Alguns modelos de pilha podem incluir recursos que afetam suas permissões Conta da AWS, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para essas pilhas, você deve confirmar explicitamente seus recursos especificando esse opção. Os únicos valores válidos são CAPABILITY_IAM e CAPABILITY_NAMED_IAM. Se você tiver recursos do IAM, então poderá especificar qualquer recurso. Se tiver recursos do IAM com nomes personalizados, então você deverá especificar CAPABILITY_NAMED_IAM. Se você não especificar essa opção, a operação retornará um erro InsufficientCapabilities.

Ao implantar um aplicativo que contém aplicativos aninhados, você deve usar CAPABILITY_AUTO_EXPAND para reconhecer que o aplicativo contém aplicativos aninhados. Para obter mais informações, consulte Implantar aplicativos aninhados.

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 AWS SAM CLI Arquivo de configuração do  .

O caminho e o nome do arquivo de configuração contendo 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 AWS SAM CLI Arquivo de configuração do  .

Solicite a confirmação se o AWS SAMCLI implanta o conjunto de alterações computado.

Ative o registro de depuração para imprimir a mensagem de depuração que o AWS SAMCLI gera e para exibir timestamps.

Especifique se deseja reverter sua AWS CloudFormation pilha se ocorrer um erro durante uma implantação. Por padrão, se houver um erro durante uma implantação, sua AWS CloudFormation pilha voltará ao último estado estável. Se você especificar --disable-rollback e ocorrer um erro durante uma implantação, os recursos que foram criados ou atualizados antes da ocorrência do erro não serão revertidos.

Especifique se deseja retornar um código de saída diferente de zero se não houver alterações a serem feitas na pilha. O comportamento padrão é retornar um código de saída diferente de zero.

Especifique essa opção para fazer upload de artefatos, mesmo que eles correspondam aos artefatos existentes no bucket do Amazon S3. Os artefatos correspondentes são sobrescritos.

Especifique essa opção para que o AWS SAMCLI use prompts que o guiem durante a implantação.

Mostre esta mensagem e saia.

Um mapeamento de funções para o URI do repositório Amazon ECR. Funções de referência por meio de sua ID lógica. Veja um exemplo a seguir:

$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo

Você pode especificar esta opção várias vezes em um único comando.

O nome do repositório Amazon ECR em que esse comando carrega a imagem da sua função. Essa opção é necessária para funções declaradas com o tipo de pacote Image.

O ID de uma chave AWS Key Management Service (AWS KMS) usada para criptografar artefatos que estão em repouso no bucket do Amazon S3. Se você não especificar essa opção, AWS SAM use as chaves de criptografia gerenciadas pelo Amazon S3.

Um mapa de metadados para anexar a todos os artefatos referenciados em seu modelo.

Indica se o conjunto de alterações deve ser aplicado. Especifique essa opção se quiser visualizar as alterações da pilha antes de aplicar o conjunto de alterações. Esse comando cria um conjunto de alterações AWS CloudFormation e, em seguida, sai sem aplicar o conjunto de alterações. Para aplicar o conjunto de alterações, execute o mesmo comando sem essa opção.

Não exiba uma barra de progresso ao fazer o upload de artefatos para o Amazon S3.

Uma lista dos ARNs tópicos AWS CloudFormation do Amazon Simple Notification Service (Amazon SNS) associados à pilha.

Especifique a ação a ser tomada quando uma pilha falhar na criação.

As seguintes opções estão disponíveis:

O comportamento padrão é ROLLBACK.

Uma string que contém substituições de AWS CloudFormation parâmetros codificadas como pares de valores-chave. Cada substituição usa o formatoParameterKey=name,ParameterValue=value. Várias substituições são separadas por espaços. Veja dois exemplos a seguir:

$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2

$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana

O perfil específico do seu arquivo de credenciais que obtém as AWS credenciais.

O Região da AWS para implantar. Por exemplo, us-east-1.

Crie automaticamente repositórios do Amazon ECR para uso no empacotamento e implantação em implantações não guiadas. Esta opção se aplica apenas às funções e camadas com o PackageType: Image especificado. Se você especificar a opção --guided, então o AWS SAMCLI ignora o --resolve-image-repos.

Crie automaticamente um bucket do Amazon S3 para uso no empacotamento e implantação em implantações não guiadas. Se você especificar a opção --guided, então a CLI AWS SAM ignora o --resolve-s3. Se você especificar as opções --s3-bucket e --resolve-s3, ocorrerá um erro.

O Amazon Resource Name (ARN) de uma função do IAM que é AWS CloudFormation assumida ao aplicar o conjunto de alterações.

O nome do bucket do Amazon S3 em que esse comando carrega seu modelo. AWS CloudFormation Se seu modelo for maior que 51.200 bytes, a opção --s3-bucket ou a opção --resolve-s3 serão obrigatórias. Se você especificar as opções --s3-bucket e --resolve-s3, ocorrerá um erro.

O prefixo adicionado aos nomes dos artefatos que são enviados ao bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3.

Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

A lista de perfis de assinatura com os quais assinar seus pacotes de implantação. Essa opção usa uma lista de pares de valores-chave, em que a chave é o nome da função ou camada a ser assinada e o valor é o perfil de assinatura, com um proprietário de perfil opcional delimitado por :. Por exemplo, FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner.

(Obrigatório) O nome da AWS CloudFormation pilha na qual você está implantando. Se você especificar uma pilha existente, o comando atualizará a pilha. Se você especificar uma nova pilha, o comando a criará.

Uma lista de tags a serem associadas à pilha criada ou atualizada. AWS CloudFormation também propaga essas tags para recursos na pilha que as suportam.

O caminho e o nome do arquivo em que seu AWS SAM modelo está localizado.

JSON de saída para o AWS CloudFormation modelo. A saída padrão é YAML.