使用 Application Manager 管理 Amazon CloudFormation 模板 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon Systems Manager Change Manager 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息,请参阅 Amazon Systems Manager Change Manager 可用性变更

使用 Application Manager 管理 Amazon CloudFormation 模板

Application Manager 是 Amazon Systems Manager 中的一项工具,包括一个模板库和其他工具,可帮助您管理 Amazon CloudFormation 模板。本节包含以下信息:

使用模板库

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

开始前的准备工作

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

查看 Application Manager 中的模板库
  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

  2. 在导航窗格中,请选择 Application Manager

  3. 选择 CloudFormation 模板库

创建模板

以下过程介绍如何在 Application Manager 中创建 CloudFormation 模板。创建模板时,可以在 JSON 或 YAML 中输入模板的堆栈详细信息。如果您不熟悉 JSON 或 YAML,可以使用 Amazon 基础架构编辑器,此工具可用于通过可视化方式创建和修改模板。有关更多信息,请参阅《Amazon CloudFormation 用户指南》中的使用基础设施编辑器直观地创建模板。有关模板结构和语法的更多信息,请参阅《Amazon CloudFormation 用户指南》中的 Amazon CloudFormation 模板部分

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

在 Application Manager(操作台)中创建 CloudFormation 模板

通过使用 Amazon Web Services 管理控制台,使用以下过程在 Application Manager 中创建 CloudFormation 模板。

在 Application Manager 中创建 CloudFormation 模板
  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

  2. 在导航窗格中,请选择 Application Manager

  3. 选择 CloudFormation 模板库,然后选择创建模板或选择现有模板,然后再选择操作克隆

  4. 对于名称,输入模板名称,以帮助您识别模板创建的资源或堆栈的用途。

  5. (可选)对于版本名称,输入名称或编号以标识模板版本。

  6. 代码编辑器部分中,选择 YAML 或者 JSON,然后输入或复制并粘贴模板代码。

  7. (可选)在文档标签部分,将一个或多个标签键名称/值对应用于文档。

  8. (可选)在权限部分中,输入 Amazon Web Services 账户 ID 并选择添加帐户。此操作提供对模板的读取权限。帐户所有者可以配置和克隆模板,但无法编辑或删除模板。

  9. 选择创建。模板保存在 Systems Manager (SSM) 文档服务中。

在 Application Manager 中创建 CloudFormation 模板(命令行)

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

开始前的准备工作

安装并配置 Amazon CLI 或 Amazon Tools for PowerShell(如果尚未执行该操作)。有关信息,请参阅安装或更新 Amazon CLI 的最新版本以及安装 Amazon 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 中提供模板更改。

在 Application Manager 中编辑 CloudFormation 模板的步骤
  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

  2. 在导航窗格中,请选择 Application Manager

  3. 选择 CloudFormation 模板库

  4. 选择模板,然后依次选择操作编辑。您无法更改模板的名称,但您可以更改其他所有详细信息。

  5. 选择保存。模板将保存在 Systems Manager 文档服务中。