sam package - AWS Serverless Application Model
UsoArgumentosOpçõesExemplo

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 package

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

Esse comando cria um .zip arquivo do código e das dependências e faz upload do arquivo no Amazon Simple Storage Service (Amazon S3). AWS SAM permite a criptografia para todos os arquivos armazenados no Amazon S3. Depois, ele retorna uma cópia do modelo do AWS SAM, substituindo referências a artefatos locais pelo local do Amazon S3 onde o comando fez upload dos artefatos.

Por padrão, quando você usa esse comando, AWS SAM CLI pressupõe que seu diretório de trabalho atual seja o diretório raiz do seu projeto. O AWS SAM CLI primeiro tenta localizar um arquivo de modelo criado usando o comando sam build, localizado na .aws-sam subpasta e chamado template.yaml. Em seguida, o AWS SAM CLI tenta localizar um arquivo de modelo chamado template.yaml ou template.yml no diretório de trabalho atual. Se você especificar a opção --template, o comportamento padrão AWS SAM CLI do modelo será substituído e empacotará apenas esse modelo AWS SAM 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 do 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 SAM CLI 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 não for especificada essa opção, AWS SAM usará 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 credenciais da AWS.

--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 faz upload do artefato. Se seu artefato for maior que 51.200 bytes, a opção --s3-bucket ou a --resolve-s3 será obrigatória. 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 de configuração AWS SAM.

--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 modelo AWS SAM 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 modelo CloudFormation. YAML é usado por padrão.

Exemplo

O exemplo a seguir cria e empacota artefatos para uma função do Lambda e aplicações no CodeDeploy. Os artefatos são carregados em um bucket do Amazon S3. A saída do comando é um novo arquivo chamado package.yml.

$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket