

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# CfCT 資訊清單的版本升級
<a name="cfct-compatibility"></a>

如需 *AWS Control Tower (CfCT) 最新版本自訂*的相關資訊，請參閱 GitHub 儲存庫中的 [`CHANGELOG.md` 檔案](https://github.com/aws-solutions/aws-control-tower-customizations/blob/master/CHANGELOG.md)。 CfCT 

**警告**  
*AWS Control Tower (CfCT) 自訂*的 2.2.0 版引入了 CfCT 資訊清單結構描述 (*2021-03-15* 版），以與相關 AWS 服務 APIs保持一致。 CfCT 資訊清單結構描述允許單一 manifest.yaml 檔案透過解耦的 DevOps 工作流程管理支援的資源 (CloudFormation 範本、SCPs 和 RCPs)。  
強烈建議您將 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* 版時，您必須進行下列變更，才能更新檔案。下一節概述轉換的必要和建議變更。

**Organizations 政策**

1. 在新屬性**資源**下移動 **organization\$1policies** 下的 SCPs RCPs。

1. 將 **policy\$1file** 屬性變更為新的 屬性 **resource\$1file。**

1. 將 **apply\$1to\$1accounts\$1in\$1ou** 變更為新的屬性 **deployment\$1targets**。OU 清單應在 sub-property **organization\$1units** 下定義。組織政策不支援**帳戶**子屬性。

1. 使用值 **scp** 或 **rcp** 新增屬性 **deploy\$1method**。

**CloudFormation 資源**

1. 在新屬性資源下，將 CloudFormation **資源**移至 **cloudformation\$1resources** 下。

1. 將 **template\$1file** 屬性變更為新的 屬性 **resource\$1file**。

1. 將 **deploy\$1to\$1ou** 變更為新的屬性 **deployment\$1targets**。OU 清單應在 sub-property **organization\$1units** 下定義。

1. 將 **deploy\$1to\$1accounts** 變更為新的屬性 **deployment\$1targets**。帳戶清單應在子屬性**帳戶**下定義。

1. 將 **ssm\$1parameters** 屬性變更為新的 屬性 **export\$1outputs**。

## 強烈建議的 CfCT 升級步驟
<a name="highly-recommended-upgrade-steps"></a>

**CloudFormation 參數**

1. 將 **parameter\$1file** 屬性變更為新的屬性**參數**。

1. 移除 **parameter\$1file** 屬性值中的檔案路徑。

1. 將參數索引鍵和參數值從現有參數 JSON 檔案複製到**參數**屬性的新格式。這可協助您在資訊清單檔案中管理它們。

**注意**  
CfCT 資訊清單版本 *2021-03-15* 支援 **parameter\$1file** 屬性。