# AWS Organizations で StackSets の自動デプロイを有効または無効にする
<a name="stacksets-orgs-manage-auto-deployment"></a>

CloudFormation は、新しい AWS Organizations アカウントがターゲットの組織または組織単位 (OU) に追加されると、そのアカウントに追加のスタックを自動的にデプロイします。自動デプロイを有効にして、アカウントがターゲット OU から削除されたときにスタックおよび関連するリソースを削除するか保持するかを選択することができます。これらの設定は、サービスマネージド型のアクセス許可を使用する StackSets ではいつでも変更できます。

## 自動デプロイの仕組み
<a name="stacksets-orgs-auto-deployment-example"></a>

自動デプロイを有効にすると、アカウントがターゲット組織または OU に追加されたとき、ターゲット組織または OU から削除されたとき、ターゲット OU 間で移動したときに、トリガーされます。

例えば、`us-east-1` リージョンの `OU1` をターゲットにする `StackSet1` と、`us-east-1` リージョンの `OU2` をターゲットにする `StackSet2` がある場合、`OU1` には `AccountA` が含まれます。

自動デプロイを有効にして `AccountA` を `OU1` から `OU2` に移動すると、CloudFormation は自動的に削除オペレーションを実行して `StackSet1` スタックを `AccountA` から削除し、`StackSet2` スタックを `AccountA` に追加する作成オペレーションをキューに入れます。

## 考慮事項
<a name="stacksets-orgs-auto-deployment-considerations"></a>

自動デプロイを使用する際の考慮事項を次に示します。
+ 自動デプロイ機能は StackSet レベルで有効になります。OU、アカウント、リージョンを選択して自動デプロイを調整することはできません。
+ 上書きされたパラメータ値は、ターゲット OU とその子 OU に現在存在するアカウントにのみ適用されます。今後ターゲット OU とその子 OU に追加されるアカウントでは、StackSet のデフォルト値が使用され、オーバーライドされた値は使用されません。
+ 自動デプロイでは、アカウントレベルのターゲティングフィルターは考慮しません。特定のアカウントをターゲットにして自動デプロイを有効にすると、StackSet はデプロイを継続して、デプロイされた組織内の新しく追加されたアカウントにデプロイします。新しく追加されたアカウントへのデプロイを防ぐには、自動デプロイを無効にします。
+ 依存関係管理: StackSet ごとに最大 10 個の依存関係を定義し、アカウントごとに最大 100 個の依存関係にします。例えば、それぞれ 5 つの依存関係を持つ 5 つの StackSets がある場合、100 個の依存関係制限に向けてカウントしている 25 の依存関係があります。[Service Quotas コンソール](https://console.aws.amazon.com/servicequotas/home)を使用して制限の引き上げをリクエストできます。依存関係は、StackSets が削除されるか、組織が非アクティブ化されると削除されます。
+ 自動デプロイを使用する場合は、マネージド実行を有効にすることをお勧めします。マネージド実行では、複数のターゲットアカウントでの自動デプロイオペレーションを StackSet 内で同時に実行できるため、特に大規模な組織では処理速度が向上します。

## 自動デプロイを有効または無効にする (コンソール）
<a name="stacksets-orgs-manage-auto-deployment-console"></a>

**自動デプロイを有効または無効にするには**

1. AWS マネジメントコンソール にサインインし、CloudFormation コンソール ([https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)) を開きます。

1. 画面の上部のナビゲーションバーで、StackSet を作成した AWS リージョン を選択します。

1. ナビゲーションペインから [**StackSets**] を選択します。

1. **[StackSets]** ページで、更新する StackSet の名前の横にあるオプションを選択します。

1. 右上の **[アクション]** メニューで **[自動デプロイを編集]** を選択します。

1. 開いたダイアログボックスで、次の操作を行います。

   1. **[自動デプロイ]** で、**[アクティブ化済み]** または **[非アクティブ化済み]** を選択します。

   1. **[アカウント削除の動作]** で、**[スタックを削除]** または **[スタックを保持]** を選択します。保持されたリソースは現在の状態のままですが、StackSet には含まれなくなります。

   1. StackSet の**依存関係**では、依存する StackSet ARN を追加して、最大 10 個以内で依存関係を維持します。

1. **[保存]** を選択します。

## 自動デプロイを有効または無効にする (AWS CLI）
<a name="stacksets-orgs-manage-auto-deployment-cli"></a>

**自動デプロイを有効または無効にするには**

1. `--auto-deployment` オプションで [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html) コマンドを使用します。

   次のコマンドを実行すると、自動デプロイが有効になります。

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template --auto-deployment Enabled=true,RetainStacksOnAccountRemoval=true,DependsOn=ARN1,ARN2
   ```

   自動デプロイを無効にしたい場合は、次の例のように、`Enabled=false` を `--auto-deployment` オプションの値として指定します。

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template --auto-deployment Enabled=false
   ```

1. **update-stack-set** 出力の一部として返されたオペレーション ID を使用して、[https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-set-operation.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-set-operation.html) を実行し、StackSet が正常に更新されたことを確認します。

   ```
   aws cloudformation describe-stack-set-operation --operation-id operation_ID
   ```