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

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

sam publish

此页面提供了 Amazon Serverless Application Model 命令行界面(Amazon SAM CLI) sam publish 命令的参考信息。

有关 Amazon SAM CLI 的简介,请参阅 那是什么 Amazon SAMCLI?

sam publish 命令将 Amazon SAM 应用程序发布到 Amazon Serverless Application Repository。此命令采用打包的 Amazon SAM 模板,并将应用程序发布到指定的 Amazon 区域。

sam publish 命令要求 Amazon SAM 模板纳入一个包含发布所需的应用程序元数据的 Metadata 部分。在 Metadata 部分中,LicenseUrlReadmeUrl 属性必须引用 Amazon Simple Storage Service (Amazon S3) 存储桶,而不是本地文件。有关 Amazon SAM 模板的 Metadata 部分的更多信息,请参阅 使用 Amazon SAM CLI 发布无服务器应用程序

默认情况下,sam publish 将创建应用程序为私有。在允许其他 Amazon 账户查看和部署您的应用程序之前,您必须将其共享。有关共享应用程序的信息,请参阅《Amazon Serverless Application Repository 开发人员指南》中的 Amazon Serverless Application Repository 基于资源的策略示例

注意

目前 sam publish 不支持发布本地指定的嵌套应用程序。如果您的应用程序包含嵌套应用程序,则在发布父应用程序之前,必须将它们单独发布到 Amazon Serverless Application Repository 中。

使用量

$ sam publish <options>

Options

--config-env TEXT

在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息,请参阅 Amazon SAMCLI 配置文件

--config-file PATH

包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中,默认值为“samconfig.toml”。有关配置文件的详细信息,请参阅 Amazon SAMCLI 配置文件

--debug

启用调试日志记录,以打印 Amazon SAM CLI 生成的调试消息并显示时间戳。

--help

显示此消息并退出。

--profile TEXT

凭证文件中用于获取 Amazon 凭证的特定配置文件。

--region TEXT

要部署到的 Amazon Region。例如,us-east-1。

--save-params

将您在命令行中提供的参数保存到 Amazon SAM 配置文件中。

--semantic-version TEXT

(可选)使用此选项提供应用程序的语义版本,该版本将覆盖模板文件 Metadata 部分中的 SemanticVersion 属性。有关语义版本控制的更多信息,请参阅语义版本控制规范

--template, -t PATH

Amazon SAM 模板文件 [default: template.[yaml|yml]] 的路径。

示例

要发布应用程序,请执行以下操作:

$ sam publish --template packaged.yaml --region us-east-1