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

# CfCT 清单的版本升级
<a name="cfct-compatibility"></a>

有关最新版本的 *AWS Control Tower 自定义项* (cfcT) 的信息，请参阅存储[`CHANGELOG.md`库中的 GitHub 文件](https://github.com/aws-solutions/aws-control-tower-customizations/blob/master/CHANGELOG.md)。

**警告**  
*AWS Control Tower 定制*版 (cfcT) 2.2.0 版引入了 cfcT 清单架构（版本 *2021-03-* 15），以与相关服务保持一致。 AWS APIs清单架构允许单个 manifest.yaml 文件通过分离的工作流程管理支持的资源（CloudFormation 模板和 RCPs）。 SCPs DevOps  
强烈建议您将 CfCT 清单架构从版本 *2020-01-01* 升级到版本 *2021-03-15* 或更高版本。  
CfCT 继续支持 `manifest.yaml` 文件的版本 *2021-03-15* 和 *2020-01-01*。无需更改现有配置。但是，版本 *2020-01-01* 已**终止支持**。我们不再为版本 *2020-01-01* 提供更新或添加增强功能。*2020-01-01* 版本不支持根 OU 和嵌套 OU 功能。

**CfCT 清单版本 *2021-03-15* 中已弃用的属性：**

```
organization_policies
policy_file
apply_to_accounts_in_ou

cloudformation_resources
template_file
deploy_to_account
deploy_to_ou
ssm_parameters
```

## 强制 CfCT 升级步骤
<a name="mandatory-upgrade-steps"></a>

升级到 CfCT 清单架构版本 *2021-03-15* 时，必须进行以下更改才能更新文件。以下各部分概述了过渡期间的强制性和建议性更改。

**组织策略**

1. **将**组织政策 RCPs **下的 SCPs 或移到新的属性资源下。**

1. 将 **policy\$1file** 属性更改为新属性 **resource\$1file**。

1. 将 **apply\$1to\$1accounts\$1in\$1ou** 属性更改为新属性 **deployment\$1targets**。OU 列表应在子属性 **organizational\$1units** 下定义。组织策略不支持子属性 **accounts**。

1. 添加一个值为 **scp** 或 **rcp** 的新属性 **deploy\$1method**。

**CloudFormation 资源**

1. **将 **cloudformation\$1resources 下的 CloudFormation 资源移到新的属性资源**下。**

1. 将 **template\$1file** 属性更改为新属性 **resource\$1file**。

1. 将 **deploy\$1to\$1ou** 属性更改为新属性 **deployment\$1targets**。OU 列表应在子属性 **organizational\$1units** 下定义。

1. 将 **deploy\$1to\$1accounts** 属性更改为新属性 **deployment\$1targets**。账户列表应在子属性 **accounts** 下定义。

1. 将 **ssm\$1parameters** 属性更改为新属性 **export\$1outputs**。

## 强烈建议的 CfCT 升级步骤
<a name="highly-recommended-upgrade-steps"></a>

**CloudFormation 参数**

1. 将 **parameter\$1file** 属性更改为新属性 **parameters**。

1. 删除 **parameter\$1file** 属性值中的文件路径。

1. 将现有参数 JSON 文件中的参数键和参数值复制到 **parameters** 属性的新格式中。这将帮助您在清单文件中管理它们。

**注意**  
CfCT 清单版本 *2021-03-15* 支持 **parameter\$1file** 属性。