在 CloudFormation 中使用公有扩展

1. 登录到 Amazon Web Services Management Console 并打开 Amazon CloudFormation 控制台 https://console.aws.amazon.com/cloudformation。

2. 从 CloudFormation 导航窗格的 CloudFormation registry（CloudFormation 注册表）下，选择 Public extensions（公有扩展）。

3. 使用 Filter（筛选条件）选择扩展类型，然后选择 Third party（第三方）。（Amazon 发布的扩展默认已激活。）

4. 选择扩展，然后选择 Activate（激活）。

   注意

   如果有多个版本的扩展可用，您可以使用 Version（版本）菜单选择要激活的扩展版本。默认为最新版本。

5. 使用 Activate extension（激活扩展）页面上的选项自定义扩展在此账户中的激活方式。

   • 使用扩展类型别名激活扩展：

     1. 选择 Override default（覆盖默认值）

     2. 输入要用于此扩展的扩展类型别名。别名必须遵循扩展类型的推荐格式。

     有关更多信息，请参阅指定别名以引用扩展。

   • 如果要启用私有资源，您可以指定 CloudFormation 在调用扩展时要承担的 IAM 角色。有关更多信息，请参阅激活扩展时指定执行角色。

   • 如果需要，在 Logging config（日志记录配置）下指定扩展的日志记录配置信息。例如：

     {
         "logRoleArn": "arn:aws:iam::account:role/rolename",
         "logGroupName": "log-group-name"
     }

     日志记录配置信息并非必需，但建议用于调试目的。要使用带有挂钩的日志记录配置，请添加与指定的执行角色相同的信任策略，以便日志角色可以将日志写入日志组。

     logRoleArn 和 logGroupName 键名区分大小写。

   • 在 Versioning（版本控制）下，指定接收更新的方式。

     • On（开）- 自动更新为最新次要版本。主要版本手动更新。

     • Off（关）- 永不自动更新为最新版本。所有版本均手动更新。

     有关更多信息，请参阅将 CloudFormation 设置为自动使用新版本的扩展。

6. 指定配置数据。

   注意

   此步骤对于挂钩是必需的。您必须为 TargetStack 属性指定 ALL。此操作启用挂钩架构属性部分中定义的挂钩属性。

   如果扩展需要在账户和区域级别进行额外配置，CloudFormation 会在 Activate extension（激活扩展）页面上包含 Configuration（配置）部分。您可以选择现在指定配置数据，也可以在扩展激活后指定该数据。如果扩展不需要配置，您将不会看到 Configuration（配置）部分。

   • 在启用扩展时指定配置数据：

     1. 选择 Configure now（立即配置），然后选择 Activate extension（激活扩展）。

        CloudFormation 将显示 Configure extension（配置扩展）页面。要查看扩展的当前配置架构，请确保 View configuration schema（查看配置架构）已激活。

     2. 在 Configuration JSON（配置 JSON）文本框中，输入一个 JSON 字符串，该字符串表示要为此扩展指定的配置架构。

     3. 选择 Configure extension（配置扩展）。

   • 稍后指定配置数据：

     • 选择 Configure later（稍后配置），然后选择 Activate extension（激活扩展）。

     要为已激活的扩展指定配置数据，请访问已激活扩展的详细信息页面。

   成功激活扩展后，CloudFormation 将显示该扩展的详细信息页面。

1. 登录到 Amazon Web Services Management Console 并打开 Amazon CloudFormation 控制台 https://console.aws.amazon.com/cloudformation。

2. 从 CloudFormation 导航窗格的 CloudFormation registry（CloudFormation 注册表）下，选择 Public extensions（公有扩展）。

3. 从 Actions（操作）菜单，选择 Edit（编辑），然后选择适用的编辑选项：

   • 要更新配置架构，请参阅在 CloudFormation 控制台中指定扩展的配置属性

   • 激活或停用自动更新：

     1. 选择 Edit automatic updates（编辑自动更新）。

     2. 选择 On（开）或 Off（关），然后选择 Save（保存）。

   • 更新执行角色：

     1. 选择 Edit execution role（编辑扩展角色）。

     2. 指定调用此扩展时希望 CloudFormation 使用的 IAM 角色的 ARN，然后选择 Save（保存）。

   • 更新日志记录配置：

     1. 选择 Edit logging config（编辑日志记录配置）。

     2. 编辑日志记录配置 JSON，然后选择 Save（保存）。

• 要在您的账户中激活挂钩，请使用 SetTypeConfiguration 操作。此操作启用挂钩架构架构 properties 部分中定义的挂钩属性。

  注意

  通过在您的账户中启用挂钩，您授权挂钩使用您的 Amazon Web Services 账户 定义的权限。CloudFormation 在将您的权限传递给挂钩之前会删除非必需的权限。CloudFormation 建议客户或挂钩用户在您的账户中启用挂钩之前查看挂钩权限并了解允许的挂钩权限。

  为在相同账户和 Amazon Web Services 区域 中注册的挂钩扩展指定配置数据。

  aws cloudformation --region us-west-2 set-type-configuration \
    --configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"TargetStacks": "ALL", "FailureMode": "FAIL", "Properties":{}}}}" \
    --type-arn $HOOK_TYPE_ARN

  重要

  要使挂钩能够主动检查堆栈的配置，您必须在HookConfiguration 部分中将 TargetStacks 设置为 ALL。

使用 Amazon CLI 激活公有扩展以在您的账户中使用

• 使用 activate-type 激活扩展，并指定在发布扩展的新次要版本时是否自动更新扩展。

  下面的示例指定要为此账户激活的公有扩展的公共 Amazon 资源名称（ARN）。此外，它指定 CloudFormation 在每次发布新的次要版本时更新扩展。

  aws cloudformation activate-type \
    --public-type-arn public_extension_ARN \
    --auto-update true

  此命令返回特定于此账户和区域的已激活扩展的 ARN。

  {
      "Arn": "624af370-311a-11e8-b6b7-500cexample"
  }

1. 使用 CloudFormation 注册表查找扩展。

2. 从 Actions（操作）菜单中，选择 Deactivate（停用）。

3. 选择 Deactivate（停用）。