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

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

sam package

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

默认情况下,当您使用此命令时,Amazon SAMCLI 假定您当前的工作目录是项目的根目录。这些区域有:Amazon SAMCLI 首先尝试查找使用sam build命令,位于.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 CloudFormation模板。
--s3-prefix TEXT 添加到上传到 Amazon S3 存储桶中的构件名称中的前缀。前缀名称是 Amazon S3 存储桶的路径名称(文件夹名称)。这仅适用于使用Zip程序包类型。
--image-repository TEXT Amazon Elastic Container Registry (Amazon ECR) 存储库的 URI,此命令将在其中上传函数的映像。对于使用Image程序包类型。
--kms-key-id TEXT 的 IDAmazon Key Management Service(Amazon KMS) 密钥,用于加密 Amazon S3 存储桶中的静态构件。
--signing-profiles LIST (可选)要对部署包进行签名的配置文件列表。此参数接受键值对的列表,其中键是待签名的函数或图层的名称,值是签名配置文件,其中可选配置文件所有者以:. 例如:FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner
--output-template-file PATH 命令写入打包模板的文件路径。如果不指定路径,该命令将模板写入标准输出。
--use-json 输出 JSONAmazon CloudFormation模板。默认情况下使用 YAML。
--force-upload 覆盖 Amazon S3 存储桶中的现有文件。指定此标志以上传构件,即使它们与 Amazon S3 存储桶中的现有构件匹配。
--metadata (可选)要附加到模板中引用的所有对象的元数据映射。
--profile TEXT 凭证文件中的特定配置文件,该配置文件将获取Amazon凭证。
--region TEXT 这些区域有:Amazon要部署到的区域。例如,us-east-1。
--config-file PATH 包含待使用默认参数值的配置文件对应的路径和文件名。默认值为项目目录的根目录中的 “samconfig.toml”。有关配置文件的详细信息,请参阅 Amazon SAMCLI 配置文件
--config-env TEXT 指定要使用的配置文件中默认参数值的环境名称。默认值为 “默认”。有关配置文件的详细信息,请参阅 Amazon SAMCLI 配置文件
--no-progressbar 将对象上传到 Amazon S3 时,请勿显示进度条。
--debug 打开调试日志记录以打印由Amazon SAMCLI 并显示时间戳。
--help 显示此消息并退出。
注意

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