1.3. Red Hat Edge Manager 에이전트의 must-gather 절차
장치에서 Red Hat Edge Manager 에이전트를 디버깅하려면plane ctl-must-gather
명령을 사용할 수 있습니다.
필수 액세스: 클러스터 관리자
다음 절차를 참조하십시오.
- 디버그할 장치에서 다음 명령을 실행합니다.
sudo flightctl-must-gather
sudo flightctl-must-gather
1.3.1. 호스트 클러스터의 must-gather 링크 복사링크가 클립보드에 복사되었습니다!
호스팅된 컨트롤 플레인 클러스터에 문제가 발생하는 경우 must-gather
명령을 실행하여 문제 해결에 도움이 되는 정보를 수집할 수 있습니다.
1.3.1.1. 호스팅된 클러스터의 must-gather 명령 정보 링크 복사링크가 클립보드에 복사되었습니다!
명령은 관리 클러스터 및 호스팅된 클러스터에 대한 출력을 생성합니다.
다중 클러스터 엔진 Operator 허브 클러스터의 데이터:
- 클러스터 범위 리소스: 이러한 리소스는 관리 클러스터의 노드 정의입니다.
-
hypershift-dump
압축 파일: 이 파일은 다른 사용자와 콘텐츠를 공유해야 하는 경우에 유용합니다. - 네임스페이스 리소스: 이러한 리소스에는 구성 맵, 서비스, 이벤트 및 로그와 같은 관련 네임스페이스의 모든 오브젝트가 포함됩니다.
- 네트워크 로그: 이 로그에는 OVN northbound 및 southbound 데이터베이스와 각각에 대한 상태가 포함됩니다.
- 호스트 클러스터: 이 수준의 출력에는 호스팅된 클러스터 내부의 모든 리소스가 포함됩니다.
호스트 클러스터의 데이터:
- 클러스터 범위 리소스: 이러한 리소스에는 노드 및 CRD와 같은 모든 클러스터 전체 오브젝트가 포함됩니다.
- 네임스페이스 리소스: 이러한 리소스에는 구성 맵, 서비스, 이벤트 및 로그와 같은 관련 네임스페이스의 모든 오브젝트가 포함됩니다.
출력에 클러스터의 보안 오브젝트가 포함되어 있지 않지만 시크릿 이름에 대한 참조를 포함할 수 있습니다.
1.3.1.2. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
must-gather 명령을 실행하여 정보를 수집하려면 다음 사전 요구 사항을 충족해야 합니다.
-
kubeconfig
파일이 로드되고 다중 클러스터 엔진 Operator 허브 클러스터를 가리키는지 확인해야 합니다. - 다중 클러스터 엔진 Operator 허브 클러스터에 대한 cluster-admin 액세스 권한이 있어야 합니다.
-
HostedCluster
리소스의 name 값과 사용자 정의 리소스가 배포된 네임스페이스가 있어야 합니다.
1.3.1.3. 호스트된 클러스터에 대한 must-gather 명령 입력 링크 복사링크가 클립보드에 복사되었습니다!
호스트된 클러스터에 대한 정보를 수집하려면 다음 명령을 입력합니다. 명령에서
hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE
매개변수는 선택 사항입니다. 포함하지 않으면 호스트 클러스터가 기본 네임스페이스인 것처럼 명령이실행됩니다
.oc adm must-gather --image=quay.io/stolostron/backplane-must-gather:SNAPSHOTNAME /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME
oc adm must-gather --image=quay.io/stolostron/backplane-must-gather:SNAPSHOTNAME /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 명령 결과를 압축 파일에 저장하려면
NAME
을 결과를 저장하려는 디렉터리 이름으로 교체하여--dest-dir=NAME
매개변수를 포함합니다.oc adm must-gather --image=quay.io/stolostron/backplane-must-gather:SNAPSHOTNAME /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME --dest-dir=NAME ; tar -cvzf NAME.tgz NAME
oc adm must-gather --image=quay.io/stolostron/backplane-must-gather:SNAPSHOTNAME /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME --dest-dir=NAME ; tar -cvzf NAME.tgz NAME
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.3.1.4. 연결이 끊긴 환경에서 must-gather 명령 입력 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 must-gather
명령을 실행하려면 다음 단계를 완료합니다.
- 연결이 끊긴 환경에서 Red Hat Operator 카탈로그 이미지를 미러 레지스트리에 미러링합니다. 자세한 내용은 연결이 끊긴 네트워크 환경에서 설치를 참조하십시오.
다음 명령을 실행하여 미러 레지스트리에서 이미지를 참조하는 로그를 추출합니다.
REGISTRY=registry.example.com:5000 IMAGE=$REGISTRY/multicluster-engine/must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8 oc adm must-gather --image=$IMAGE /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME --dest-dir=./data
REGISTRY=registry.example.com:5000 IMAGE=$REGISTRY/multicluster-engine/must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8 oc adm must-gather --image=$IMAGE /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME --dest-dir=./data
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.3.1.5. 추가 리소스 링크 복사링크가 클립보드에 복사되었습니다!
- 호스트된 컨트롤 플레인 문제 해결에 대한 자세한 내용은 OpenShift Container Platform 설명서의 호스트된 컨트롤 플레인 문제 해결을 참조하십시오.