翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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)を参照してください。

**警告**  
*AWS Control Tower のカスタマイズ* (CfCT) のバージョン 2.2.0 では、関連する AWS サービス API に合わせて CfCT マニフェストスキーマ (バージョン *2021-03-15*) が導入されました。 APIs マニフェストスキーマを使用すると、単一の 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* に更新プログラムを提供したり、拡張機能を追加したりすることはありません。ルート OU およびネストされた OU 機能は、バージョン *2020-01-01* ではサポートされていません。

**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. SCP または RCP を新しいプロパティ **resources** の下にある **organization\$1policies** に移動します。

1. **policy\$1file** プロパティを新しいプロパティ **resource\$1file** に変更します。

1. **apply\$1to\$1accounts\$1in\$1ou** を新しいプロパティ **deployment\$1targets** に変更します。OU リストは、サブプロパティ **[organizational\$1units]** で定義する必要があります。**accounts** サブプロパティは、組織ポリシーではサポートされていません。

1. 新しいプロパティ **deploy\$1method** を、値 **scp** または **rcp** を指定して追加します。

**CloudFormation リソース**

1. CloudFormation リソースを新しいプロパティ **resources** の下にある **cloudformation\$1resources** に移動します。

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** プロパティの新しいフォーマットにコピーします。この操作により、マニフェストファイルでこれらの値を管理することができます。

**注記**  
**parameter\$1file** プロパティは CfCT マニフェストバージョン *2021-03-15* でサポートされています。