Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

18.9. 토폴로지 Aware Lifecycle Manager 문제 해결

TALM(토폴로지 라이프사이클 관리자)은 RHACM 정책을 해결하는 OpenShift Container Platform Operator입니다. 문제가 발생하면 oc adm must-gather 명령을 사용하여 세부 정보 및 로그를 수집하고 문제를 디버깅하는 단계를 수행합니다.

관련 항목에 대한 자세한 내용은 다음 문서를 참조하십시오.

18.9.1. 일반 문제 해결

다음 질문을 검토하여 문제의 원인을 확인할 수 있습니다.

ClusterGroupUpgrade 구성이 작동하는지 확인하려면 다음을 수행합니다.

  1. spec.enable 필드를 false 로 설정하여 ClusterGroupUpgrade CR을 생성합니다.
  2. 상태가 업데이트될 때까지 기다린 후 문제 해결 질문을 진행합니다.
  3. 모든 항목이 예상대로 표시되면 ClusterGroupUpgrade CR에서 spec.enable 필드를 true 로 설정합니다.
주의

ClusterUpgradeGroup CR에서 spec.enable 필드를 true 로 설정한 후 업데이트 절차가 시작되고 CR의 spec 필드를 더 이상 편집할 수 없습니다.

18.9.2. ClusterUpgradeGroup CR을 수정할 수 없습니다.

문제
업데이트를 활성화한 후에는 ClusterUpgradeGroup CR을 편집할 수 없습니다.
해결

다음 단계를 수행하여 절차를 다시 시작하십시오.

  1. 다음 명령을 실행하여 이전 ClusterGroupUpgrade CR을 제거합니다.

    Copy to Clipboard Toggle word wrap 
    $ oc delete cgu -n <ClusterGroupUpgradeCR_namespace> <ClusterGroupUpgradeCR_name>

  2. 관리 클러스터 및 정책의 기존 문제를 확인하고 수정합니다.

    1. 모든 클러스터가 관리 클러스터이고 사용 가능한지 확인합니다.
    2. 모든 정책이 존재하고 spec.remediationAction 필드가 inform 로 설정되어 있는지 확인합니다.

  3. 올바른 구성으로 새 ClusterGroupUpgrade CR을 생성합니다.

    Copy to Clipboard Toggle word wrap 
    $ oc apply -f <ClusterGroupUpgradeCR_YAML>

18.9.3. 관리형 정책

시스템에서 관리 정책 확인

문제
시스템에 올바른 관리 정책이 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -ojsonpath='{.spec.managedPolicies}'

출력 예

Copy to Clipboard Toggle word wrap 
["group-du-sno-validator-du-validator-policy", "policy2-common-nto-sub-policy", "policy3-common-ptp-sub-policy"]

수정 모드 확인

문제
관리 정책의 사양 을 알리기 위해 remediationAction 필드가 설정되어 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get policies --all-namespaces

출력 예

Copy to Clipboard Toggle word wrap 
NAMESPACE   NAME                                                 REMEDIATION ACTION   COMPLIANCE STATE   AGE
default     policy1-common-cluster-version-policy                inform               NonCompliant       5d21h
default     policy2-common-nto-sub-policy                        inform               Compliant          5d21h
default     policy3-common-ptp-sub-policy                        inform               NonCompliant       5d21h
default     policy4-common-sriov-sub-policy                      inform               NonCompliant       5d21h

정책 규정 준수 상태 확인

문제
정책의 규정 준수 상태를 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get policies --all-namespaces

출력 예

Copy to Clipboard Toggle word wrap 
NAMESPACE   NAME                                                 REMEDIATION ACTION   COMPLIANCE STATE   AGE
default     policy1-common-cluster-version-policy                inform               NonCompliant       5d21h
default     policy2-common-nto-sub-policy                        inform               Compliant          5d21h
default     policy3-common-ptp-sub-policy                        inform               NonCompliant       5d21h
default     policy4-common-sriov-sub-policy                      inform               NonCompliant       5d21h

18.9.4. 클러스터

관리 클러스터가 있는지 확인
문제
ClusterGroupUpgrade CR의 클러스터가 관리 클러스터인지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get managedclusters

출력 예

Copy to Clipboard Toggle word wrap 
NAME            HUB ACCEPTED   MANAGED CLUSTER URLS                    JOINED   AVAILABLE   AGE
local-cluster   true           https://api.hub.example.com:6443        True     Unknown     13d
spoke1          true           https://api.spoke1.example.com:6443     True     True        13d
spoke3          true           https://api.spoke3.example.com:6443     True     True        27h

  1. 또는 TALM 관리자 로그를 확인합니다.

    1. 다음 명령을 실행하여 TALM 관리자의 이름을 가져옵니다.

      Copy to Clipboard Toggle word wrap 
      $ oc get pod -n openshift-operators

      출력 예

      Copy to Clipboard Toggle word wrap 
      NAME                                                         READY   STATUS    RESTARTS   AGE
cluster-group-upgrades-controller-manager-75bcc7484d-8k8xp   2/2     Running   0          45m

    2. 다음 명령을 실행하여 TALM 관리자 로그를 확인합니다.

      Copy to Clipboard Toggle word wrap 
      $ oc logs -n openshift-operators \
cluster-group-upgrades-controller-manager-75bcc7484d-8k8xp -c manager

      출력 예

      Copy to Clipboard Toggle word wrap 
      ERROR	controller-runtime.manager.controller.clustergroupupgrade	Reconciler error	{"reconciler group": "ran.openshift.io", "reconciler kind": "ClusterGroupUpgrade", "name": "lab-upgrade", "namespace": "default", "error": "Cluster spoke5555 is not a ManagedCluster"}
      1 
      
sigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).processNextWorkItem

      1
      오류 메시지는 클러스터가 관리 클러스터가 아님을 나타냅니다.
관리 클러스터를 사용할 수 있는지 확인
문제
ClusterGroupUpgrade CR에 지정된 관리 클러스터를 사용할 수 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get managedclusters

출력 예

Copy to Clipboard Toggle word wrap 
NAME            HUB ACCEPTED   MANAGED CLUSTER URLS                    JOINED   AVAILABLE   AGE
local-cluster   true           https://api.hub.testlab.com:6443        True     Unknown     13d
spoke1          true           https://api.spoke1.testlab.com:6443     True     True        13d
1 

spoke3          true           https://api.spoke3.testlab.com:6443     True     True        27h
2

1 2
AVAILABLE 필드의 값은 관리 클러스터에 대해 True 입니다.
clusterSelector 확인
문제
관리 클러스터 중 하나 이상에서 clusterSelector 필드가 ClusterGroupUpgrade CR에 지정되어 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get managedcluster --selector=upgrade=true
1
1
업데이트하려는 클러스터의 레이블은 upgrade:true 입니다.

출력 예

Copy to Clipboard Toggle word wrap 
NAME            HUB ACCEPTED   MANAGED CLUSTER URLS                     JOINED    AVAILABLE   AGE
spoke1          true           https://api.spoke1.testlab.com:6443      True     True        13d
spoke3          true           https://api.spoke3.testlab.com:6443      True     True        27h

카나리아 클러스터가 있는지 확인
문제

클러스터 목록에 카나리아 클러스터가 있는지 확인하려고 합니다.

ClusterGroupUpgrade CR의 예

Copy to Clipboard Toggle word wrap 
spec:
    clusters:
    - spoke1
    - spoke3
    clusterSelector:
    - upgrade2=true
    remediationStrategy:
        canaries:
        - spoke3
        maxConcurrency: 2
        timeout: 240

해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -ojsonpath='{.spec.clusters}'

출력 예

Copy to Clipboard Toggle word wrap 
["spoke1", "spoke3"]

  1. 다음 명령을 실행하여 clusterSelector 레이블과 일치하는 클러스터 목록에 카나리아 클러스터가 있는지 확인합니다.

    Copy to Clipboard Toggle word wrap 
    $ oc get managedcluster --selector=upgrade=true

    출력 예

    Copy to Clipboard Toggle word wrap 
    NAME            HUB ACCEPTED   MANAGED CLUSTER URLS   JOINED    AVAILABLE   AGE
spoke1          true           https://api.spoke1.testlab.com:6443   True     True        13d
spoke3          true           https://api.spoke3.testlab.com:6443   True     True        27h

참고

클러스터는 spec.clusters 에 있을 수 있으며 spec.clusterSelecter 레이블과 일치시킬 수도 있습니다.

스포크 클러스터에서 사전 캐싱 상태 확인

  1. 스포크 클러스터에서 다음 명령을 실행하여 사전 캐싱의 상태를 확인합니다.

    Copy to Clipboard Toggle word wrap 
    $ oc get jobs,pods -n openshift-talo-pre-cache

18.9.5. 수정 전략

ClusterGroupUpgrade CR에 remediationStrategy가 있는지 확인
문제
ClusterGroupUpgrade CR에 remediationStrategy 가 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -ojsonpath='{.spec.remediationStrategy}'

출력 예

Copy to Clipboard Toggle word wrap 
{"maxConcurrency":2, "timeout":240}

ClusterGroupUpgrade CR에 maxConcurrency가 지정되었는지 확인
문제
maxConcurrency 가 ClusterGroupUpgrade CR에 지정되어 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -ojsonpath='{.spec.remediationStrategy.maxConcurrency}'

출력 예

Copy to Clipboard Toggle word wrap 
2

18.9.6. 토폴로지 수명 주기 관리자

ClusterGroupUpgrade CR에서 조건 메시지 및 상태 확인
문제
ClusterGroupUpgrade CR에서 status.conditions 필드 값을 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -ojsonpath='{.status.conditions}'

출력 예

Copy to Clipboard Toggle word wrap 
{"lastTransitionTime":"2022-02-17T22:25:28Z", "message":"The ClusterGroupUpgrade CR has managed policies that are missing:[policyThatDoesntExist]", "reason":"UpgradeCannotStart", "status":"False", "type":"Ready"}

복사된 정책 확인
문제
status.managedPoliciesForUpgrade 의 모든 정책에 해당 정책이 status.copiedPolicies 에 있는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -oyaml

출력 예

Copy to Clipboard Toggle word wrap 
status:
  …
  copiedPolicies:
  - lab-upgrade-policy3-common-ptp-sub-policy
  managedPoliciesForUpgrade:
  - name: policy3-common-ptp-sub-policy
    namespace: default

status.remediationPlan이 계산되었는지 확인
문제
status.remediationPlan 이 계산되었는지 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc get cgu lab-upgrade -ojsonpath='{.status.remediationPlan}'

출력 예

Copy to Clipboard Toggle word wrap 
[["spoke2", "spoke3"]]

TALM 관리자 컨테이너의 오류
문제
TALM의 관리자 컨테이너의 로그를 확인하려고 합니다.
해결

다음 명령을 실행합니다.

Copy to Clipboard Toggle word wrap 
$ oc logs -n openshift-operators \
cluster-group-upgrades-controller-manager-75bcc7484d-8k8xp -c manager

출력 예

Copy to Clipboard Toggle word wrap 
ERROR	controller-runtime.manager.controller.clustergroupupgrade	Reconciler error	{"reconciler group": "ran.openshift.io", "reconciler kind": "ClusterGroupUpgrade", "name": "lab-upgrade", "namespace": "default", "error": "Cluster spoke5555 is not a ManagedCluster"}
1 

sigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).processNextWorkItem

1
오류를 표시합니다.

추가 리소스

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat, Inc.