使用 Application Manager 管理 AWS CloudFormation 模板

Application Manager 是 AWS Systems Manager 的一项功能，包括一个模板库和其他工具，可帮助您管理 AWS CloudFormation 模板。本节包含以下信息：

使用模板库

这些 Application Manager 模板库提供了帮助您查看、创建、编辑、删除和克隆模板的工具。您也可以直接从模板库配置堆栈。模板存储为 CloudFormation 类型的 Systems Manager (SSM) 文档。通过将模板存储为 SSM 文档，您可以使用版本控件来操作不同版本的模板。您也可以设置权限和共享模板。成功配置堆栈后，将在 Application Manager 和 CloudFormation 中提供堆栈和模板。

开始前的准备工作

我们建议您阅读以下主题，以了解有关 SSM 文档的详细信息，然后再开始使用 Application Manager 中的 CloudFormation 模板。

创建模板

以下过程介绍如何在 Application Manager 中创建 CloudFormation 模板。创建模板时，可以在 JSON 或 YAML 中输入模板的堆栈详细信息。如果您不熟悉 JSON 或 YAML，可以使用 AWS CloudFormation 设计器，此工具可用于通过可视化方式创建和修改模板。有关更多信息，请参阅AWS CloudFormation用户指南中的什么是 AWS CloudFormation Designer？。有关模板结构和语法的信息，请参阅模板剖析。

您还可以利用多个模板片段构建模板。模板片段提供一些示例，以说明如何为特定资源编写模板。例如，您可以查看用于 Amazon Elastic Compute Cloud (Amazon EC2) 实例、Amazon Simple Compute Service (Amazon S3) 域、Amazon Simple Storage Service (Amazon S3) 域、AWS CloudFormation映射等的片段。片段按资源分组。可以在AWS CloudFormation用户指南的通用模板片段部分中，可以找到通用 AWS CloudFormation 片段。

在 Application Manager（操作台）中创建 CloudFormation 模板

通过使用 AWS Management Console，使用以下过程在 Application Manager 中创建 CloudFormation 模板。

在 Application Manager 中创建 CloudFormation 模板（命令行）

在 JSON 或 YAML 中创建 CloudFormation 模板的内容后，您可以使用AWS Command Line Interface (AWS CLI） 或 AWS Tools for PowerShell 将模板另存为 SSM 文档。将每个示例资源占位符替换为您自己的信息。

开始前的准备工作

安装并配置 AWS CLI 或 AWS Tools for PowerShell（如果尚未执行该操作）。有关信息，请参阅安装或更新 AWS CLI 的最新版本以及安装 AWS Tools for PowerShell。

Linux & macOS

aws ssm create-document \
    --content file://path/to/template_in_json_or_yaml \
    --name "a_name_for_the_template" \
    --document-type "CloudFormation" \
    --document-format "JSON_or_YAML" \
    --tags "Key=tag-key,Value=tag-value"

Windows

aws ssm create-document ^
    --content file://C:\path\to\template_in_json_or_yaml ^
    --name "a_name_for_the_template" ^
    --document-type "CloudFormation" ^
    --document-format "JSON_or_YAML" ^
    --tags "Key=tag-key,Value=tag-value"

PowerShell

$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String
New-SSMDocument `
    -Content $json `
    -Name "a_name_for_the_template" `
    -DocumentType "CloudFormation" `
    -DocumentFormat "JSON_or_YAML" `
    -Tags "Key=tag-key,Value=tag-value"

如果成功，该命令将返回类似于以下内容的响应。

{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }

编辑模板

使用以下过程在 Application Manager 中编辑 CloudFormation 模板。配置使用更新后模板的堆栈后，将在 CloudFormation 中提供模板更改。