1.2. 문제를 해결하기 위해 must-gather 명령 실행
문제 해결을 시작하려면 사용자가 must-gather 명령을 실행하여 문제를 디버깅할 수 있는 문제 해결 시나리오에 대해 알아보고 명령을 사용하여 시작하는 절차를 참조하십시오.
필수 액세스 권한: 클러스터 관리자
1.2.1. must-gather 시나리오
시나리오 1: 문제 해결 방법에 대한 자세한 내용은 문서화된 문제 해결 섹션을 참조하십시오. 이 가이드는 제품의 주요 기능에 따라 구성됩니다.
이 시나리오에서는 가이드에서 해결 방법이 문서에 있는지 확인합니다. 예를 들어 클러스터 생성에 문제가 있는 경우 클러스터 관리 섹션에서 해결 방법을 찾을 수 있습니다.
-
시나리오 2: 해결 단계에 문제가 문서화되지 않은 경우
must-gather명령을 실행하고 출력을 사용하여 문제를 디버깅합니다. -
시나리오 3:
must-gather명령의 출력을 사용하여 문제를 디버깅할 수 없는 경우 Red Hat 지원과 출력을 공유하십시오.
1.2.2. must-gather 절차
must-gather 명령 사용을 시작하려면 다음 절차를 참조하십시오.
-
must-gather명령에 대해 알아보고 Red Hat OpenShift Container Platform 설명서에서 클러스터에 대한 데이터를 수집하는 데 필요한 사전 요구 사항을 설치합니다. 클러스터에 로그인합니다. 데이터 및 디렉터리를 수집하는 데 사용되는 Kubernetes용 Red Hat Advanced Cluster Management를 추가합니다. 출력에 대한 이미지와 디렉터리를 삽입한 다음 명령을 실행합니다.
oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel8:v2.5.0 --dest-dir=<directory>
일반적인 사용 사례의 경우 허브 클러스터에 로그인하는 동안
must-gather를 실행해야 합니다.참고: 관리 클러스터를 확인하려면
cluster-scoped-resources디렉터리에 있는gather-managed.log파일을 찾습니다.<your-directory>/cluster-scoped-resources/gather-managed.log>
iPXEED 및 AVAILABLE 열에
True가 설정되지 않은 관리형 클러스터가 있는지 확인합니다.True상태로 연결되지 않은 클러스터에서must-gather명령을 실행할 수 있습니다.지정된 디렉터리로 이동하여 다음 수준으로 구성된 출력을 확인합니다.
-
두 개의 피어 수준:
cluster-scoped-resources및namespace리소스입니다. - 각 하위 수준: 클러스터 범위 및 네임스페이스 범위 리소스의 사용자 정의 리소스 정의의 API 그룹입니다.
-
각각에 대한 다음 수준: YAML 파일은
종류별로 정렬됩니다.
-
두 개의 피어 수준:
1.2.3. 연결이 끊긴 환경의 must-gather
연결이 끊긴 환경에서 must-gather 명령을 실행하려면 다음 단계를 완료합니다.
- 연결이 끊긴 환경에서 Red Hat Operator 카탈로그 이미지를 미러 레지스트리에 미러링합니다. 자세한 내용은 연결이 끊긴 네트워크에 설치를 참조하십시오.
- 다음 명령을 실행하여 미러 레지스트리에서 이미지를 참조하는 로그를 추출합니다.
REGISTRY=registry.example.com:5000 IMAGE=$REGISTRY/rhacm2/acm-must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8 oc adm must-gather --image=$IMAGE --dest-dir=./data
