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

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

使用 CloudFormation 模板

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

使用模板库

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

开始前的准备工作

我们建议您阅读以下主题,以了解有关 SSM 文档的详细信 CloudFormation,然后再在Application Manager.

查看模板库Application Manager

  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

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

  3. 应用程序部分,选择。CloudFormation 堆栈.

  4. 选择模板库.

创建模板

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

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

创建 CloudFormation 模板Application Manager(console)

使用以下过程在Application Manager通过使用Amazon Web Services Management Console.

要在中创建 CloudFormation 模板,请在Application Manager

  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

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

  3. 应用程序部分,选择。CloudFormation 堆栈.

  4. 选择模板库,然后选择创建模板或选择现有模板,然后选择操作Clone.

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

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

  7. (可选)用于说明中,输入有关此模板的信息。

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

  9. (可选)在标签部分,将一个或多个标签键名称/值对应用到模板。

    标签是您分配给资源的可选元数据。通过使用标签,您可以按各种方式(如用途、所有者或环境)对资源进行分类)。有关标记 Systems Manager 资源的更多信息,请参阅。标记 Systems Manager 资源.

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

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

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

在 JSON 或 YAML 中创建 CloudFormation 模板的内容后,您可以使用Amazon Command Line Interface(Amazon CLI)或Amazon Tools for PowerShell以将模板另存为 SSM 文档。

开始前的准备工作

安装并配置 Amazon CLI 或 Amazon Tools for PowerShell(如果尚未执行该操作)。想要了解有关信息,请参阅安装或升级Amazon命令行工具.

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"
            }
        ]
    }

编辑模板

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

在中编辑 CloudFormation 模板的步骤Application Manager

  1. 访问 https://console.aws.amazon.com/systems-manager/,打开 Amazon Systems Manager 控制台。

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

  3. 应用程序部分,选择。CloudFormation 堆栈.

  4. 选择模板库.

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

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