sam publish - AWS Serverless Application Model
使用量Options示例

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

sam publish

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

有关 AWS SAM CLI 的简介，请参阅什么是 AWS SAMCLI？

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

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

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

注意

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

使用量

$ sam publish <options>

Options

--config-env TEXT

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

--config-file PATH

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

--debug

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

--help

显示此消息并退出。

--profile TEXT

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

--region TEXT

要部署到的 AWS Region。例如，us-east-1。

--save-params

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

--semantic-version TEXT

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

--template, -t PATH

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

示例

要发布应用程序，请执行以下操作：

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