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

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

sam deploy

部署 AWS SAM 应用程序。

此命令附带引导式交互模式,您可以通过指定 --guided 参数。交互模式将引导您完成部署所需的参数,提供默认选项,并可选择将这些选项保存在项目目录中的配置文件中。当您使用执行应用程序的后续部署时 sam deploy, AWS SAM CLI从配置文件中检索所需的参数。

在中声明的对象 Parameters 部分 AWS SAM 模板文件显示为其他交互模式提示。有关这些对象的示例以及相应的提示,请参阅 示例 部分。

有关指定 --guided 参数,请参阅 AWS SAM CLI配置文件.

正在部署 AWS Lambda 功能通过 AWS CloudFormation 需要 Amazon Simple Storage Service (人Amazon S3)桶装 Lambda 部署包。的 AWS SAM CLI创建和管理此 Amazon S3 桶。

用量:

sam deploy [OPTIONS] [ARGS]...

选项:

选项 Description
-g, --guided

指定此标志以具有 AWS SAM 使用提示来指导您完成部署。

-t, --template-file, --template PATH 您的 AWS SAM 模板位于。默认值:template.[yaml|yml].
--stack-name TEXT 必填项。名称 AWS CloudFormation 正在部署到的堆栈。如果指定现有堆栈,命令将更新堆栈。如果指定了新堆栈,则命令会将其创建。
--s3-bucket TEXT 名称 Amazon S3 bucket,此命令上传您的 AWS CloudFormation 模板。部署大于51,200字节的模板时需要执行此操作。
--s3-prefix TEXT 上传到 Amazon S3 桶。前缀名称是的路径名称(文件夹名称) Amazon S3 桶。
--capabilities LIST 必须指定才能允许的功能列表 AWS CloudFormation 以创建特定堆栈。某些堆栈模板可能包含可能影响权限的资源 AWS 帐户,例如,通过创建新的 AWS Identity and Access Management (人IAM)用户。对于这些堆栈,您必须通过指定此参数来明确确认它们的功能。唯一有效的值为 CAPABILITY_IAMCAPABILITY_NAMED_IAM。如果你有 IAM 资源,您可以指定其中一种能力。如果你有 IAM 资源,您必须指定 CAPABILITY_NAMED_IAM。如果您没有指定此参数,此操作将返回 InsufficientCapabilities 错误。
--region TEXT 的 AWS 要部署到的地区。例如,us-east-1。
--profile TEXT 来自您的凭证文件的特定配置文件, AWS 凭证。
--kms-key-id TEXT 的ID AWS Key Management Service (人AWS KMS)用于加密工件的密钥,这些工件在 Amazon S3 桶。
--force-upload 指定此标记以上传工件,即使它们与 Amazon S3 桶。匹配的工件将被覆盖。
--no-execute-changeset 指示是否执行更改集。如果要在执行更改集之前查看堆栈更改,请指定此标记。此命令创建 AWS CloudFormation 更改集,然后在不执行更改集的情况下退出。要执行更改集,请运行没有此标记的相同命令。
--role-arn TEXT 亚马逊资源名称(ARN) IAM 角色 AWS CloudFormation 假定在执行更改集时。
--fail-on-empty-changeset | --no-fail-on-empty-changeset 指定在没有对堆栈进行更改时是否返回非零退出代码。默认行为是返回非零退出代码。
--confirm-changeset | --no-confirm-changeset 提示确认是否 AWS SAM CLI部署计算出的变更集。
--use-json 输出JSON用于 AWS CloudFormation 模板。默认输出为YAML。
--metadata 可选。元数据映射,用于附加到模板中引用的所有工件。
--notification-arns LIST 列表 Amazon Simple Notification Service (人Amazon SNS)主题 ARNs 即 AWS CloudFormation 与堆栈相关联。
--tags 列表 要与创建或更新的堆栈关联的标记列表。 AWS CloudFormation 如果资源支持,也会将这些标记传播到堆栈中的资源。
--parameter-overrides 包含 AWS CloudFormation 参数覆盖编码为键值对。使用与 AWS Command Line Interface (人AWS CLI)。例如:ParameterKey=KeyPairName ParameterValue=MyKey ParameterKey=InstanceType ParameterValue=t1.micro
--config-file PATH 包含要使用的默认参数值的配置文件的路径和文件名。默认值为项目目录的根目录下的"samconfig.toml"。有关配置文件的详细信息,请参阅 AWS SAM CLI配置文件
--config-env TEXT 在配置文件中指定默认参数值的环境名称,以使用。默认值为“默认”。有关配置文件的详细信息,请参阅 AWS SAM CLI配置文件
--no-progressbar 将工件上传到时,不要显示进度条 Amazon S3.
--debug 打开调试日志记录。
--help 显示此消息并退出。

Example

以下是在 Parameters 部分,以及使用 sam deploy --guided.

AWS SAM 模板:

Parameters: MyPar: Type: String Default: MyParVal

对应 sam deploy --guided 提示:

Parameter MyPar [MyParVal]: