# AWS Organizations에서 StackSets에 대한 자동 배포 활성화 또는 비활성화
<a name="stacksets-orgs-manage-auto-deployment"></a>

CloudFormation은 대상 조직 또는 조직 단위(OU)에 추가될 때 새 AWS Organizations 계정에 추가 스택을 자동으로 배포할 수 있습니다. 자동 배포를 활성화하고 대상 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이 자동으로 삭제 작업을 실행하여 `AccountA`에서 `StackSet1` 스택을 제거하고, `AccountA`에 `StackSet2` 스택을 추가하는 생성 작업을 대기열에 추가합니다.

## 고려 사항
<a name="stacksets-orgs-auto-deployment-considerations"></a>

다음은 자동 배포를 사용할 때 고려 사항입니다.
+ 자동 배포 기능은 StackSet 수준에서 활성화됩니다. OU, 계정 또는 리전의 경우 자동 배포를 선택적으로 조정할 수 없습니다.
+ 재정의된 파라미터값은 현재 대상 OU와 해당 하위 OU에 있는 계정에만 적용됩니다. 나중에 대상 OU와 해당 하위 OU에 추가되는 계정은 재정의된 값이 아닌 StackSet 기본값을 사용합니다.
+ 자동 배포 시 계정 수준 대상 지정 필터를 고려하지 않습니다. 특정 계정을 대상으로 하고 자동 배포를 활성화하는 경우 StackSet는 배포된 조직 내 새로 추가된 계정에도 계속 배포합니다. 새로 추가된 계정에 대한 배포를 방지하려면 자동 배포를 비활성화합니다.
+ 종속성 관리: StackSet당 최대 10개의 종속성을 정의하고 이때 계정당 최대 100개의 종속성을 포함합니다. 예를 들어 종속성이 각각 5개인 StackSet가 5개 있는 경우 25개의 종속성이 있으며 종속성 한도를 100개로 계산됩니다. [Service Quotas 콘솔](https://console.aws.amazon.com/servicequotas/home)을 통해 한도 증가를 요청할 수 있습니다. 종속성은 StackSet가 삭제되거나 조직이 비활성화될 때 제거됩니다.
+ 자동 배포를 사용할 경우 관리형 실행을 활성화하는 것이 좋습니다. 관리형 실행을 사용하면 여러 대상 계정의 자동 배포 작업을 StackSet 내에서 동시에 실행할 수 있으므로 특히 규모가 더 큰 조직의 경우 처리 속도가 향상됩니다.

## 자동 배포 활성화 또는 비활성화(콘솔)
<a name="stacksets-orgs-manage-auto-deployment-console"></a>

**자동 배포를 활성화 또는 비활성화하려면**

1. AWS Management Console에 로그인하여 [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)에서 CloudFormation 콘솔을 엽니다.

1. 화면 상단의 탐색 모음에서 StackSet를 생성한 AWS 리전을 선택합니다.

1. 탐색 창에서 **스택 세트**를 선택합니다.

1. **StackSet** 페이지에서 업데이트할 StackSet 이름 옆의 옵션을 선택합니다.

1. 오른쪽 상단의 **작업** 메뉴에서 **자동 배포 편집**을 선택하세요.

1. 열리는 대화 상자에서 다음을 수행하세요.

   1. **자동 배포**에서 **활성화됨** 또는 **비활성화됨**을 선택하세요.

   1. **계정 제거 동작**에서 **스택 삭제** 또는 **스택 유지**를 선택하세요. 유지되는 리소스는 현재 상태로 남아 있지만 더 이상 StackSet에 포함되지 않습니다.

   1. StackSet **종속성**의 경우 종속성을 최대 10개 이내로 유지하면서 종속 StackSet ARN을 추가합니다.

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
   ```

   또는 자동 배포를 비활성화하려면 다음 예제와 같이 `--auto-deployment` 옵션의 값으로 `Enabled=false`를 지정하세요.

   ```
   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
   ```