기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# SageMaker HyperPod 클러스터 구성 업데이트
<a name="sagemaker-hyperpod-eks-operate-cli-command-update-cluster"></a>

[update-cluster](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-cluster.html)를 실행하여 클러스터 구성을 업데이트합니다.

**참고**  
중요 고려 사항:  
클러스터가 생성된 후에는 HyperPod 클러스터가 연결된 EKS 클러스터 정보를 변경할 수 없습니다.
클러스터에서 심층 상태 확인이 실행 중인 경우 이 API는 예상대로 작동하지 않습니다. 심층 상태 확인이 진행 중이라는 오류 메시지가 표시될 수 있습니다. 클러스터를 업데이트하려면 심층 상태 확인이 완료될 때까지 기다려야 합니다.

1. JSON 형식으로 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html) API 요청 파일을 생성합니다. 업데이트할 올바른 클러스터 이름과 인스턴스 그룹 이름을 지정해야 합니다. 각 인스턴스 그룹에 대해 인스턴스 유형, 인스턴스 수, 수명 주기 구성 진입점 스크립트 및 스크립트 경로를 변경할 수 있습니다.
**참고**  
`UpdateCluster`를 사용하여 SageMaker HyperPod 클러스터에서 인스턴스 그룹을 스케일 다운하거나 전체 인스턴스 그룹을 제거할 수 있습니다. 인스턴스 그룹을 스케일 다운하거나 삭제하는 방법에 대한 추가 지침은 [SageMaker HyperPod 클러스터 스케일 다운](smcluster-scale-down.md) 섹션을 참조하세요.

   1. `ClusterName`의 경우 업데이트할 클러스터 이름을 선택합니다.

   1. `InstanceGroupName`의 경우

      1. 기존 인스턴스 그룹을 업데이트하려면 업데이트하려는 인스턴스 그룹의 이름을 지정합니다.

      1. 새 인스턴스 그룹을 추가하려면 클러스터에 없는 새 이름을 지정합니다.

   1. `InstanceType`의 경우

      1. 기존 인스턴스 그룹을 업데이트하려면 처음에 지정한 인스턴스 유형을 그룹에 일치시켜야 합니다.

      1. 새 인스턴스 그룹을 추가하려면 그룹을 구성할 인스턴스 유형을 지정합니다.

      `InstanceRequirements` 대신를 사용하는 인스턴스 그룹의 `InstanceType`경우 `InstanceTypes` 목록에서 인스턴스 유형을 추가하거나 제거할 수 있습니다. 그러나 활성 노드가 실행 중인 인스턴스 유형은 제거할 수 없습니다. 기존 인스턴스 그룹을 업데이트할 `InstanceRequirements` 때 `InstanceType`와 간에 전환할 수도 없습니다. `InstanceType` 및 `InstanceRequirements`는 상호 배타적입니다.

   1. `InstanceCount`의 경우

      1. 기존 인스턴스 그룹을 업데이트하려면 원하는 인스턴스 수에 해당하는 정수를 지정합니다. 더 높거나 낮은 값(0까지)을 제공하여 인스턴스 그룹을 스케일 업하거나 스케일 다운할 수 있습니다.

      1. 새 인스턴스 그룹을 추가하려면 1 이상의 정수를 지정합니다.

   1. `LifeCycleConfig`의 경우 인스턴스 그룹을 업데이트하려는 대로 `SourceS3Uri` 및 `OnCreate`의 값을 모두 변경할수 있습니다.

   1. `ExecutionRole`의 경우

      1. 기존 인스턴스 그룹을 업데이트하려면 클러스터 생성 중에 연결한 것과 동일한 IAM 역할을 계속 사용합니다.

      1. 새 인스턴스 그룹을 추가하려면 연결할 IAM 역할을 지정합니다.

   1. `ThreadsPerCore`의 경우

      1. 기존 인스턴스 그룹을 업데이트하려면 클러스터 생성 중에 지정한 것과 동일한 값을 계속 사용합니다.

      1. 새 인스턴스 그룹을 추가하려면 인스턴스 유형별로 허용되는 옵션 중에서 원하는 값을 선택할 수 있습니다. 자세한 내용은 인스턴스 유형을 검색하고 *Amazon EC2 사용 설명서*의 [인스턴스 유형당 CPU 코어 및 CPU 코어당 스레드](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cpu-options-supported-instances-values.html)에 있는 참조 테이블의 **코어당 유효한 스레드** 열을 참조하세요.

   1. `OnStartDeepHealthChecks`의 경우 `InstanceStress` 및 `InstanceConnectivity`를 추가하여 [심층 상태 확인](sagemaker-hyperpod-eks-resiliency-deep-health-checks.md)를 활성화합니다.

   1. `NodeRecovery`의 경우 `Automatic`를 지정하여 자동 노드 복구를 활성화합니다. 상태 모니터링 에이전트에서 문제가 발견되면 SageMaker HyperPod가 인스턴스(노드)를 교체하거나 재부팅합니다.

   다음 코드 조각은 사용할 수 있는 JSON 요청 파일 템플릿입니다. 이 API의 요청 구문 및 파라미터에 대한 자세한 내용은 [UpdateCluster](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateCluster.html) API 참조를 참조하세요.

   ```
   // update_cluster.json
   {
       // Required
       "ClusterName": "{{name-of-cluster-to-update}}",
       // Required
       "InstanceGroups": [{
           "InstanceGroupName": {{"string"}},
           "InstanceType": {{"string"}},
           "InstanceCount": {{number}},
           "LifeCycleConfig": {
               "SourceS3Uri": {{"string"}},
               "OnCreate": {{"string"}}
           },
           "ExecutionRole": {{"string"}},
           "ThreadsPerCore": {{number}},
           "OnStartDeepHealthChecks": [
               {{"InstanceStress", "InstanceConnectivity"}}
           ]
       }],
       "NodeRecovery": "{{Automatic}}"
   }
   ```

1. 다음 `update-cluster` 명령을 실행하여 요청을 제출합니다.

   ```
   aws sagemaker update-cluster \
       --cli-input-json {{file://complete/path/to/update_cluster.json}}
   ```