Red Hat Summit5.5. oc-mirror 플러그인 v2에서 생성한 사용자 정의 리소스 정보
oc-mirror 플러그인 v2는 다음 사용자 정의 리소스를 자동으로 생성합니다.
ImageDigestMirrorSet(IDMS)- 이미지 다이제스트 가져오기 사양을 사용할 때 레지스트리 미러 규칙을 처리합니다. 다이제스트에 의해 이미지 세트의 이미지가 하나 이상 미러링되는 경우 생성됩니다.
ImageTagMirrorSet(ITMS)- 이미지 태그 가져오기 사양을 사용할 때 레지스트리 미러 규칙을 처리합니다. 이미지 세트에서 하나 이상의 이미지가 태그로 미러링되는 경우 생성됩니다.
CatalogSource- 미러 레지스트리에서 사용 가능한 Operator에 대한 정보를 검색합니다. OLM(Operator Lifecycle Manager) Classic에서 사용합니다.
ClusterCatalog- 미러 레지스트리에서 사용 가능한 클러스터 확장(Operator 포함)에 대한 정보를 검색합니다. OLM v1에서 사용합니다.
UpdateService- 연결이 끊긴 환경으로 그래프 데이터를 업데이트합니다. OpenShift 업데이트 서비스에서 사용합니다.
5.5.1. oc-mirror 플러그인에서 생성한 리소스 수정 제한
oc-mirror 플러그인 v2에서 생성한 리소스를 사용하여 클러스터를 구성하는 경우 특정 필드를 변경할 수 없습니다. 이러한 필드를 수정하면 오류가 발생할 수 있으며 지원되지 않습니다.
다음 표에는 변경되지 않은 상태로 유지해야 하는 리소스 및 해당 필드가 나열되어 있습니다.
| 리소스 | 변경할 수 없는 필드 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
서명 |
|
|
|
|
이러한 리소스에 대한 자세한 내용은 CatalogSource,ImageDigestMirrorSet 및 ImageTagMirrorSet 에 대한 OpenShift API 설명서를 참조하십시오.
5.5.2. oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터 구성
미러 레지스트리로 이미지를 미러링한 후 생성된 ImageDigestMirrorSet (IDMS), ImageTagMirrorSet (ITMS), CatalogSource 및 UpdateService 리소스를 클러스터에 적용해야 합니다.
oc-mirror 플러그인 v2에서 IDMS 및 ITMS 파일은 oc-mirror 플러그인 v1의 ImageContentSourcePolicy (ICSP) 파일과 달리 전체 이미지 세트를 다룹니다. 따라서 IDMS 및 ITMS 파일에는 증분 미러링 중에 새 이미지만 추가하는 경우에도 세트의 모든 이미지가 포함됩니다.
사전 요구 사항
-
cluster-admin역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
프로세스
-
cluster-admin역할의 사용자로 OpenShift CLI에 로그인합니다. 다음 명령을 실행하여 결과 디렉터리의 YAML 파일을 클러스터에 적용합니다.
oc apply -f <path_to_oc_mirror_workspace>/working-dir/cluster-resources
$ oc apply -f <path_to_oc_mirror_workspace>/working-dir/cluster-resourcesCopy to Clipboard Copied! Toggle word wrap Toggle overflow 미러링된 릴리스 이미지가 있는 경우 다음 명령을 실행하여 릴리스 이미지 서명을 클러스터에 적용합니다.
oc apply -f working-dir/cluster-resources/signature-configmap.json
$ oc apply -f working-dir/cluster-resources/signature-configmap.jsonCopy to Clipboard Copied! Toggle word wrap Toggle overflow 중요클러스터 대신 Operator를 미러링하는 경우 이전 명령을 실행하지 마십시오. 명령을 실행하면 적용할 릴리스 이미지 서명이 없기 때문에 오류가 발생합니다.
또한 YAML 파일은 동일한 디렉터리
working-dir/cluster-resources/에서 사용할 수 있습니다. JSON 또는 YAML 형식을 사용할 수 있습니다.
검증
다음 명령을 실행하여
ImageDigestMirrorSet리소스가 성공적으로 설치되었는지 확인합니다.oc get imagedigestmirrorset
$ oc get imagedigestmirrorsetCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc-mirror에서 생성된 리소스만 보려면 다음 명령을 실행하세요.oc get imagedigestmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'$ oc get imagedigestmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
ImageTagMirrorSet리소스가 성공적으로 설치되었는지 확인합니다.oc get imagetagmirrorset
$ oc get imagetagmirrorsetCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc-mirror에서 생성된 리소스만 보려면 다음 명령을 실행하세요.oc get imagetagmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'$ oc get imagetagmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
CatalogSource리소스가 성공적으로 설치되었는지 확인합니다.oc get catalogsource -n openshift-marketplace
$ oc get catalogsource -n openshift-marketplaceCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc-mirror에서 생성된 리소스만 보려면 다음 명령을 실행하세요.oc get catalogsource -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'$ oc get catalogsource -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
ClusterCatalog리소스가 성공적으로 설치되었는지 확인합니다.oc get clustercatalog
$ oc get clustercatalogCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc-mirror에서 생성된 리소스만 보려면 다음 명령을 실행하세요.oc get clustercatalog -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'$ oc get clustercatalog -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow
oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터를 구성한 후 미러링된 이미지를 사용하여 수행할 수 있는 작업에 대한 다음 단계를 참조하십시오.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}