sam deploy

Opções para oAWS Serverless Application ModelInterface de linha de comando (AWS SAMCLIPE)sam deploycomando.

• Para uma introdução aoAWS SAMCLI, consulteO que é a AWS SAM CLI?.

• Para obter documentação sobre o uso doAWS SAMCLIsam deploycomando, consulteUsar o sam deploy.

Uso

$ sam deploy <options>

Variáveis de ambiente

Variável de ambiente	Descrição
SAM_CLI_POLL_DELAY	Especifique um atraso, em segundos, entreDescribeStackChamadas de API. Veja um exemplo a seguir. $ SAM_CLI_POLL_DELAY=5 sam deploy

Opções

Opção	Descrição
-g, --guided	Especifique essa opção para ter oAWS SAMA CLI usa prompts para guiá-lo durante a implantação.
-t, --template-file, --template PATH	O caminho e o nome do arquivo em que seuAWS SAMo modelo está localizado. Nota:Se você especificar essa opção, entãoAWS SAMimplanta somente o modelo e os recursos locais para os quais ele aponta.
--stack-name TEXT	(Obrigatório) O nome doAWS CloudFormationpilha 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á.
--s3-bucket TEXT	O nome do bucket do Amazon S3 em que esse comando carrega seuAWS CloudFormationmodelo. Se o seu modelo for maior que 51.200 bytes, então o--s3-bucketopção ou o--resolve-s3opção é necessária. Se você especificar ambos os--s3-buckete--resolve-s3opções e, em seguida, ocorre um erro.
--s3-prefix TEXT	O prefixo adicionado aos nomes dos artefatos que são enviados para o bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3.
--image-repository TEXT	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 oImagetipo de embalagem.
--image-repositories TEXT	Um mapeamento de funções para o URI do repositório Amazon ECR. Funções de referência por seu ID lógico. Veja um exemplo a seguir. $ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo Você pode especificar essa opção várias vezes em um único comando.
--signing-profiles LIST	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.
--capabilities LIST	Uma lista de recursos que você deve especificar para permitirAWS CloudFormationpara criar certas pilhas. Alguns modelos de pilha podem incluir recursos que afetam as permissões em seuConta da AWS, por exemplo, criando novosAWS Identity and Access ManagementUsuários (IAM). Para essas pilhas, você deve reconhecer explicitamente suas capacidades especificando essa opção. Os únicos valores válidos são CAPABILITY_IAM e CAPABILITY_NAMED_IAM. Se você tiver recursos do IAM, poderá especificar qualquer um dos recursos. Se você tiver recursos do IAM com nomes personalizados, deverá especificarCAPABILITY_NAMED_IAM. Se você não especificar essa opção, a operação retornará umInsufficientCapabilitieserro.
--region TEXT	ORegião da AWSpara implantar em. Por exemplo, us-east-1.
--profile TEXT	O perfil específico do seu arquivo de credenciais que recebeAWScredenciais.
--kms-key-id TEXT	O ID de umAWS Key Management Service(AWS KMS) chave usada para criptografar artefatos que estão em repouso no bucket do Amazon S3. Se você não especificar essa opção, entãoAWS SAMusa chaves de criptografia gerenciadas pelo Amazon S3.
--force-upload	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.
--no-execute-changeset	Indica se o conjunto de alterações deve ser aplicado. Especifique essa opção se quiser visualizar suas alterações na pilha antes de aplicar o conjunto de alterações. Esse comando cria umAWS CloudFormationchangeset e, em seguida, sai sem aplicar o changeset. Para aplicar o conjunto de alterações, execute o mesmo comando sem essa opção.
--role-arn TEXT	O Amazon Resource Name (ARN) de uma função do IAM queAWS CloudFormationpressupõe ao aplicar o conjunto de alterações.
--fail-on-empty-changeset | --no-fail-on-empty-changeset	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.
--confirm-changeset | --no-confirm-changeset	Solicite a confirmação de que oAWS SAMA CLI implanta o conjunto de alterações computado.
--use-json	JSON de saída para oAWS CloudFormationmodelo. A saída padrão é YAML.
--resolve-s3	Crie automaticamente um bucket do Amazon S3 para usar no empacotamento e na implantação em implantações não guiadas. Se você especificar o--guidedopção, depois oAWS SAMA CLI ignora--resolve-s3. Se você especificar ambos os--s3-buckete--resolve-s3opções e, em seguida, ocorre um erro.
--resolve-image-repos	Crie automaticamente repositórios do Amazon ECR para usar no empacotamento e na implantação em implantações não guiadas. Essa opção se aplica somente a funções e camadas comPackageType: Imageespecificado. Se você especificar o--guidedopção, depois oAWS SAMA CLI ignora--resolve-image-repos. Nota: SeAWS SAMcria automaticamente qualquer repositório Amazon ECR para funções ou camadas com essa opção e, posteriormente, você exclui essas funções ou camadas do seuAWS SAMmodelo e, em seguida, os repositórios correspondentes do Amazon ECR são excluídos automaticamente.
--metadata	Um mapa de metadados para anexar a todos os artefatos referenciados em seu modelo.
--notification-arns LIST	Uma lista de ARNs de tópicos do Amazon Simple Notification Service (Amazon SNS) queAWS CloudFormationassocia-se à pilha.
--tags LIST	Uma lista de tags a serem associadas à pilha que é criada ou atualizada.AWS CloudFormationtambém propaga essas tags para os recursos na pilha que as suportam.
--parameter-overrides	Uma string que contémAWS CloudFormationsubstituições de parâmetros codificadas como pares de valores-chave. Use o mesmo formato doAWS Command Line Interface(AWS CLI). Por exemplo, ParameterKey=ParameterValue InstanceType=t1.micro.
--disable-rollback | --no-disable-rollback	Especifique se deseja reverter seuAWS CloudFormationempilhe se ocorrer um erro durante uma implantação. Por padrão, se houver um erro durante uma implantação, seuAWS CloudFormationa pilha volta ao último estado estável. Se você especificar--disable-rollbacke ocorre um erro durante uma implantação, então os recursos que foram criados ou atualizados antes da ocorrência do erro não são revertidos.
--on-failure [ROLLBACK | DELETE | DO_NOTHING]	Especifique a ação a ser tomada quando uma pilha não for criada. As seguintes opções estão disponíveis: ROLLBACK— Reverte a pilha para um estado anterior em boas condições. DELETE— Reverte a pilha para um estado válido anterior, se existir. Caso contrário, exclui a pilha. DO_NOTHING— Não reverte nem exclui a pilha. O efeito é o mesmo que o de--disable-rollback. O comportamento padrão é ROLLBACK. Nota:Você pode especificar o--disable-rollbackopção ou o--on-failureopção, mas não ambas.
--config-file PATH	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.tomlna raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte AWS SAMArquivo de configuração CLI.
--config-env TEXT	O nome do ambiente que especifica os valores padrão dos parâmetros 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 SAMArquivo de configuração CLI.
--no-progressbar	Não exiba uma barra de progresso ao fazer upload de artefatos para o Amazon S3.
--debug	Ative o registro de depuração para imprimir a mensagem de depuração de que oAWS SAMA CLI gera e exibe carimbos de data/hora.
--help	Mostre essa mensagem e saia.