워크로드 클러스터에 대한 시스템 상태 점검 관리

이 항목에서는 Tanzu Kubernetes Grid에서 생성된 워크로드 클러스터에 대한 MachineHealthCheck 개체를 생성, 업데이트, 검색, 삭제하는 데 Tanzu CLI(명령줄 인터페이스)를 사용하는 방법을 설명합니다.

자세한 내용은 Tanzu CLI 명령 참조에서 tanzu cluster machinehealthcheck를 참조하십시오.

참고

Tanzu CLI v1.6 이상은 제어부 및 워크로드 노드 모두에 대한 시스템 상태 점검을 지원하기 위해 tanzu cluster machinehealthcheck set/get/delete 명령을 tanzu cluster machinehealthcheck control-plane set/get/delete 및 tanzu cluster machinehealthcheck node set/get/delete 명령으로 대체합니다. tanzu cluster machinehealthcheck set/get/delete 명령은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

MachineHealthCheck 정보

MachineHealthCheck 시스템에 대한 상태 모니터링 및 자동 복구를 제공하는 컨트롤러입니다. 제어부 및 작업자 노드 모두에 대해 모든 관리 및 워크로드 클러스터에서 자동으로 사용하도록 설정되어 있습니다. 클러스터를 배포할 때 컨트롤러를 사용하도록 설정하면 Tanzu Kubernetes Grid는 클러스터에 두 개의 기본 MachineHealthCheck 개체를 생성합니다. 하나는 제어부 노드용이고 작업자 노드용입니다. 이러한 개체는 클러스터와 동일한 네임스페이스에 생성된 것입니다.

컨트롤러를 비활성화하는 경우 MachineHealthCheck 개체 생성 또는 업데이트 섹션에 있는 명령을 사용하여 다시 사용하도록 설정할 수 있습니다. 이 명령을 사용하여 기존 MachineHealthCheck 개체를 업데이트할 수도 있습니다.

MachineHealthCheck 개체 생성 또는 업데이트

기본 MachineHealthCheck 개체를 생성하려면 다음을 수행합니다.

• 클러스터의 제어부의 경우 다음을 실행합니다.

  tanzu cluster machinehealthcheck control-plane set CLUSTER-NAME --mhc-name MHC-NAME
  

• 클러스터의 Worker 노드의 경우 다음을 실행합니다.

  tanzu cluster machinehealthcheck node set CLUSTER-NAME --mhc-name MHC-NAME
  

형식 설명:

• CLUSTER-NAME은 대상 클러스터의 이름입니다.
• MHC-NAME은 MachineHealthCheck 개체에 선택하는 이름입니다. 지정하지 않으면 이름은 CLUSTER-NAME으로 설정되어 있습니다. 이러한 두 명령을 모두 실행하는 경우 --mhc-name을 지정해야 합니다.

또한 위 명령을 사용하여 사용자 지정된 MachineHealthCheck 개체를 생성하거나 기존 MachineHealthCheck 개체를 업데이트할 수 있습니다. MachineHealthCheck 개체를 사용자 지정하거나 업데이트하려면 다음 플래그 중 하나 이상을 지정할 수 있습니다.

• --match-labels: 이 옵션은 레이블 키 및 값을 기준으로 시스템을 필터링합니다. 레이블 제약 조건을 하나 이상 지정할 수 있습니다. MachineHealthCheck 개체는 지정된 제약 조건을 충족하는 모든 시스템에 적용되어 있습니다. 다음과 같이 키-값 쌍의 형식을 지정합니다.

  tanzu cluster machinehealthcheck control-plane set CLUSTER-NAME --mhc-name MHC-NAME --match-labels "key1:value1,key2:value2"
  tanzu cluster machinehealthcheck node set CLUSTER-NAME --mhc-name MHC-NAME --match-labels "key1:value1,key2:value2"
  

• --node-startup-timeout: 이 옵션은 시스템 비정상 상태를 고려하기 전에 MachineHealthCheck 컨트롤러가 시스템이 클러스터에 가입할 때까지 대기하는 시간을 제어합니다. 예를 들어 아래 명령은 --node-startup-timeout 옵션을 21m으로 설정합니다.

  tanzu cluster machinehealthcheck control-plane set my-cluster --mhc-name my-control-plane-mhc --node-startup-timeout 21m
  tanzu cluster machinehealthcheck node set my-cluster --mhc-name my-worker-mhc --node-startup-timeout 21m
  

  지정된 시간 내에 시스템이 클러스터에 가입하지 못하면 MachineHealthCheck 컨트롤러가 시스템을 다시 생성합니다.

• --unhealthy-conditions: 이 옵션은 Ready, MemoryPressure, DiskPressure, PIDPressure, NetworkUnavailable 조건을 설정할 수 있습니다. MachineHealthCheck 컨트롤러는 사용자가 설정한 조건을 사용하여 제어부 및 작업자 노드의 상태를 모니터링합니다. 조건의 상태를 설정하려면 True, False 또는 Unknown을 사용합니다. 예:

  tanzu cluster machinehealthcheck control-plane set my-cluster --mhc-name my-control-plane-mhc --unhealthy-conditions "Ready:False:5m,Ready:Unknown:5m"
  tanzu cluster machinehealthcheck node set my-cluster --mhc-name my-worker-mhc --unhealthy-conditions "Ready:False:5m,Ready:Unknown:5m"
  

  위 예에서는 Ready 조건을 False:5m 및 Unknown:5m으로 설정합니다. 시스템이 5m 이상인 Unknown 또는 False 상태에 있는 경우, MachineHealthCheck 컨트롤러는 시스템을 비정상 상태로 간주하고 다시 생성합니다.

MachineHealthCheck 개체 검색

MachineHealthCheck 개체를 검색하려면 다음을 수행합니다.

• 대상 클러스터의 제어부의 경우 다음을 실행합니다.

  tanzu cluster machinehealthcheck control-plane get CLUSTER-NAME --mhc-name MHC-NAME
  

  개체가 기본 이름으로 생성된 경우 --mhc-name 플래그를 생략할 수 있습니다.

• 대상 클러스터의 Worker 노드의 경우 다음을 실행합니다.

  tanzu cluster machinehealthcheck node get CLUSTER-NAME --mhc-name MHC-NAME
  

  개체가 기본 이름으로 생성된 경우 --mhc-name 플래그를 생략할 수 있습니다.

MachineHealthCheck 개체 삭제

MachineHealthCheck 개체를 삭제하려면 다음을 수행합니다.

• 대상 클러스터의 제어부의 경우 다음을 실행합니다.

  tanzu cluster machinehealthcheck control-plane delete CLUSTER-NAME --mhc-name MHC-NAME
  

  개체가 기본 이름으로 생성된 경우 --mhc-name 플래그를 생략할 수 있습니다.

• 대상 클러스터의 Worker 노드의 경우 다음을 실행합니다.

  tanzu cluster machinehealthcheck node delete CLUSTER-NAME --mhc-name MHC-NAME
  

  개체가 기본 이름으로 생성된 경우 --mhc-name 플래그를 생략할 수 있습니다.