sam package

A interface de linha de AWS Serverless Application Model comando (AWS SAM CLI) empacota um AWS SAM aplicativo.

Esse comando cria um .zip arquivo com seu código e dependências e carrega o arquivo no Amazon Simple Storage Service (Amazon S3). AWS SAM ativa a criptografia para todos os arquivos armazenados no Amazon S3. Em seguida, ele retorna uma cópia do seu AWS SAM modelo, substituindo as referências aos artefatos locais pela localização do Amazon S3 em que o comando carregou os artefatos.

Por padrão, quando você usa esse comando, AWS SAMCLI pressupõe que seu diretório de trabalho atual seja o diretório raiz do seu projeto. O AWS SAMCLI primeiro tenta localizar um arquivo de modelo criado usando o sam build comando, localizado na .aws-sam subpasta e nomeadotemplate.yaml. Em seguida, o AWS SAMCLI tenta localizar um arquivo de modelo chamado template.yaml ou template.yml no diretório de trabalho atual. Se você especificar a --template opção, o comportamento padrão AWS SAMCLI do modelo será substituído e empacotará apenas esse AWS SAM modelo e os recursos locais para os quais ele aponta.

nota

sam deploy agora executa implicitamente a funcionalidade do sam package. Você pode usar o sam deploy comando diretamente para empacotar e implantar sua aplicação.

Uso

$ sam package <arguments> <options>

Argumentos

ID do recurso

O ID da função do Lambda para empacotar.

Esse argumento é opcional. Se seu aplicativo contiver uma única função Lambda, a AWS SAM CLI a empacotará. Se seu aplicativo contiver várias funções, forneça o ID da função para empacotar uma única função.

Valores válidos: o ID lógico do recurso ou o ARN do recurso.

Opções

--config-env TEXT

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 é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte Arquivo de configuração do AWS SAM CLI.

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

--debug

Ativa o registro de depuração para imprimir a mensagem de depuração gerada pelo AWS SAMCLI e exibir timestamps.

--force-upload

Substituir arquivos existentes no bucket do Amazon S3. Especifique essa bandeira para fazer upload de artefatos, mesmo que eles correspondam aos artefatos existentes no bucket do Amazon S3.

--help

Mostra esta mensagem e sai.

--image-repository TEXT

O URI do repositório do Amazon Elastic Container Registry (Amazon ECR) onde esse comando faz upload da imagem da função. Necessário para funções declaradas com o tipo de pacote Image.

--kms-key-id TEXT

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 essa opção não for especificada, AWS SAM usará as chaves de criptografia gerenciadas pelo Amazon S3.

--metadata

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

--no-progressbar

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

--output-template-file PATH

O caminho para o arquivo em que o comando grava o modelo empacotado. Se você não especificar um caminho, o comando gravará o modelo na saída padrão.

--profile TEXT

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

--region TEXT

A AWS região para a qual implantar. Por exemplo, us-east-1.

--resolve-s3

Crie automaticamente um bucket do Amazon S3 para usar na embalagem. Se você especificar as opções --s3-bucket e --resolve-s3, ocorrerá um erro.

--s3-bucket TEXT

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

--s3-prefix TEXT

Prefixo adicionado ao nome do artefato que é carregado para o bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3. Isso só se aplica às funções declaradas com o tipo de Zip pacote.

--save-params

Salve os parâmetros fornecidos na linha de comando no arquivo AWS SAM de configuração.

--signing-profiles LIST

(Opcional) A lista de perfis de assinatura com os quais assinar seus pacotes de implantação. Esse parâmetro 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.

--template-file, --template, -t PATH

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

nota

Se você especificar essa opção, AWS SAM empacotará somente o modelo e os recursos locais para os quais ele aponta.

--use-json

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