本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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_IAM 和 CAPABILITY_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]: