来自 CloudFormation 模板的堆栈 | 创建 - AMS 高级更改类型参考
更改类型详情附加信息执行输入参数示例：必填参数示例：所有参数

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

来自 CloudFormation 模板的堆栈 | 创建

通过指向 S3 存储桶中的自定义 CloudFormation (CFN) 模板或将该模板的内容粘贴为此更改类型的输入来创建堆栈。

完整分类：部署 | 摄取 | 来自 CloudFormation 模板的堆栈 | 创建

更改类型详情

更改类型 ID

ct-36cn2avfrrj9v

当前版本

2.0

预期执行时长

360 分钟

AWS 批准

必需

客户批准

可选

执行模式

自动

附加信息

创建 CloudFormation 采集堆栈

Create Stack From CloudFormation Template interface showing description, ID, and version.

使用控制台创建 CloudFormation 采集堆栈

  1. 导航到 “创建 RFC” 页面：在 AMS 控制台的左侧导航窗格中，单击RFCs打开 RFCs 列表页面，然后单击 “创建 R FC”。

  2. 在默认的 “浏览更改类型” 视图中选择常用更改类型 (CT)，或者在 “按类别选择” 视图中选择 CT。

    • 按更改类型浏览：您可以单击 “快速创建” 区域中的常用 CT，立即打开 “运行 RFC” 页面。请注意，您不能使用快速创建来选择较旧的 CT 版本。

      要进行排序 CTs，请使用卡片视图或表格视图中的所有更改类型区域。在任一视图中，选择一个 CT，然后单击 “创建 RFC” 打开 “运行 RFC” 页面。如果适用，“创建 RFC” 按钮旁边会出现 “使用旧版本创建” 选项。

    • 按类别选择：选择类别、子类别、项目和操作，CT 详细信息框将打开，并显示 “使用旧版本创建” 选项（如果适用）。单击 “创建 RFC” 打开 “运行 RFC” 页面。

  3. 在 “运行 RFC” 页面上，打开 CT 名称区域以查看 CT 详细信息框。必须填写主题（如果您在 “浏览更改类型” 视图中选择 CT，则会为您填写此主题）。打开 “其他配置” 区域以添加有关 RFC 的信息。

    在执行配置区域中，使用可用的下拉列表或输入所需参数的值。要配置可选的执行参数，请打开其他配置区域。

  4. 完成后，单击 “运行”。如果没有错误，则会显示成功创建的 RFC 页面，其中包含已提交的 RFC 详细信息和初始运行输出。

  5. 打开运行参数区域以查看您提交的配置。刷新页面以更新 RFC 的执行状态。（可选）取消 RFC 或使用页面顶部的选项创建一个 RFC 的副本。

使用 CL CloudFormation I 创建采集堆栈

  1. 使用 Inline Create（您发出包含所有 RFC 和执行参数的create-rfc命令）或模板创建（创建两个 JSON 文件，一个用于 RFC 参数，一个用于执行参数），然后以这两个文件作为输入发出create-rfc命令。这里描述了这两种方法。

  2. 提交带有返回的 RFC ID 的 RFC: aws amscm submit-rfc --rfc-id ID 命令。

    监控 RFC: aws amscm get-rfc --rfc-id ID 命令。

要检查更改类型版本，请使用以下命令：

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
注意

您可以将任何CreateRfc参数与任何 RFC 一起使用，无论它们是否属于变更类型的架构的一部分。例如，要在 RFC 状态更改时收到通知，请将此行添加到请求的 RFC 参数部分（不是执行参数）。--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"有关所有 CreateRfc 参数的列表，请参阅《AMS 变更管理 API 参考》。

  1. 准备用于创建堆栈的 CloudFormation 模板，然后将其上传到您的 S3 存储桶。有关重要详情，请参阅 AWS CloudFormation Ingest 指南、最佳实践和限制。

  2. 创建 RFC 并将其提交给 AMS：

    1. 创建并保存执行参数 JSON 文件，包括所需的 CloudFormation 模板参数。以下示例将其命名为 CreateCfnParams .json。

      Web 应用程序堆栈 CreateCfnParams .json 文件示例：

      {
  "Name": "cfn-ingest",
  "Description": "CFNIngest Web Application Stack",
  "VpcId": "VPC_ID",
  "CloudFormationTemplateS3Endpoint": "$S3_URL",
  "TimeoutInMinutes": 120,
  "Tags": [
   {
    "Key":   "Enviroment Type"
    "Value": "Dev",
   },
   {
    "Key":   "Application"
    "Value": "PCS",
   }
  ],
  "Parameters": [
   {
    "Name": "Parameter-for-S3Bucket-Name",
    "Value":  "BUCKET-NAME"
   },
   {
    "Name": "Parameter-for-Image-Id",
    "Value":  "AMI-ID"
   }
  ],
}

      SNS 主题 CreateCfnParams .json 文件示例：

      {
  "Name": "cfn-ingest",
  "Description": "CFNIngest Web Application Stack",
  "CloudFormationTemplateS3Endpoint": "$S3_URL",
  "Tags": [
    {"Key": "Enviroment Type", "Value": "Dev"}
  ],
  "Parameters": [
    {"Name": "TopicName", "Value": "MyTopic1"}
  ]
}

  3. 创建并保存包含以下内容的 RFC 参数 JSON 文件。以下示例将其命名为 CreateCfnRfc .json 文件：

    {
   "ChangeTypeId": "ct-36cn2avfrrj9v",
   "ChangeTypeVersion": "2.0",
   "Title": "cfn-ingest"
}

  4. 创建 RFC，指定 CreateCfnRfc 文件和 CreateCfnParams 文件：

    aws amscm create-rfc --cli-input-json file://CreateCfnRfc.json  --execution-parameters file://CreateCfnParams.json

    您在响应中收到新 RFC 的 ID，并可以使用它来提交和监控 RFC。在您提交之前，RFC 仍处于编辑状态且无法启动。

注意

此更改类型为版本 2.0，并且是自动的（不是手动执行的）。这样可以更快地执行 CT，而且，一个新参数允许您将自定义 CloudFormation 模板粘贴到 RFC 中。CloudFormationTemplate此外，在此版本中，如果您指定了自己的安全组，我们不会附加默认 AMS 安全组。如果您未在请求中指定自己的安全组，AMS 将附加 AMS 默认安全组。在 CFN Ingest v1.0 中，无论您是否提供了自己的安全组，我们都会附加 AMS 默认安全组。

AMS 已启用 17 项 AMS 自行配置服务以用于此变更类型。有关支持的资源的信息，请参阅 CloudFormation Ingest Stack：支持的资源。

注意

版本 2.0 接受不是预签名 URL 的 S3 终端节点。

如果您使用此 CT 的先前版本，则 CloudFormationTemplateS3Endpoint 参数值必须是预签名 URL。

生成预签名 S3 存储桶 URL 的命令示例 (Mac/Linux)：

export S3_PRESIGNED_URL=$(aws s3 presign DASHDASHexpires-in 86400 s3://BUCKET_NAME/CFN_TEMPLATE.json)

生成预签名 S3 存储桶 URL 的命令示例 (Windows)：

for /f %i in ('aws s3 presign DASHDASHexpires-in 86400 s3://BUCKET_NAME/CFN_TEMPLATE.json') do set S3_PRESIGNED_URL=%i

另请参阅 URLs 为 Amazon S3 存储桶创建预签名存储桶。

注意

如果 S3 存储桶存在于 AMS 账户中，则必须使用您的 AMS 凭据执行此命令。例如，您可能需要--profile saml在获取 AMS AWS Security Token Service (AWS STS) 凭证后追加。

相关变更类型：批准 CloudFormation 采集堆栈变更集，更新 CloudFormation 采集堆栈

要了解有关 AWS 的更多信息 CloudFormation，请参阅 AW S CloudFormation。要查看 CloudFormation 模板，请打开 AWS CloudFormation 模板参考。

模板经过验证以确保可以在 AMS 账户中创建。如果通过验证，则会对其进行更新，使其包含符合 AMS 要求的所有资源或配置。这包括添加诸如 Amazon CloudWatch 警报之类的资源，以允许 AMS 运营部门监控堆栈。

如果满足以下任一条件，则 RFC 将被拒绝：

  • RFC JSON 语法不正确或不符合给定格式。

  • 提供的 S3 存储桶预签名 URL 无效。

  • 模板的 CloudFormation 语法无效。

  • 该模板没有为所有参数值设置默认值。

  • 模板未通过 AMS 验证。有关 AMS 验证步骤，请参阅本主题后面的信息。

如果由于资源创建问题导致 CloudFormation 堆栈创建失败，则 RFC 将失败。

要了解有关 CFN 验证和验证器的更多信息，请参阅模板验证和CloudFormation 采集堆栈：CFN 验证器示例。

执行输入参数

有关执行输入参数的详细信息，请参见变更架构类型 ct-36cn2avfrrj9v。

示例：必填参数

Example not available.

示例：所有参数

Example not available.