sam package - Amazon Serverless Application Model
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

sam package

打包 Amazon SAM 应用程序。此命令将创建.zip文件中的代码和依赖项,然后将文件上传到 Amazon Simple Storage Service (Amazon S3) 中。Amazon SAM启用对 Amazon S3 中存储的所有文件的加密。然后,它返回 Amazon SAM 模板的副本,并将对本地构件的引用替换为此命令已将构件上传到的 Amazon S3 位置。

默认情况下,使用此命令时,Amazon SAMCLI 假设你当前的工作目录是项目的根目录。这些区域有:Amazon SAMCLI 首先尝试查找使用sam bu命令,位于.aws-sam子文件夹,并命名为template.yaml. 然后,Amazon SAMCLI 尝试找到名为的模板文件template.yaml要么template.yml在当前工作目录中。如果你指定--template选项,Amazon SAMCLI 的默认行为被覆盖,并且只会打包那个Amazon SAM模板以及它指向的本地资源。

注意

sam deploy现在隐式执行的功能sam package. 您可以使用sam deploy命令直接打包和部署应用程序。

使用方法:

sam package [OPTIONS] [ARGS]...

选项:

选项 描述
-t, --template-file, --template PATH 您的路径和文件名Amazon SAM已找到模板。

注意:如果指定此选项,Amazon SAM仅打包模板和它指向的本地资源。

--s3-bucket TEXT Amazon S3 存储桶的名称,此命令上传您的 Amazon S3 存储桶的名称。Amazon CloudFormationTemplate。如果你的模板大于 51,200 字节,那么--s3-bucket或者--resolve-s3选项是必需的。如果指定了两个--s3-bucket--resolve-s3选项,然后将会导致出现错误。
--s3-prefix TEXT 添加到上传到 Amazon S3 存储桶的工件名称中的前缀。前缀名称是 Amazon S3 存储桶的路径名称(文件夹名称)。这仅适用于声明的函数Zip软件包类型。
--image-repository TEXT 此命令上传函数映像的 Amazon Elastic Container Registry (Amazon ECR) 存储库的 URI。对于使用声明的函数所必需的Image软件包类型。
--kms-key-id TEXT ID 的 IDAmazon Key Management Service(Amazon KMS) 用于加密 Amazon S3 存储桶中静态的项目的密钥。如果未指定此选项,则Amazon SAM使用 Amazon S3 托管加密密钥。
--signing-profiles LIST (可选)用来签署部署包的签名配置文件列表。此参数获取键值对的列表,其中键是要签名的函数或图层的名称,值是签名配置文件,可选配置文件所有者分隔为:可选配置文件所有者。:. 例如:FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner
--output-template-file PATH 命令将打包模板写入到其中的文件路径。如果您未指定路径,此命令将模板写入标准输出中。
--use-json 输出 JSON 的输出 JSONAmazon CloudFormationTemplate。默认情况下使用 YAML。
--resolve-s3 自动创建用于打包的 Amazon S3 存储桶。如果指定了两个--s3-bucket--resolve-s3选项,然后将会导致出现错误。
--force-upload 覆盖 Amazon S3 存储桶中的现有文件。指定此标志可上传工件,即使工件与 Amazon S3 存储桶中的现有工件匹配。
--metadata (可选)要附加到模板中引用的所有工件的元数据映射。
--profile TEXT 获取凭证文件中的特定配置文件Amazon凭证。
--region TEXT 这些区域有:Amazon要部署到的区域。例如,us-east-1。
--config-file PATH 包含要使用的默认参数值的配置文件的路径和文件名。默认值为项目目录根目录中的 “samconfig.toml”。有关配置文件的详细信息,请参阅 Amazon SAM CLI 配置文件
--config-env TEXT 指定配置文件中要使用的默认参数值的环境名称。默认值为 “默认”。有关配置文件的详细信息,请参阅 Amazon SAM CLI 配置文件
--no-progressbar 将工件上传到 Amazon S3 时,请勿显示进度条。
--debug 打开调试日志记录以打印由Amazon SAMCLI 并显示时间戳。
--help 显示此消息并退出。
注意

如果Amazon SAM模板包含Metadata关于 serverlessRepo 的部分,以及LicenseUrl要么ReadmeUrl属性包含对本地文件的引用,必须更新Amazon CLI到 1.16.77 或更高版本。有关的更多信息Metadata的部分Amazon SAM模板和发布应用程序Amazon SAMCLI,请参阅使用Amazon SAM CLI 发布无服务器应用程序.