1.3. 확인된 문제
애플리케이션 관리에 대해 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
클러스터 관리 또는 클러스터 라이프사이클 은 {produt-title-short}을 사용하거나 사용하지 않고 다중 클러스터 엔진 Operator에서 제공합니다. {produt-title-short}에만 적용되는 클러스터 관리의 알려진 문제 및 제한 사항을 참조하십시오. 대부분의 클러스터 관리 알려진 문제는 클러스터 라이프 사이클의 알려진 문제의 클러스터 수명 문서에 있습니다.
1.3.1. 설치 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
설치에 대해 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제[OpenShift Container Platform 알려진 문제]를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
1.3.1.1. 에라타 릴리스로 업그레이드한 후에도 더 이상 사용되지 않는 리소스는 유지됩니다. 링크 복사링크가 클립보드에 복사되었습니다!
2.4.x에서 2.5.x로 업그레이드한 다음 2.6.x로 업그레이드한 후 관리형 클러스터 네임스페이스의 더 이상 사용되지 않는 리소스가 남아 있을 수 있습니다. 버전 2.6.x가 2.4.x에서 업그레이드된 경우 더 이상 사용되지 않는 리소스를 수동으로 삭제해야 합니다.
참고: 버전 2.5.x에서 버전 2.6.x로 업그레이드하기 전에 30분 이상을 기다려야 합니다.
콘솔에서 삭제하거나 삭제하려는 리소스에 대해 다음 예와 유사한 명령을 실행할 수 있습니다.
oc delete -n <managed cluster namespace> managedclusteraddons.addon.open-cluster-management.io <resource-name>
남아 있는 더 이상 사용되지 않는 리소스 목록을 참조하십시오.
managedclusteraddons.addon.open-cluster-management.io:
policy-controller
manifestworks.work.open-cluster-management.io:
-klusterlet-addon-appmgr
-klusterlet-addon-certpolicyctrl
-klusterlet-addon-crds
-klusterlet-addon-iampolicyctrl
-klusterlet-addon-operator
-klusterlet-addon-policyctrl
-klusterlet-addon-workmgr
1.3.1.2. Red Hat Advanced Cluster Management를 업그레이드한 후에는 Pod가 백업되지 않을 수 있습니다. 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Advanced Cluster Management를 새 버전으로 업그레이드한 후 StatefulSet 에 속하는 일부 Pod는 failed 상태로 유지될 수 있습니다. 이 드물게 발생하는 경우는 알려진 Kubernetes 문제로 인해 발생합니다.
이 문제에 대한 해결 방법으로 실패한 Pod를 삭제합니다. Kubernetes는 올바른 설정으로 자동으로 다시 시작됩니다.
1.3.1.3. OpenShift Container Platform 클러스터 업그레이드 실패 상태 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터가 업그레이드 단계에 있는 경우 클러스터 Pod가 재시작되고 클러스터가 1-5분의 변형에 대해 업그레이드 실패 상태로 남아 있을 수 있습니다. 이 동작은 예상되고 몇 분 후에 해결됩니다.
1.3.1.4. 작동하지 않는 MultiClusterEngine 버튼 생성 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Container Platform 콘솔에서 Kubernetes용 Red Hat Advanced Cluster Management for Kubernetes를 설치하면 다음 메시지가 포함된 팝업 창이 표시됩니다.
MultiClusterEngine required
이 Operator를 사용할 MultiClusterEngine 인스턴스를 생성합니다.
팝업 창의 Create MultiClusterEngine 버튼이 작동하지 않을 수 있습니다. 이 문제를 해결하려면 Provided APIs 섹션의 MultiClusterEngine 타일에서 인스턴스 생성을 선택합니다.
1.3.2. 비즈니스 연속성 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
Kubernetes용 Red Hat Advanced Cluster Management의 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제[OpenShift Container Platform 알려진 문제]를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
1.3.2.1. 알려진 문제 백업 및 복원 링크 복사링크가 클립보드에 복사되었습니다!
1.3.2.1.1. hub 클러스터 백업 및 복원 중에 cluster-proxy-addon 실패 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Advanced Cluster Management Hub 클러스터를 백업하고 제거하고 동일한 클러스터에 다시 설치한 다음 복원하면 cluster-proxy-addon 이 작동하지 않습니다. Pod 로그에서 다음 오류 메시지가 표시됩니다.
E0430 19:11:20.810624 1 clientset.go:188] "cannot connect once" err="rpc error: code = Unavailable desc = connection error: desc = \"transport: authentication handshake failed: tls: failed to verify certificate: x509: certificate signed by unknown authority\""
이 문제를 해결하려면 다음 단계를 완료합니다.
다음 명령을 실행하여
cluster-proxy-addon을 비활성화합니다.oc patch mce multiclusterengine --type=merge -p '{"spec":{"overrides":{"components":[ {"name":"cluster-proxy-addon","enabled": false} ]}}}'다음 명령을 실행하여
cluster-proxy-addon을 다시 설치합니다.oc patch mce multiclusterengine --type=merge -p '{"spec":{"overrides":{"components":[ {"name":"cluster-proxy-addon","enabled": true} ]}}}'
1.3.2.1.2. 관리 클러스터 백업에서 더 이상 베어 메탈 허브 리소스를 백업하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Advanced Cluster Management 백업 및 복원 기능을 사용하여 베어 메탈 클러스터의 리소스를 백업하고 보조 허브 클러스터로 복원하는 경우 관리 클러스터는 기존 관리 클러스터를 삭제하는 노드에 다시 설치됩니다.
참고: 이는 제로 터치 프로비저닝을 사용하여 배포된 베어 메탈 클러스터에만 영향을 미칩니다. 즉, 베어 메탈 노드의 전원을 켜거나 끄고 부팅하기 위한 가상 미디어를 관리하는 BareMetalHost 리소스가 있습니다. 관리 클러스터 배포에 BareMetalHost 리소스를 사용하지 않은 경우 부정적인 영향을 미치지 않습니다.
이 문제를 해결하기 위해 기본 허브 클러스터의 BareMetalHost 리소스는 더 이상 관리 클러스터 백업과 함께 백업되지 않습니다.
다른 사용 사례가 있고 기본 허브 클러스터의 관리 BareMetalHost 리소스를 백업하려면 기본 허브 클러스터의 BareMetalHost 리소스에 다음 backup 레이블을 추가합니다. cluster.open-cluster-management.io/backup.
일반 리소스를 백업하는 데 이 백업 레이블을 사용하는 방법에 대한 자세한 내용은 백업되는 리소스 항목을 참조하십시오.
1.3.2.1.3. BackupSchedule 은 OADP 1.1.2 이상을 사용할 때 FailedValidation 상태를 표시합니다. 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Advanced Cluster Management 백업 및 복원 구성 요소를 활성화하고 DataProtectionApplication 리소스를 성공적으로 생성하면 BackupStorageLocation 리소스가 Available 상태로 생성됩니다. OADP 버전 1.1.2 이상을 사용하는 경우 BackupSchedule 리소스를 생성하고 상태가 FailedValidation 인 후 다음 메시지가 표시될 수 있습니다.
oc get backupschedule -n open-cluster-management-backup
NAME PHASE MESSAGE
rosa-backup-schedule FailedValidation Backup storage location is not available. Check velero.io.BackupStorageLocation and validate storage credentials.
이 오류는 BackupStorageLocation 리소스에서 ownerReference 에 대한 누락된 값으로 인해 발생합니다. DataProtectionApplication 리소스의 값은 ownerReference 의 값으로 사용해야 합니다.
이 문제를 해결하려면 BackupStorageLocation 에 ownerReference 를 수동으로 추가합니다.
다음 명령을 실행하여
oadp-operator.v1.1.2파일을 엽니다.oc edit csv -n open-cluster-management-backup oadp-operator.v1.1.2-
OADP Operator CSV에서
1을0으로 교체하여spec.deployments.label.spec.replicas값을 편집합니다. 다음 예와 같이 YAML 스크립트의
ownerReference주석을 패치합니다.metadata: resourceVersion: '273482' name: dpa-sample-1 uid: 4701599a-cdf5-48ac-9264-695a95b935a0 namespace: open-cluster-management-backup ownerReferences: << apiVersion: oadp.openshift.io/v1alpha1 blockOwnerDeletion: true controller: true kind: DataProtectionApplication name: dpa-sample uid: 52acd151-52fd-440a-a846-95a0d7368ff7-
spec.deployments.label.spec.replicas값을1로 변경하여 새 설정으로 데이터 보호 애플리케이션 프로세스를 시작합니다.
1.3.2.1.4. Velero 복원 제한 사항 링크 복사링크가 클립보드에 복사되었습니다!
새 hub 클러스터에 데이터가 복원되는 새 허브 클러스터의 경우 사용자가 생성한 리소스가 있는 경우 활성 허브 클러스터와 다른 구성이 있을 수 있습니다. 예를 들어 새 허브 클러스터에서 백업 데이터를 복원하기 전에 새 허브 클러스터에서 생성된 기존 정책을 포함할 수 있습니다.
복원된 백업의 일부가 아닌 경우 Velero 리소스를 건너뛰므로 새 허브 클러스터에 대한 정책은 변경되지 않고 새 hub 클러스터와 활성 허브 클러스터 간에 다른 구성이 생성됩니다.
이 제한을 해결하기 위해 클러스터 백업 및 복원 Operator는 restore.cluster.open-cluster-management.io 리소스가 생성될 때 사용자 또는 다른 복원 작업에서 생성한 리소스를 정리하기 위해 사후 복원 작업을 실행합니다.
자세한 내용은 백업 설치 및 복원 연산자 항목을 참조하십시오.
1.3.2.1.5. 수동 구성에서 관리 클러스터를 표시하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
관리형 클러스터는 수동 허브 클러스터에서 활성화 데이터가 복원된 경우에만 표시됩니다.
1.3.2.1.6. 관리 클러스터 리소스가 복원되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
로컬 클러스터 관리 클러스터 리소스의 설정을 복원하고 새 허브 클러스터에서 로컬 클러스터 데이터를 덮어쓰면 설정이 잘못 구성됩니다. 리소스에 클러스터 URL 세부 정보와 같은 로컬 클러스터 특정 정보가 포함되어 있기 때문에 이전 허브 클러스터 의 콘텐츠가 백업되지 않습니다.
local- cluster
복원된 클러스터에서 로컬 클러스터 리소스와 관련된 구성 변경 사항을 수동으로 적용해야 합니다. 백업 설치 및 복원 Operator 항목에서 새 허브 클러스터 준비를 참조하십시오.
1.3.2.1.7. 복원된 Hive 관리형 클러스터가 새 hub 클러스터와 연결되지 않을 수 있습니다. 링크 복사링크가 클립보드에 복사되었습니다!
Hive 관리 클러스터에 대해 변경되거나 순환된 인증 기관(CA)의 백업을 복원하면 새 허브 클러스터에서 관리 클러스터가 새 허브 클러스터에 연결되지 않습니다. 이 관리된 클러스터에 대한 admin kubeconfig 시크릿은 더 이상 백업과 함께 사용할 수 없으므로 연결에 실패합니다.
새 허브 클러스터에서 관리 클러스터의 복원된 admin kubeconfig 시크릿을 수동으로 업데이트해야 합니다.
1.3.2.1.8. 가져온 관리 클러스터에 보류 중인 가져오기 상태가 표시됩니다. 링크 복사링크가 클립보드에 복사되었습니다!
기본 허브 클러스터에서 수동으로 가져온 관리형 클러스터에는 활성화 데이터가 수동 허브 클러스터에서 복원될 때 보류 중 상태가 표시됩니다. 자세한 내용은 관리형 서비스 계정을 사용하여 클러스터 연결을 참조하십시오.
1.3.2.1.9. hub 클러스터를 복원한 후 appliedmanifestwork 가 관리 클러스터에서 제거되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
새 hub 클러스터에서 hub 클러스터 데이터가 복원되면 수정된 클러스터 세트가 아닌 애플리케이션 서브스크립션에 대한 배치 규칙이 있는 관리형 클러스터에서 appliedmanifestwork 가 제거되지 않습니다.
고정된 클러스터 세트가 아닌 애플리케이션 서브스크립션에 대한 배치 규칙의 다음 예제를 참조하십시오.
spec:
clusterReplicas: 1
clusterSelector:
matchLabels:
environment: dev
결과적으로 관리 클러스터가 복원된 허브 클러스터에서 분리되면 애플리케이션이 분리됩니다.
문제를 방지하려면 배치 규칙에 고정된 클러스터 세트를 지정합니다. 다음 예제를 참조하십시오.
spec:
clusterSelector:
matchLabels:
environment: dev
다음 명령을 실행하여 나머지 appliedmanifestwork 를 수동으로 삭제할 수도 있습니다.
oc delete appliedmanifestwork <the-left-appliedmanifestwork-name>
1.3.2.1.10. appliedmanifestwork 가 제거되지 않고 hub 클러스터 배치 규칙에 고정된 클러스터 세트가 없습니다. 링크 복사링크가 클립보드에 복사되었습니다!
새 hub 클러스터에서 hub 클러스터 데이터가 복원되면 수정된 클러스터 세트가 아닌 애플리케이션 서브스크립션에 대한 배치 규칙이 있는 관리형 클러스터에서 appliedmanifestwork 가 제거되지 않습니다. 결과적으로 관리 클러스터가 복원된 허브 클러스터에서 분리되면 애플리케이션이 분리됩니다.
고정된 클러스터 세트가 아닌 애플리케이션 서브스크립션에 대한 배치 규칙의 다음 예제를 참조하십시오.
spec:
clusterReplicas: 1
clusterSelector:
matchLabels:
environment: dev
문제를 방지하려면 배치 규칙에 고정된 클러스터 세트를 지정합니다. 다음 예제를 참조하십시오.
spec:
clusterSelector:
matchLabels:
environment: dev
다음 명령을 실행하여 나머지 manifestwork 를 수동으로 삭제할 수도 있습니다.
oc delete appliedmanifestwork <the-left-appliedmanifestwork-name>
1.3.2.1.11. appliedmanifestwork 가 제거되지 않고 사양에서 agentID 가 누락되어 있습니다. 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Advanced Cluster Management 2.6을 기본 허브 클러스터로 사용하지만 복원 허브 클러스터가 2.7 이상 버전 2.7 이상이면 2.7 릴리스에 이 필드가 도입되므로 agentID 가 appliedmanifestworks 사양에 누락되어 있습니다. 이로 인해 관리 클러스터의 기본 허브에 대한 추가 적용된manifestworks 가 생성됩니다.
이 문제를 방지하려면 기본 허브 클러스터를 Red Hat Advanced Cluster Management 2.7로 업그레이드한 다음 새 hub 클러스터에서 백업을 복원합니다.
각 appliedmanifestwork 에 대해 spec.agentID 를 수동으로 설정하여 관리 클러스터를 수정합니다.
다음 명령을 실행하여
agentID를 가져옵니다.oc get klusterlet klusterlet -o jsonpath='{.metadata.uid}'다음 명령을 실행하여 각
appliedmanifestwork에spec.agentID를 설정합니다.oc patch appliedmanifestwork <appliedmanifestwork_name> --type=merge -p '{"spec":{"agentID": "'$AGENT_ID'"}}'
1.3.2.1.12. managed-serviceaccount 애드온 상태가 알 수 없음표시 링크 복사링크가 클립보드에 복사되었습니다!
새 허브 클러스터의 Kubernetes Operator 리소스에 대해 다중 클러스터 엔진에서 활성화하지 않고 관리형 서비스 계정을 사용하는 경우 관리형 클러스터 appliedmanifestwork addon-serviceaccount-deploy 가 가져온 관리 클러스터에서 제거됩니다.
관리 클러스터는 여전히 새 hub 클러스터로 가져오지만 managed-serviceaccount 애드온 상태가 표시됩니다.
다중 클러스터 엔진 Operator 리소스에서 Managed Service 계정을 활성화한 후 managed-serviceaccount 애드온을 복구할 수 있습니다. 관리형 서비스 계정을 활성화하는 방법을 알아보려면 자동 가져오기 활성화를 참조하십시오.
1.3.3. 콘솔 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
콘솔의 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
1.3.3.1. Search PostgreSQL pod가 CrashLoopBackoff 상태입니다. 링크 복사링크가 클립보드에 복사되었습니다!
search-postgres Pod는 CrashLoopBackoff 상태입니다. Red Hat Advanced Cluster Management가 hugepages 매개변수가 활성화된 노드가 있는 클러스터에 배포하고 search-postgres Pod가 이러한 노드에서 예약되는 경우 Pod가 시작되지 않습니다.
search-postgres Pod의 메모리를 늘리려면 다음 단계를 완료합니다.
다음 명령을 사용하여
search-operatorPod를 일시 중지합니다.oc annotate search search-v2-operator search-pause=truehugepages매개변수 제한으로search-postgres배포를 업데이트합니다. 다음 명령을 실행하여hugepages매개변수를512Mi로 설정합니다.oc patch deployment search-postgres --type json -p '[{"op": "add", "path": "/spec/template/spec/containers/0/resources/limits/hugepages-2Mi", "value":"512Mi"}]'Pod의 메모리 사용량을 확인하기 전에
search-postgres포드가Running상태인지 확인합니다. 다음 명령을 실행합니다.oc get pod <your-postgres-pod-name> -o jsonpath="Status: {.status.phase}"다음 명령을 실행하여
search-postgresPod의 메모리 사용량을 확인합니다.oc get pod <your-postgres-pod-name> -o jsonpath='{.spec.containers[0].resources.limits.hugepages-2Mi}'
다음 값이 512Mi 로 표시됩니다.
1.3.3.2. Firefox 이전 버전에서 콘솔 기능이 표시되지 않을 수 있음 링크 복사링크가 클립보드에 복사되었습니다!
이전 버전의 Firefox에 대한 다크 셰이크에 대한 알려진 문제가 있습니다. 최상의 콘솔 호환성을 위해 최신 버전으로 업그레이드합니다.
자세한 내용은 지원 브라우저를 참조하십시오.
1.3.3.3. 검색 사용자 지정의 스토리지 크기 제한 사항 링크 복사링크가 클립보드에 복사되었습니다!
searchcustomization CR에서 스토리지 크기를 업데이트하면 PVC 구성이 변경되지 않습니다. 스토리지 크기를 업데이트해야 하는 경우 다음 명령으로 PVC (<storageclassname>-search-redisgraph-0)를 업데이트합니다.
oc edit pvc <storageclassname>-search-redisgraph-0
1.3.3.4. 검색 쿼리 구문 분석 오류 링크 복사링크가 클립보드에 복사되었습니다!
환경이 커지고 스케일링에 대한 테스트가 더 필요한 경우 검색 쿼리가 시간 초과되어 오류 메시지 구문 분석 메시지가 표시될 수 있습니다. 이 오류는 검색 쿼리를 기다리는 동안 30초 후에 표시됩니다.
다음 명령을 사용하여 시간 초과를 확장합니다.
kubectl annotate route multicloud-console haproxy.router.openshift.io/timeout=Xs
1.3.3.5. 클러스터 세트의 네임스페이스 바인딩을 편집할 수 없음 링크 복사링크가 클립보드에 복사되었습니다!
admin 역할 또는 바인딩 역할로 설정된 클러스터의 네임스페이스 바인딩을 편집하면 다음 메시지와 유사한 오류가 발생할 수 있습니다.
ResourceError: managedclustersetbindings.cluster.open-cluster-management.io "<cluster-set>"는 허용되지 않습니다. 사용자 "<user>" cannot create/delete resource "managedclustersetbindings" in API group "cluster.open-cluster-management.io" in the namespace "<namespace>".
문제를 해결하려면 바인딩하려는 네임스페이스에서 ManagedClusterSetBinding 리소스를 생성하거나 삭제할 수 있는 권한이 있어야 합니다. 역할 바인딩을 사용하면 네임스페이스로 설정된 클러스터만 바인딩할 수 있습니다.
1.3.3.6. 호스트된 컨트롤 플레인 클러스터 프로비저닝 후에는 수평 스크롤이 작동하지 않습니다. 링크 복사링크가 클립보드에 복사되었습니다!
호스팅된 컨트롤 플레인 클러스터를 프로비저닝한 후에는 ClusterVersionUpgradeable 매개변수가 너무 길면 Red Hat Advanced Cluster Management 콘솔의 클러스터 개요에서 수평으로 스크롤할 수 없습니다. 숨겨진 데이터는 결과적으로 볼 수 없습니다.
이 문제를 해결하려면 브라우저 확대 제어를 사용하여 축소하거나 Red Hat Advanced Cluster Management 콘솔 창 크기를 늘리거나 텍스트를 복사하여 다른 위치에 붙여넣습니다.
1.3.3.7. EditApplicationSet 확장 기능 반복 링크 복사링크가 클립보드에 복사되었습니다!
여러 레이블 표현식을 추가하거나 ApplicationSet 에 대한 클러스터 선택기를 입력하려고 하면 다음 메시지가 반복적으로 표시될 수 있습니다. "Expand to enter expression". 이 문제에도 클러스터 선택을 입력할 수 있습니다.
1.3.3.8. 애플리케이션 콘솔에서 Argo CD 풀 모델을 지원하지 않습니다. 링크 복사링크가 클립보드에 복사되었습니다!
Argo CD 풀 모델을 사용하여 ApplicationSet 리소스를 배포하면 Topology 페이지에서 애플리케이션이 잘못 표시됩니다. Argo CD 가져오기 모델을 사용하여 ApplicationSet 애플리케이션을 배포하는 것은 지원되지 않습니다.
1.3.4. 애플리케이션 알려진 문제 및 제한 사항 링크 복사링크가 클립보드에 복사되었습니다!
애플리케이션 관리에 대해 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
애플리케이션 라이프사이클 구성 요소에 대한 다음 알려진 문제를 참조하십시오.
1.3.4.1. 로컬 클러스터는 가져오기 모델을 위한 관리형 클러스터로 제외됨 링크 복사링크가 클립보드에 복사되었습니다!
허브 클러스터 애플리케이션 세트는 대상 관리 클러스터에 배포되지만 관리 허브 클러스터인 로컬 클러스터는 대상 관리 클러스터로 제외됩니다.
1.3.4.2. Argo CD 컨트롤러 및 전파 컨트롤러가 동시에 조정될 수 있습니다. 링크 복사링크가 클립보드에 복사되었습니다!
Argo CD 컨트롤러와 전파 컨트롤러는 모두 동일한 애플리케이션 리소스에서 조정할 수 있으며 관리형 클러스터에서 애플리케이션 배포 인스턴스가 중복되지만 다른 배포 모델에서 발생할 수 있습니다.
가져오기 모델을 사용하여 애플리케이션을 배포하기 위해 Argo CD 컨트롤러는 Argo CD argocd.argoproj.io/skip-reconcile 주석이 ApplicationSet 의 template 섹션에 추가되면 Argo CD 컨트롤러에서 이러한 애플리케이션 리소스를 무시합니다.
argocd.argoproj.io/skip-reconcile 주석은 GitOps Operator 버전 1.9.0 이상에서만 사용할 수 있습니다. 충돌을 방지하려면 허브 클러스터 및 모든 관리 클러스터가 가져오기 모델을 구현하기 전에 GitOps Operator 버전 1.9.0으로 업그레이드할 때까지 기다립니다.
1.3.4.3. 리소스가 배포되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
MulticlusterApplicationSetReport 에 나열된 모든 리소스는 실제로 관리 클러스터에 배포됩니다. 리소스를 배포하지 못하면 리소스가 리소스 목록에 포함되지 않지만 원인은 오류 메시지에 나열됩니다.
1.3.4.4. 리소스 할당에 몇 분이 걸릴 수 있습니다. 링크 복사링크가 클립보드에 복사되었습니다!
수백 개의 관리형 클러스터에 배포된 관리 클러스터 및 Argo CD 애플리케이션 세트가 있는 대규모 환경의 경우 허브 클러스터에서 Argo CD 애플리케이션 생성에 몇 분이 걸릴 수 있습니다. 다음 예제 파일에 표시되므로 애플리케이션 세트의 clusterDecisionResource 생성기에서 requeueAfterSeconds 를 0 으로 설정할 수 있습니다.
apiVersion: argoproj.io/v1alpha1
kind: ApplicationSet
metadata:
name: cm-allclusters-app-set
namespace: openshift-gitops
spec:
generators:
- clusterDecisionResource:
configMapRef: ocm-placement-generator
labelSelector:
matchLabels:
cluster.open-cluster-management.io/placement: app-placement
requeueAfterSeconds: 0
1.3.4.5. Application ObjectBucket 채널 유형은 허용 및 거부 목록을 사용할 수 없습니다. 링크 복사링크가 클립보드에 복사되었습니다!
subscription-admin 역할에 ObjectBucket 채널 유형으로 허용 및 거부 목록을 지정할 수 없습니다. 다른 채널 유형에서 서브스크립션의 허용 및 거부 목록은 배포할 수 없는 Kubernetes 리소스 및 Kubernetes 리소스를 나타냅니다.
1.3.4.5.1. Argo 애플리케이션은 3.x OpenShift Container Platform 관리 클러스터에 배포할 수 없습니다. 링크 복사링크가 클립보드에 복사되었습니다!
3.x의 Argo ApplicationSet 은 Infrastructure.config.openshift.io API를 사용할 수 없기 때문에 3.x OpenShift Container Platform 관리 클러스터에 배포할 수 없습니다.
1.3.4.6. multicluster_operators_subscription 이미지 변경 사항이 자동으로 적용되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
klusterlet Operator가 이전에 처리했을 때 관리 클러스터에서 실행 중인 application-manager 애드온을 서브스크립션 운영자가 처리합니다. 서브스크립션 Operator는 를 관리하지 않으므로 multicluster-hub 이미지 매니페스트 ConfigMap의 multicluster-hub multicluster_operators_subscription 이미지에 대한 변경 사항이 자동으로 적용되지 않습니다.
멀티cluster -hub 이미지 매니페스트 ConfigMap에서 의 다중cluster_operators_subscription 이미지를 변경하여 서브스크립션 운영자가 사용하는 이미지를 재정의하는 경우 관리 클러스터application-manager 애드온은 서브스크립션 운영자 Pod가 다시 시작될 때까지 새 이미지를 사용하지 않습니다. Pod를 다시 시작해야 합니다.
1.3.4.7. 서브스크립션 관리자가 배포하지 않는 경우 정책 리소스가 배포되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
policy.open-cluster-management.io/v1 리소스는 기본적으로 Red Hat Advanced Cluster Management 버전 2.4에 대해 애플리케이션 서브스크립션에 의해 더 이상 배포되지 않습니다.
서브스크립션 관리자는 이 기본 동작을 변경하기 위해 애플리케이션 서브스크립션을 배포해야 합니다.
자세한 내용은 서브스크립션 관리자로 허용 및 거부 목록 생성을 참조하십시오. 이전 Red Hat Advanced Cluster Management 버전의 기존 애플리케이션 서브스크립션에 의해 배포된 policy.open-cluster-management.io/v1 리소스는 남아 있지만 서브스크립션 관리자가 애플리케이션 서브스크립션을 배포하지 않는 한 소스 리포지토리와 조정되지 않습니다.
1.3.4.8. 애플리케이션 Ansible 후크 독립 실행형 모드 링크 복사링크가 클립보드에 복사되었습니다!
Ansible 후크 독립 실행형 모드는 지원되지 않습니다. 서브스크립션을 사용하여 허브 클러스터에 Ansible 후크를 배포하려면 다음 서브스크립션 YAML을 사용할 수 있습니다.
apiVersion: apps.open-cluster-management.io/v1
kind: Subscription
metadata:
name: sub-rhacm-gitops-demo
namespace: hello-openshift
annotations:
apps.open-cluster-management.io/github-path: myapp
apps.open-cluster-management.io/github-branch: master
spec:
hooksecretref:
name: toweraccess
channel: rhacm-gitops-demo/ch-rhacm-gitops-demo
placement:
local: true
그러나 spec.placement.local:true 에 독립 실행형 모드에서 서브스크립션이 실행 중이므로 이 구성은 Ansible 인스턴스를 생성하지 않을 수 있습니다. 허브 모드에서 서브스크립션을 생성해야 합니다.
로컬 클러스터에 배포하는 배치 규칙을생성합니다.local-cluster: "true"가 hub 클러스터를 참조하는 다음 샘플을 참조하십시오.apiVersion: apps.open-cluster-management.io/v1 kind: PlacementRule metadata: name: <towhichcluster> namespace: hello-openshift spec: clusterSelector: matchLabels: local-cluster: "true"서브스크립션에 해당 배치 규칙을 참조합니다. 다음 샘플을 참조하십시오.
apiVersion: apps.open-cluster-management.io/v1 kind: Subscription metadata: name: sub-rhacm-gitops-demo namespace: hello-openshift annotations: apps.open-cluster-management.io/github-path: myapp apps.open-cluster-management.io/github-branch: master spec: hooksecretref: name: toweraccess channel: rhacm-gitops-demo/ch-rhacm-gitops-demo placement: placementRef: name: <towhichcluster> kind: PlacementRule
둘 다 적용한 후에는 허브 클러스터에서 생성된 Ansible 인스턴스가 표시되어야 합니다.
1.3.4.9. 업데이트된 배치 규칙 이후에 배포되지 않은 애플리케이션 링크 복사링크가 클립보드에 복사되었습니다!
배치 규칙 업데이트 후 애플리케이션을 배포하지 않는 경우 application-manager 포드가 실행 중인지 확인합니다. application-manager 는 관리 클러스터에서 실행해야 하는 서브스크립션 컨테이너입니다.
oc get pods -n open-cluster-management-agent-addon |grep application-manager 를 실행하여 확인할 수 있습니다.
콘솔에서 kind:pod cluster:yourcluster 를 검색하고 application-manager 가 실행 중인지 확인할 수도 있습니다.
확인할 수 없는 경우 클러스터를 다시 가져온 후 다시 확인합니다.
1.3.4.10. 서브스크립션 Operator에서 SCC를 생성하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
관리 SCC(보안 컨텍스트 제약 조건)의 Red Hat OpenShift Container Platform SCC 에 대해 알아보십시오. 관리 대상 클러스터에 필요한 추가 구성입니다.
배포마다 다른 보안 컨텍스트 및 다양한 서비스 계정이 있습니다. 서브스크립션 Operator는 SCC CR을 자동으로 생성할 수 없습니다. 관리자는 Pod에 대한 권한을 제어합니다. 기본이 아닌 네임스페이스에 Pod를 생성하기 위해 상대 서비스 계정에 적절한 권한을 활성화하려면 SCC(보안 컨텍스트 제약 조건) CR이 필요합니다. 네임스페이스에서 SCC CR을 수동으로 생성하려면 다음 단계를 완료합니다.
배포에 정의된 서비스 계정을 찾습니다. 예를 들어 다음
nginx배포를 참조하십시오.nginx-ingress-52edb nginx-ingress-52edb-backend네임스페이스에서 SCC CR을 생성하여 서비스 계정 또는 계정에 필요한 권한을 할당합니다. 다음 예제를 참조하십시오. 여기서
kind: SecurityContextConstraints가 추가됩니다.apiVersion: security.openshift.io/v1 defaultAddCapabilities: kind: SecurityContextConstraints metadata: name: ingress-nginx namespace: ns-sub-1 priority: null readOnlyRootFilesystem: false requiredDropCapabilities: fsGroup: type: RunAsAny runAsUser: type: RunAsAny seLinuxContext: type: RunAsAny users: - system:serviceaccount:my-operator:nginx-ingress-52edb - system:serviceaccount:my-operator:nginx-ingress-52edb-backend
1.3.4.11. 애플리케이션 채널에는 고유한 네임스페이스가 필요합니다. 링크 복사링크가 클립보드에 복사되었습니다!
동일한 네임스페이스에 둘 이상의 채널을 생성하면 허브 클러스터에 오류가 발생할 수 있습니다.
예를 들어, 설치 프로그램에서 Helm 유형 채널로 네임스페이스 charts-v1 을 사용하므로 charts-v1 에서 추가 채널을 생성하지 마십시오. 고유한 네임스페이스에서 채널을 생성해야 합니다. 모든 채널에는 다른 GitHub 채널과 네임스페이스를 공유할 수 있는 GitHub 채널을 제외한 개별 네임스페이스가 필요합니다.
1.3.4.12. Ansible Automation Platform 작업 실패 링크 복사링크가 클립보드에 복사되었습니다!
호환되지 않는 옵션을 선택하면 Ansible 작업이 실행되지 않습니다. Ansible Automation Platform은 -cluster-scoped 채널 옵션을 선택한 경우에만 작동합니다. 이는 Ansible 작업을 수행해야 하는 모든 구성 요소에 영향을 미칩니다.
1.3.4.13. Ansible Automation Platform Operator는 프록시 외부에서 Ansible Automation Platform에 액세스 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Ansible Automation Platform Operator는 프록시 사용 OpenShift Container Platform 클러스터 외부에서 Ansible Automation Platform에 액세스할 수 없습니다. 문제를 해결하려면 프록시 내에 Ansible Automation Platform을 설치할 수 있습니다. Ansible Automation Platform에서 제공하는 설치 단계를 참조하십시오.
1.3.4.14. 애플리케이션 이름 요구사항 링크 복사링크가 클립보드에 복사되었습니다!
애플리케이션 이름은 37자를 초과할 수 없습니다. 문자가 이 양을 초과하면 애플리케이션 배포에 다음 오류가 표시됩니다.
status:
phase: PropagationFailed
reason: 'Deployable.apps.open-cluster-management.io "_long_lengthy_name_" is invalid: metadata.labels: Invalid value: "_long_lengthy_name_": must be no more than 63 characters/n'
1.3.4.15. 애플리케이션 콘솔 테이블 제한 사항 링크 복사링크가 클립보드에 복사되었습니다!
콘솔의 다양한 애플리케이션 테이블에 대한 다음 제한 사항을 참조하십시오.
- 개요 페이지의 애플리케이션 테이블과 고급 구성 페이지의 서브스크립션 표에서 클러스터 열에 애플리케이션 리소스가 배포된 클러스터 수가 표시됩니다. 애플리케이션은 로컬 클러스터의 리소스로 정의되므로 실제 애플리케이션 리소스가 로컬 클러스터에 배포되었는지 여부에 관계없이 로컬 클러스터는 검색 결과에 포함됩니다.
- 서브스크립션 의 고급 구성 표에서 애플리케이션 열에는 해당 서브스크립션을 사용하는 총 애플리케이션 수가 표시되지만 서브스크립션이 하위 애플리케이션을 배포하면 검색 결과에도 포함됩니다.
- 채널 의 고급 구성 표에서 서브스크립션 열에는 해당 채널을 사용하는 로컬 클러스터의 총 서브스크립션 수가 표시되지만 검색 결과에 포함된 다른 서브스크립션에서 배포한 서브스크립션은 포함되지 않습니다.
1.3.4.16. 애플리케이션 콘솔 토폴로지 필터링 없음 링크 복사링크가 클립보드에 복사되었습니다!
2.8에 대한 애플리케이션 변경에 대한 콘솔 및 토폴로지 입니다. 콘솔 토폴로지 페이지에서 필터링 기능이 없습니다.
1.3.4.17. 오브젝트 스토리지 애플리케이션에서 허용 및 거부 목록이 작동하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
개체 스토리지 애플리케이션 서브스크립션에서는 허용 및 거부 목록 기능이 작동하지 않습니다.
1.3.5. 가시성 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
Kubernetes용 Red Hat Advanced Cluster Management의 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제[OpenShift Container Platform 알려진 문제]를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
1.3.5.1. 서비스 수준 개요 대시보드의 중복 로컬 클러스터 링크 복사링크가 클립보드에 복사되었습니다!
다양한 허브 클러스터에서 동일한 S3 스토리지를 사용하여 Red Hat Advanced Cluster Management 관찰 기능을 배포하는 경우 중복된 로컬 클러스터를 탐지하여 Kubernetes/Service-Level Overview/API Server 대시보드에 표시할 수 있습니다. 중복된 클러스터는 다음 패널 내의 결과에 영향을미칩니다. 상위 클러스터, SLO를 초과하는 클러스터 수 및 SLO를 충족하는 클러스터 수입니다. local-cluster는 공유 S3 스토리지와 관련된 고유한 클러스터입니다. 여러 로컬 클러스터가 대시보드에 표시되지 않도록 하려면 각 고유 허브 클러스터에서 hub 클러스터 전용 S3 버킷을 사용하여 관찰 기능을 배포하는 것이 좋습니다.
1.3.5.2. Observability Endpoint Operator가 이미지를 가져오지 못했습니다. 링크 복사링크가 클립보드에 복사되었습니다!
MultiClusterObservability CustomResource(CR)에 배포할 pull-secret을 생성하고 open-cluster-management-observability 네임스페이스에 pull-secret이 없는 경우 observability 끝점 Operator가 실패합니다. 새 클러스터를 가져오거나 Red Hat Advanced Cluster Management로 생성된 Hive 클러스터를 가져오는 경우, 관리형 클러스터에서 수동으로 풀 이미지 시크릿을 생성해야 합니다.
자세한 내용은 관찰 기능 활성화를 참조하십시오.
1.3.5.3. ROKS 클러스터의 데이터가 없습니다. 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Advanced Cluster Management 관찰 기능은 기본 제공 대시보드 내의 일부 패널에 ROKS 클러스터의 데이터를 표시하지 않습니다. 이는 ROKS가 관리하는 서버에서 API 서버 지표를 노출하지 않기 때문입니다. 다음 Grafana 대시보드에는 ROKS 클러스터를 지원하지 않는 패널이 포함되어 있습니다. Kubernetes/API 서버,Kubernetes/Compute Resources/Workload,Kubernetes/Compute Resources/Namespace(Workload)
1.3.5.4. ROKS 클러스터의 etcd 데이터가 없습니다. 링크 복사링크가 클립보드에 복사되었습니다!
ROKS 클러스터의 경우 Red Hat Advanced Cluster Management 관찰 기능은 대시보드의 etcd 패널에 데이터를 표시하지 않습니다.
1.3.5.5. Grafana 콘솔에서 메트릭을 사용할 수 없음 링크 복사링크가 클립보드에 복사되었습니다!
Grafana 콘솔에서 주석 쿼리가 실패했습니다.
Grafana 콘솔에서 특정 주석을 검색할 때 만료된 토큰으로 인해 다음 오류 메시지가 표시될 수 있습니다.
"annotation Query Failed"브라우저를 새로 고치고 hub 클러스터에 로그인했는지 확인합니다.
rbac-query-proxy Pod의 오류:
managedcluster리소스에 대한 무단 액세스 권한으로 인해 클러스터 또는 프로젝트를 쿼리할 때 다음과 같은 오류가 발생할 수 있습니다.프로젝트 또는 클러스터를 찾을 수 없음역할 권한을 확인하고 적절하게 업데이트합니다. 자세한 내용은 역할 기반 액세스 제어를 참조하십시오.
1.3.5.6. 관리형 클러스터에서 Prometheus 데이터 손실 링크 복사링크가 클립보드에 복사되었습니다!
기본적으로 OpenShift의 Prometheus는 임시 스토리지를 사용합니다. Prometheus는 다시 시작할 때마다 모든 지표 데이터가 손실됩니다.
Red Hat Advanced Cluster Management에서 관리하는 OpenShift Container Platform 관리 클러스터에서 관찰 기능이 활성화 또는 비활성화되면 observability 끝점 Operator는 로컬 Prometheus를 자동으로 다시 시작하는 alertmanager 구성을 추가하여 cluster-monitoring-config ConfigMap 을 업데이트합니다.
1.3.5.7. 순서가 없는 샘플을 수집하는 동안 오류 발생 링크 복사링크가 클립보드에 복사되었습니다!
가시성은 Pod 에서 다음 오류 메시지를 보고합니다.
Error on ingesting out-of-order samples
오류 메시지는 메트릭 수집 간격 동안 관리 클러스터에서 보낸 시계열 데이터가 이전 수집 간격으로 보낸 시계열 데이터보다 오래되었음을 나타냅니다. 이 문제가 발생하면 Thanos 수신자에 의해 데이터가 삭제되고 Grafana 대시보드에 표시된 데이터에 차이가 발생할 수 있습니다. 오류가 자주 표시되는 경우 지표 컬렉션 간격을 더 높은 값으로 늘리는 것이 좋습니다. 예를 들어 간격을 60 초로 늘릴 수 있습니다.
이 문제는 시계열 간격이 30초와 같이 더 낮은 값으로 설정된 경우에만 발생합니다. 지표 수집 간격이 기본값 300초로 설정된 경우에는 이 문제가 표시되지 않습니다.
1.3.5.8. 업그레이드 후 Grafana 배포가 실패합니다. 링크 복사링크가 클립보드에 복사되었습니다!
이전 버전 2.6에 배포된 grafana-dev 인스턴스가 있고 환경을 2.6으로 업그레이드하는 경우 grafana-dev 가 작동하지 않습니다. 다음 명령을 실행하여 기존 grafana-dev 인스턴스를 삭제해야 합니다.
./setup-grafana-dev.sh --clean
다음 명령을 사용하여 인스턴스를 다시 생성합니다.
./setup-grafana-dev.sh --deploy
1.3.5.9. klusterlet-addon-search Pod 실패 링크 복사링크가 클립보드에 복사되었습니다!
메모리 제한에 도달하여 klusterlet-addon-search Pod가 실패합니다. 관리 클러스터에서 klusterlet-addon-search 배포를 사용자 정의하여 메모리 요청 및 제한을 업데이트해야 합니다. hub 클러스터에서 search-collector 라는 ManagedclusterAddon 사용자 정의 리소스를 편집합니다. search-collector 에 다음 주석을 추가하고 메모리 addon.open-cluster-management.io/search_memory_request=512Mi 및 addon.open-cluster-management.io/search_memory_limit=1024Mi.
예를 들어 foobar 라는 관리 클러스터가 있는 경우 다음 명령을 실행하여 메모리 요청을 512Mi 로 변경하고 메모리 제한을 1024Mi 로 변경합니다.
oc annotate managedclusteraddon search-collector -n foobar \
addon.open-cluster-management.io/search_memory_request=512Mi \
addon.open-cluster-management.io/search_memory_limit=1024Mi
1.3.5.10. disableHubSelfManagement 를 활성화하면 Grafana 대시보드의 빈 목록이 발생합니다. 링크 복사링크가 클립보드에 복사되었습니다!
mulitclusterengine 사용자 정의 리소스에서 disableHubSelfManagement 매개변수가 true 로 설정된 경우 Grafana 대시보드에 빈 레이블 목록이 표시됩니다. 매개변수를 false 로 설정하거나 레이블 목록을 보려면 매개변수를 제거해야 합니다. 자세한 내용은 disableHubSelfManagement 에서 참조하십시오.
1.3.5.10.1. 엔드포인트 URL에는 FQDN(정규화된 도메인 이름)이 있을 수 없습니다. 링크 복사링크가 클립보드에 복사되었습니다!
endpoint 매개변수에 FQDN 또는 프로토콜을 사용하면 관찰 기능 Pod가 활성화되지 않습니다. 다음과 같은 오류 메시지가 표시됩니다.
Endpoint url cannot have fully qualified paths
프로토콜 없이 URL을 입력합니다. 끝점 값은 보안에 대해 다음 URL과 유사해야 합니다.
endpoint: example.com:443
1.3.5.10.2. Grafana 다운 샘플링 데이터 불일치 링크 복사링크가 클립보드에 복사되었습니다!
이전 데이터를 쿼리하려고 하면 계산된 단계 값과 다운샘플링된 데이터 사이에 불일치가 있으면 결과가 비어 있습니다. 예를 들어 계산된 단계 값이 5m 이고 다운샘플링된 데이터가 1시간 간격인 경우 Grafana에서 데이터가 표시되지 않습니다.
이 불일치는 URL 쿼리 매개변수가 Thanos 쿼리 프런트 엔드 데이터 소스를 통해 전달되어야 하기 때문에 발생합니다. 이후 데이터가 누락될 때 URL 쿼리는 다른 다운스트림 수준에 대한 추가 쿼리를 수행할 수 있습니다.
Thanos Query 프런트 엔드 데이터 소스 구성을 수동으로 업데이트해야 합니다. 다음 단계를 완료합니다.
- 쿼리 프런트 엔드 데이터 소스로 이동합니다.
- 쿼리 매개변수를 업데이트하려면 Misc 섹션을 클릭합니다.
-
사용자 정의 쿼리 매개변수 필드에서
max_source_resolution=auto를 선택합니다. - 데이터가 표시되는지 확인하려면 Grafana 페이지를 새로 고칩니다.
쿼리 데이터는 Grafana 대시보드에서 표시됩니다.
1.3.5.11. 메트릭 수집기에서 프록시 구성을 감지하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
addonDeploymentConfig 를 사용하여 구성한 관리 클러스터의 프록시 구성은 메트릭 수집기에서 탐지되지 않습니다. 이 문제를 해결하려면 관리 클러스터 ManifestWork 를 제거하여 프록시를 활성화할 수 있습니다. ManifestWork 를 제거하면 addonDeploymentConfig 의 변경 사항을 적용해야 합니다.
1.3.5.12. 사용자 정의 CA 번들이 있는 HTTPS 프록시는 지원되지 않습니다. 링크 복사링크가 클립보드에 복사되었습니다!
사용자 정의 CA 번들이 필요한 경우 관리 클러스터의 프록시 구성이 작동하지 않습니다.
1.3.6. 거버넌스 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
Governance에 대해 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제[OpenShift Container Platform 알려진 문제]를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
1.3.6.1. Red Hat Advanced Cluster Management에서 로그아웃할 수 없음 링크 복사링크가 클립보드에 복사되었습니다!
외부 ID 공급자를 사용하여 Red Hat Advanced Cluster Management에 로그인하면 Red Hat Advanced Cluster Management에서 로그아웃하지 못할 수 있습니다. 이는 Red Hat Advanced Cluster Management를 사용하고 IBM Cloud 및 Keycloak과 함께 ID 공급자로 설치된 경우 발생합니다.
Red Hat Advanced Cluster Management에서 로그아웃하기 전에 외부 ID 공급자에서 로그아웃해야 합니다.
1.3.6.2. 게이트 키퍼 Operator 설치에 실패 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Container Platform 버전 4.9에 게이트 키 연산자를 설치하면 설치에 실패합니다. OpenShift Container Platform을 버전 4.9.0.로 업그레이드하기 전에 gatekeeper Operator를 버전 0.2.0으로 업그레이드해야 합니다. 자세한 내용은 게이트 키퍼(upgrading gatekeeper) 및 게이트키퍼(Gatekeeper) 운영자 를 참조하십시오.
1.3.6.3. 네임스페이스가 종료 상태가 될 때 불만되는 구성 정책 링크 복사링크가 클립보드에 복사되었습니다!
complianceType 매개변수에 대해 mustnothave 로 구성된 구성 정책이 있고 remediationAction 매개변수에 적용하는 경우 Kubernetes API에 대한 삭제 요청이 수행된 후 정책이 준수로 나열됩니다. 따라서 정책이 규정 준수로 나열되는 동안 Kubernetes 오브젝트를 Terminating 상태로 유지할 수 있습니다.
1.3.6.4. 정책을 통해 배포된 Operator는 ARM을 지원하지 않습니다. 링크 복사링크가 클립보드에 복사되었습니다!
ARM 환경에 설치하는 것은 지원되지만 정책을 사용하여 배포된 Operator는 ARM 환경을 지원하지 않을 수 있습니다. Operator를 설치하는 다음 정책은 ARM 환경을 지원하지 않습니다.
1.3.6.5. ConfigurationPolicy CRD가 종료되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
KlusterletAddonConfig 에서 정책 컨트롤러를 비활성화하거나 클러스터를 분리하여 관리 클러스터에서 config-policy-controller 애드온을 제거하면 ConfigurationPolicy CRD가 종료 상태가 될 수 있습니다. ConfigurationPolicy CRD가 종료 상태인 경우 나중에 애드온을 다시 설치하는 경우 새 정책이 클러스터에 추가되지 않을 수 있습니다. 다음과 같은 오류가 발생할 수 있습니다.
template-error; Failed to create policy template: create not allowed while custom resource definition is terminating
다음 명령을 사용하여 CRD가 중단되었는지 확인합니다.
oc get crd configurationpolicies.policy.open-cluster-management.io -o=jsonpath='{.metadata.deletionTimestamp}'
삭제 타임스탬프가 리소스에 있으면 CRD가 정지됩니다. 문제를 해결하려면 클러스터에 남아 있는 구성 정책에서 종료자를 모두 제거하십시오. 관리형 클러스터에서 다음 명령을 사용하고 < cluster-namespace >를 관리형 클러스터 네임스페이스로 교체합니다.
oc get configurationpolicy -n <cluster-namespace> -o name | xargs oc patch -n <cluster-namespace> --type=merge -p '{"metadata":{"finalizers": []}}'
구성 정책 리소스는 클러스터에서 자동으로 제거되고 CRD는 종료 상태를 종료합니다. 애드온을 이미 다시 설치한 경우 CRD는 삭제 타임스탬프 없이 자동으로 다시 생성됩니다.
1.3.6.6. 기존 구성 정책을 수정할 때 pruneObjectBehavior 가 작동하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
기존 구성 정책을 수정하면 pruneObjectBehavior 가 작동하지 않습니다. pruneObjectBehavior 가 작동하지 않는 이유는 다음과 같습니다.
-
구성 정책에서
pruneObjectBehavior를DeleteAll또는DeleteIfCreated로 설정하면 수정 전에 생성된 이전 리소스가 올바르게 정리되지 않습니다. 구성 정책을 삭제할 때 정책 생성 및 정책 업데이트의 새 리소스만 추적 및 삭제됩니다. -
pruneObjectBehavior를None으로 설정하거나 매개변수 값을 설정하지 않으면 관리 클러스터에서 이전 오브젝트가 의도치 않게 삭제될 수 있습니다. 특히 사용자가 템플릿에서이름,네임스페이스,종류또는apiversion을 변경할 때 발생합니다.object-templates-raw또는namespaceSelector매개변수가 변경될 때 매개변수 필드를 동적으로 변경할 수 있습니다.
1.3.6.7. 시행 시 정책 상태가 반복적인 업데이트를 표시합니다. 링크 복사링크가 클립보드에 복사되었습니다!
정책이 수정: 적용 및 반복적으로 업데이트되는 경우 Red Hat Advanced Cluster Management 콘솔에는 업데이트가 성공하면 반복적으로 위반이 표시됩니다. 오류에 대한 다음 두 가지 원인 및 해결 방법을 참조하십시오.
다른 컨트롤러 또는 프로세스는 다른 값으로 오브젝트를 업데이트하는 중입니다.
이 문제를 해결하려면 정책을 비활성화하고 정책의
objectDefinition과 관리 클러스터의 개체 간의 차이점을 비교합니다. 값이 다르면 다른 컨트롤러 또는 프로세스가 업데이트될 수 있습니다. 오브젝트의메타데이터를 확인하여 값이 다른 이유를 식별하는 데 도움이 됩니다.정책을 적용할 때 Kubernetes에서
오브젝트를 처리하므로이 일치하지 않습니다.ConfigurationPolicy의 오브젝트Definition이 문제를 해결하려면 정책을 비활성화하고 정책의
objectDefinition과 관리 클러스터의 개체 간의 차이점을 비교합니다. 키가 다르거나 누락된 경우 Kubernetes는 기본값 또는 빈 값이 포함된 키 제거와 같이 오브젝트에 적용하기 전에 키를 처리했을 수 있습니다.참고:
pruneObjectBehavior가None이 아닌 다른 것으로 설정된 경우 정책을 비활성화하면 오브젝트가 정리됩니다. 이 경우 정책을 비활성화한 후 오브젝트가 존재하도록pruneObjectBehavior를None으로 설정합니다.
예를 들어 Secret 리소스의 stringData 맵은 Kubernetes에서 base64 로 인코딩된 값이 있는 데이터로 변환됩니다. stringData 를 사용하는 대신 문자열 대신 base64 로 인코딩된 값과 함께 데이터를 직접 사용합니다.
1.3.6.8. OpenShift Container Platform 4.12 이상에서 지원되지 않는 Pod 보안 정책 링크 복사링크가 클립보드에 복사되었습니다!
Pod 보안 정책은 OpenShift Container Platform 4.12 이상에서 및 Kubernetes v1.25 이상에서 제거됩니다. PodSecurityPolicy 리소스를 적용하면 다음과 같은 비호환 메시지가 표시될 수 있습니다.
violation - couldn't find mapping resource with kind PodSecurityPolicy, please check if you have CRD deployed
1.3.6.9. 중복 정책 템플릿 이름에서 불일치 결과 생성 링크 복사링크가 클립보드에 복사되었습니다!
동일한 정책 템플릿 이름으로 정책을 생성하면 탐지되지 않은 결과가 표시되지만 원인을 모를 수 있습니다. 예를 들어 create-pod 라는 여러 구성 정책으로 정책을 정의하면 일관되지 않은 결과가 발생합니다. 모범 사례: 정책 템플릿에 중복 이름을 사용하지 마십시오.
1.3.6.10. 비활성화된 경우 거버넌스 배포가 오류 없이 종료되지 않음 링크 복사링크가 클립보드에 복사되었습니다!
MultiClusterHub 오브젝트에서 거버넌스 배포를 비활성화하면 오류 없이 배포가 정리되지 않습니다. 배포도 정리되도록 거버넌스를 비활성화하려면 다음 단계를 완료합니다.
관리 클러스터의
KlusterletAddonConfig에서policyController를 비활성화합니다. 모든 관리 클러스터에 이 작업을 수행하는 경우 다음 명령을 실행합니다.for CLUSTER in $(oc get managedclusters -o jsonpath='{.items[].metadata.name}'); do oc patch -n ${CLUSTER} klusterletaddonconfig ${CLUSTER} --type=merge --patch='{"spec":{"policyController":{"enabled":false}}}' done로컬 클러스터만 해당: 로컬 클러스터의
ManifestWork를 삭제하고 로컬 클러스터의governance-policy-framework-uninstallPod가CrashLoopBackOff에 있는 경우ManagedClusterAddon에서 종료자를 제거합니다. 다음 명령을 실행합니다.oc delete manifestwork -n local-cluster -l open-cluster-management.io/addon-name=governance-policy-framework oc patch managedclusteraddon -n local-cluster governance-policy-framework --type=merge --patch='{"metadata":{"finalizers":[]}}'MultiClusterHub오브젝트에서spec.overrides섹션의grc요소를false로 설정하여 필요한 경우 거버넌스를 전역적으로 비활성화합니다. 다음 명령을 실행합니다.oc edit multiclusterhub <name> -n <namespace>로컬 클러스터 전용: 로컬 클러스터 정책이 있는 경우 다음 명령을 실행하여 정책을 삭제할 수 있습니다.
oc delete policies -n local-cluster --allKlusterletAddonConfig에서 거버넌스를 다시 활성화하려면MultiClusterHub의spec.overrides섹션의grc요소를 다시 활성화합니다. 다음 명령을 실행합니다.for CLUSTER in $(oc get managedclusters -o jsonpath='{.items[].metadata.name}'); do oc patch -n ${CLUSTER} klusterletaddonconfig ${CLUSTER} --type=merge --patch='{"spec":{"policyController":{"enabled":true}}}' done배포에 실패한 경우
governance-policy-addon-controller에 오래된 리스를 가질 수 있습니다. 다음 명령을 사용하여 리스를 삭제합니다.oc delete lease governance-policy-addon-controller-lock -n <namespace>
1.3.6.11. 템플릿 오류로 인해 오브젝트가 삭제됨 링크 복사링크가 클립보드에 복사되었습니다!
구성 정책의 잘못된 구문과 같은 템플릿 오류가 발생하면 오브젝트가 삭제됩니다. 올바른 구문을 사용하여 삭제된 오브젝트를 다시 생성합니다.
1.3.6.12. 정책 자동화를 위해 중복된 Ansible 작업이 생성됨 링크 복사링크가 클립보드에 복사되었습니다!
한 번 실행으로 설정되어 있고 비활성화된 PolicyAutomation 이 있는 경우 추가 Ansible 작업이 생성됩니다. 추가 Ansible 작업을 삭제할 수 있습니다. 다음 단계를 완료합니다.
다음 명령을 실행하여 Ansible 작업 목록을 확인합니다.
oc get ansiblejob -n {namespace}다음 명령을 사용하여 중복된 Ansible 작업을 삭제합니다.
oc delete ansiblejob {ansiblejob name} -n {namespace}
1.3.7. 네트워킹에서 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
Submariner에 대해 알려진 문제를 검토합니다. 다음 목록에는 이 릴리스의 알려진 문제 또는 이전 릴리스에서 계속된 알려진 문제가 포함되어 있습니다.
Red Hat OpenShift Container Platform 클러스터의 경우 OpenShift Container Platform 알려진 문제를 참조하십시오.
사용 중단 및 제거에 대한 자세한 내용은 사용 중단 및 제거를 참조하십시오.
1.3.7.1. Submariner 알려진 문제 링크 복사링크가 클립보드에 복사되었습니다!
네트워킹 기능을 사용하는 동안 발생할 수 있는 다음과 같은 알려진 문제 및 제한 사항을 참조하십시오.
1.3.7.1.1. ClusterManagementAddon submariner 애드온 없음 링크 복사링크가 클립보드에 복사되었습니다!
버전 2.8 이하의 경우 Red Hat Advanced Cluster Management를 설치할 때 Operator Lifecycle Manager와 함께 하위marine r-addon 구성 요소도 배포합니다. MultiClusterHub 사용자 정의 리소스를 생성하지 않은 경우 submariner-addon Pod에서 오류를 보내 Operator가 설치되지 않습니다.
ClusterManagementAddon 사용자 정의 리소스 정의가 누락되어 있기 때문에 다음 알림이 발생합니다.
graceful termination failed, controllers failed with error: the server could not find the requested resource (post clustermanagementaddons.addon.open-cluster-management.io)
ClusterManagementAddon 리소스는 cluster-manager 배포에 의해 생성되지만 클러스터에 MultiClusterEngine 구성 요소가 설치되면 이 배포를 사용할 수 있습니다.
MultiClusterHub 사용자 정의 리소스가 생성될 때 클러스터에서 이미 사용할 수 있는 MultiClusterEngine 리소스가 없는 경우 MultiClusterHub Operator는 MultiClusterEngine 인스턴스를 배포하고 필요한 Operator를 이전 오류를 해결합니다.
1.3.7.1.2. Red Hat Advanced Cluster Management에서 관리할 수 있는 인프라 공급자가 모두 지원되는 것은 아닙니다. 링크 복사링크가 클립보드에 복사되었습니다!
Submariner는 Red Hat Advanced Cluster Management에서 관리할 수 있는 모든 인프라 공급업체에서 지원되지 않습니다. 지원되는 공급자 목록은 Red Hat Advanced Cluster Management 지원 매트릭스 를 참조하십시오.
1.3.7.1.3. 제한된 헤드리스 서비스 지원 링크 복사링크가 클립보드에 복사되었습니다!
Globalnet을 사용할 때 선택기 없이 헤드리스 서비스에 대해 서비스 검색이 지원되지 않습니다.
1.3.7.1.4. NAT가 활성화된 경우 VXLAN을 사용하는 배포는 지원되지 않습니다. 링크 복사링크가 클립보드에 복사되었습니다!
NAT 이외의 배포만 VXLAN 연결 드라이버를 사용한 Submariner 배포를 지원합니다.
1.3.7.1.5. OVN Kubernetes에는 OCP 4.11 이상이 필요합니다. 링크 복사링크가 클립보드에 복사되었습니다!
OVN Kubernetes CNI 네트워크를 사용하는 경우 Red Hat OpenShift 4.11 이상이 필요합니다.
1.3.7.1.6. 자체 서명된 인증서로 인해 브로커에 연결되지 않을 수 있습니다. 링크 복사링크가 클립보드에 복사되었습니다!
브로커의 자체 서명된 인증서로 인해 결합된 클러스터가 브로커에 연결되지 않을 수 있습니다. 인증서 검증 오류와 함께 연결에 실패합니다. 관련 SubmarinerConfig 오브젝트에서 InsecureBrokerConnection 을 true 로 설정하여 브로커 인증서 유효성 검사를 비활성화할 수 있습니다. 다음 예제를 참조하십시오.
apiVersion: submarineraddon.open-cluster-management.io/v1alpha1
kind: SubmarinerConfig
metadata:
name: submariner
namespace: <managed-cluster-namespace>
spec:
insecureBrokerConnection: true
1.3.7.1.7. Submariner는 OpenShift SDN 또는 OVN Kubernetes만 지원 링크 복사링크가 클립보드에 복사되었습니다!
Submariner는 OpenShift SDN 또는 OVN-Kubernetes CNI(Container Network Interface) 네트워크 공급자를 사용하는 Red Hat OpenShift Container Platform 클러스터만 지원합니다.
1.3.7.1.8. Microsoft Azure 클러스터에 대한 명령 제한 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 간 방화벽 진단 명령이 Microsoft Azure 클러스터에서 작동하지 않습니다.
1.3.7.1.9. 사용자 정의 CatalogSource 또는 Subscription에서 자동 업그레이드가 작동하지 않음 링크 복사링크가 클립보드에 복사되었습니다!
Submariner는 Red Hat Advanced Cluster Management for Kubernetes가 업그레이드되면 자동으로 업그레이드됩니다. 사용자 정의 CatalogSource 또는 Subscription 을 사용하는 경우 자동 업그레이드가 실패할 수 있습니다.
관리 클러스터에 Submariner를 설치할 때 자동 업그레이드가 작동하려면 각 관리 클러스터의 SubmarinerConfig 사용자 정의 리소스에서 spec.subscriptionConfig.channel 필드를 stable-0.15 로 설정해야 합니다.
Red Hat Advanced Cluster Management 버전 2.8과 함께 릴리스된 Submariner 버전 0.15는 OpenShift Container Platform 버전 4.14 이상에서 지원되지 않습니다. OpenShift Container Platform 버전 4.14 이상을 사용하는 경우 Submariner 버전을 0.16로 업그레이드하거나 Submariner 버전 0.15 및 Red Hat Advanced Cluster Management 버전 2.8이 있는 OpenShift Container Platform 버전 4.13을 계속 사용해야 합니다.