在 CloudFormation 中使用公有扩展

使用 CloudFormation 控制台激活公有扩展以便在您的账户中使用

1. 在 CloudFormation 控制台中，从 CloudFormation 导航窗格的 CloudFormation registry（CloudFormation 注册表）下选择 Public extensions（公有扩展）。

   注册表显示您账户中可用的公有扩展。

2. 使用 Filter（筛选条件）选择扩展类型，然后选择 Third party（第三方）。（Amazon 发布的扩展原定设置为激活。）

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

   注意

   如果扩展有多个版本可用，则可以使用 Version（版本）菜单选择要激活的扩展版本。原定设置为最新版本。

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

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

     1. 选择 Override default（覆盖原定设置）

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

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

   • 如果您启用私有资源，则可以在调用该扩展时为 CloudFormation 指定 IAM 角色。有关详细信息，请参阅激活扩展时指定执行角色。

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

     请注意，logRoleArn 和 logGroupName 键名称区分大小写。例如：

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

   • 使用 Versioning（版本控制）下的选项指定在发布新的次要版本时 CloudFormation 是否自动更新此账户和区域中的扩展。有关更多信息，请参阅将 CloudFormation 设置为自动使用新版本的扩展。

5. 如有必要，指定配置数据（可选）。

   如果扩展需要在账户和区域级别进行其他配置，则 CloudFormation 会在 Activate extension（激活扩展）页面上包含 Configuration（配置）部分。您可以选择立即指定配置数据，或者在激活扩展之后指定。

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

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

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

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

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

   • 随后指定配置数据：

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

     要为已激活的扩展指定配置数据，请参阅在账户级别配置扩展。

   如果扩展不需要配置，您将看不到 Configuration（配置）部分。选择 Activate extension（激活扩展）。

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

使用 CloudFormation 控制台更新账户中已激活的公有扩展

在账户和区域中激活扩展后，您可以在激活该扩展时更新它的以下属性，包括：

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

2. 从 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（保存）。

使用 CloudFormation 控制台停用账户中的公有扩展

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

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

3. 选择 Deactivate（停用）。

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

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

  下面的示例指定了要为此账户激活的公有扩展的公有 ARN。此外，它还可指定每次发布新的次要版本时 CloudFormation 是否自动更新扩展。CloudFormation 返回此账户和区域特有的已激活扩展的 Amazon 资源编号 (ARN)。

  PROMPT> aws cloudformation activate-type --public-type-arn public_extension_ARN --auto-update-activated
  {
      "Arn": "624af370-311a-11e8-b6b7-500cexample"
  }

使用 Amazon CLI 手动更新公有扩展的版本

• 使用 activate-type 再次激活扩展。使用 --version-update 参数指定是否将扩展更新为最新的主要版本、最新的次要版本，或者扩展是否自动更新。有关更多信息，请参阅 ActivateType。