연결되지 않은 환경
연결이 끊긴 환경에서 OpenShift Container Platform 클러스터 관리
초록
1장. 연결이 끊긴 환경에 대하여 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경이란 인터넷에 완전히 접속할 수 없는 환경을 말합니다.
OpenShift Container Platform은 레지스트리에서 릴리스 이미지를 검색하거나 클러스터에 대한 업데이트 경로 및 권장 사항을 검색하는 등 인터넷 연결에 의존하는 많은 자동 기능을 수행하도록 설계되었습니다. 인터넷에 직접 연결되지 않은 경우 연결이 끊긴 환경에서도 클러스터의 모든 기능을 유지하려면 추가 설정 및 구성을 수행해야 합니다.
1.1. 연결이 끊긴 환경 용어집 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 문서 전체에서 사용되지만, 연결이 끊긴 환경은 다양한 수준의 인터넷 연결이 있는 환경을 지칭할 수 있는 광범위한 용어입니다. 다른 용어는 때때로 특정 수준의 인터넷 연결을 지칭하는 데 사용되며, 이러한 환경에는 추가적인 고유한 구성이 필요할 수 있습니다.
다음 표에서는 인터넷에 제대로 연결되지 않은 환경을 지칭하는 다양한 용어를 설명합니다.
용어 | 설명 |
---|---|
에어갭 네트워크 | 외부 네트워크와 완전히 분리된 환경이나 네트워크. 이러한 격리는 내부 네트워크의 머신과 외부 네트워크의 다른 부분 사이의 물리적 분리, 즉 "공극"에 달려 있습니다. 공기 간격 환경은 엄격한 보안이나 규제 요건이 있는 산업에서 자주 사용됩니다. |
연결이 끊긴 환경 | 외부 네트워크와 어느 정도 격리되어 있는 환경이나 네트워크입니다. 이러한 격리는 내부 네트워크와 외부 네트워크의 머신을 물리적 또는 논리적으로 분리함으로써 구현될 수 있습니다. 외부 네트워크와의 격리 수준에 관계없이, 연결이 끊긴 환경의 클러스터는 Red Hat이 호스팅하는 공용 서비스에 액세스할 수 없으며 전체 클러스터 기능을 유지하려면 추가 설정이 필요합니다. |
제한된 네트워크 | 외부 네트워크와의 연결이 제한된 환경 또는 네트워크. 내부 네트워크와 외부 네트워크의 머신 간에 물리적 연결이 존재할 수 있지만, 방화벽과 프록시 등의 추가 구성으로 인해 네트워크 트래픽이 제한됩니다. |
1.2. 연결이 끊긴 환경에서 작업하기 위한 선호 방법 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 클러스터를 관리하는 대부분의 측면에서 여러 옵션 중에서 선택할 수 있습니다. 예를 들어 이미지를 미러링할 때 oc-mirror OpenShift CLI(oc
) 플러그인을 사용하거나 oc adm
명령을 사용하여 선택할 수 있습니다.
그러나 일부 옵션은 연결이 끊긴 환경에서 더 간단하고 편리한 사용자 환경을 제공하며, 다른 대안보다 선호되는 방법입니다.
조직의 필요에 따라 다른 옵션을 선택해야 하는 경우가 아니면 다음 방법을 사용하여 이미지 미러링, 클러스터 설치 및 클러스터 업데이트를 수행하세요.
- oc-mirror 플러그인 v2를 사용하여 이미지를 미러링합니다.
- 에이전트 기반 설치 프로그램을 사용하여 클러스터를 설치하세요.
- 로컬 OpenShift 업데이트 서비스 인스턴스를 사용하여 클러스터를 업데이트합니다.
2장. 연결된 클러스터를 연결이 끊긴 클러스터로 변환 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터를 연결된 클러스터에서 연결이 끊긴 클러스터로 변환해야 하는 경우가 있을 수 있습니다.
연결이 끊긴 클러스터는 제한된 클러스터라고도 하며 인터넷에 활성으로 연결되어 있지 않습니다. 따라서 레지스트리와 설치 미디어의 내용을 미러링해야 합니다. 인터넷과 폐쇄된 네트워크에 모두 액세스할 수 있는 호스트에 이 미러 레지스트리를 만들거나, 네트워크 경계를 넘어 이동할 수 있는 장치에 이미지를 복사할 수 있습니다.
이 주제에서는 기존의 연결된 클러스터를 연결이 끊긴 클러스터로 변환하는 일반적인 프로세스를 설명합니다.
2.1. 미러 레지스트리 정보 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 설치 및 후속 제품 업데이트에 필요한 이미지를 Red Hat Quay, JFrog Artifactory, Sonatype Nexus Repository 또는 Harbor와 같은 컨테이너 미러 레지스트리에 미러링할 수 있습니다. 대규모 컨테이너 레지스트리에 액세스할 수 없는 경우 OpenShift Container Platform 구독에 포함된 소규모 컨테이너 레지스트리인 Red Hat OpenShift용 미러 레지스트리를 사용할 수 있습니다.
Red Hat Quay, Red Hat OpenShift의 미러 레지스트리 , Artifactory, Sonatype Nexus Repository 또는 Harbor 등 Docker v2-2를 지원하는 모든 컨테이너 레지스트리를 사용할 수 있습니다. 선택한 레지스트리에 관계없이 인터넷상의 Red Hat 호스팅 사이트의 콘텐츠를 격리된 이미지 레지스트리로 미러링하는 절차는 동일합니다. 콘텐츠를 미러링한 후 미러 레지스트리에서 이 콘텐츠를 검색하도록 각 클러스터를 설정합니다.
OpenShift 이미지 레지스트리는 미러링 프로세스 중에 필요한 태그 없이 푸시를 지원하지 않으므로 대상 레지스트리로 사용할 수 없습니다.
Red Hat OpenShift용 미러 레지스트리가 아닌 컨테이너 레지스트리를 선택하는 경우, 프로비저닝하는 클러스터의 모든 머신에서 접근할 수 있어야 합니다. 레지스트리에 연결할 수 없는 경우 설치, 업데이트 또는 워크로드 재배치와 같은 일반 작업이 실패할 수 있습니다. 따라서 고가용성 방식으로 미러 레지스트리를 실행해야하며 미러 레지스트리는 최소한 OpenShift Container Platform 클러스터의 프로덕션 환경의 가용성조건에 일치해야 합니다.
미러 레지스트리를 OpenShift Container Platform 이미지로 채우면 다음 두 가지 시나리오를 수행할 수 있습니다. 호스트가 인터넷과 미러 레지스트리에 모두 액세스할 수 있지만 클러스터 노드에 액세스 할 수 없는 경우 해당 머신의 콘텐츠를 직접 미러링할 수 있습니다. 이 프로세스를 connected mirroring(미러링 연결)이라고 합니다. 그러한 호스트가 없는 경우 이미지를 파일 시스템에 미러링한 다음 해당 호스트 또는 이동식 미디어를 제한된 환경에 배치해야 합니다. 이 프로세스를 미러링 연결 해제라고 합니다.
미러링된 레지스트리의 경우 가져온 이미지의 소스를 보려면 CRI-O 로그의 Trying to access
로그 항목을 검토해야 합니다. 노드에서 crictl images
명령을 사용하는 등의 이미지 가져오기 소스를 보는 다른 방법은 미러링되지 않은 이미지 이름을 표시합니다.
Red Hat은 OpenShift Container Platform에서 타사 레지스트리를 테스트하지 않습니다.
2.2. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
-
oc
클라이언트가 설치되었습니다. - 실행 중인 클러스터가 있어야 합니다.
다음 레지스트리 중 하나와 같이 OpenShift Container Platform 클러스터를 호스팅할 위치에서 Docker v2-2를 지원하는 컨테이너 이미지 레지스트리인 설치된 미러 레지스트리:
Red Hat Quay에 대한 서브스크립션이 있는 경우 개념 증명 목적으로 또는 Quay Operator를 사용하여 Red Hat Quay 배포에 대한 설명서를 참조하십시오.
- 미러 저장소는 이미지를 공유하도록 구성되어야 합니다. 예를 들어, Red Hat Quay 저장소에는 이미지를 공유하기 위한 조직이 필요합니다.
- 필요한 컨테이너 이미지를 얻기 위해 인터넷에 접속합니다.
2.3. 미러링을 위한 클러스터 준비 링크 복사링크가 클립보드에 복사되었습니다!
클러스터의 연결을 끊기 전에 연결이 끊긴 클러스터의 모든 노드가 접근할 수 있는 미러 레지스트리에 이미지를 미러링하거나 복사해야 합니다. 이미지를 미러링하려면 다음과 같이 클러스터를 준비해야 합니다.
- 호스트의 신뢰할 수 있는 CA 목록에 미러 레지스트리 인증서를 추가합니다.
-
cloud.openshift.com
토큰에서 가져온 이미지 풀 시크릿을 포함하는.dockerconfigjson
파일을 생성합니다.
프로세스
이미지 미러링을 허용하는 자격 증명 구성:
신뢰할 수 있는 CA 목록에 간단한 PEM 또는 DER 파일 형식의 미러 레지스트리에 대한 CA 인증서를 추가합니다. 예를 들면 다음과 같습니다.
cp </path/to/cert.crt> /usr/share/pki/ca-trust-source/anchors/
$ cp </path/to/cert.crt> /usr/share/pki/ca-trust-source/anchors/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 다음과 같습니다.,
</path/to/cert.crt>
- 로컬 파일 시스템의 인증서 경로를 지정합니다.
- 다음과 같습니다.,
CA 신뢰를 업데이트합니다. 예를 들어, Linux에서는:
update-ca-trust
$ update-ca-trust
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 글로벌 가져오기 보안에서
.dockerconfigjson
파일을 추출합니다.oc extract secret/pull-secret -n openshift-config --confirm --to=.
$ oc extract secret/pull-secret -n openshift-config --confirm --to=.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
.dockerconfigjson
.dockerconfigjson
Copy to Clipboard Copied! Toggle word wrap Toggle overflow .dockerconfigjson
파일을 편집하여 미러 레지스트리와 인증 자격 증명을 추가하고 새 파일로 저장합니다.{"auths":{"<local_registry>": {"auth": "<credentials>","email": "you@example.com"}}},"<registry>:<port>/<namespace>/":{"auth":"<token>"}}}
{"auths":{"<local_registry>": {"auth": "<credentials>","email": "you@example.com"}}},"<registry>:<port>/<namespace>/":{"auth":"<token>"}}}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
<local_registry>
- 미러 레지스트리가 콘텐츠를 제공하는 데 사용하는 레지스트리 도메인 이름과, 선택적으로 포트를 지정합니다.
auth
- 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름과 비밀번호를 지정합니다.
<registry>:<port>/<namespace>
- 미러 레지스트리 세부 정보를 지정합니다.
<token>
미러 레지스트리에 대한 base64로 인코딩된
사용자 이름:암호를
지정합니다.예를 들면 다음과 같습니다.
{"auths":{"cloud.openshift.com":{"auth":"b3BlbnNoaWZ0Y3UjhGOVZPT0lOMEFaUjdPUzRGTA==","email":"user@example.com"},
$ {"auths":{"cloud.openshift.com":{"auth":"b3BlbnNoaWZ0Y3UjhGOVZPT0lOMEFaUjdPUzRGTA==","email":"user@example.com"}, "quay.io":{"auth":"b3BlbnNoaWZ0LXJlbGVhc2UtZGOVZPT0lOMEFaUGSTd4VGVGVUjdPUzRGTA==","email":"user@example.com"}, "registry.connect.redhat.com"{"auth":"NTE3MTMwNDB8dWhjLTFEZlN3VHkxOSTd4VGVGVU1MdTpleUpoYkdjaUailA==","email":"user@example.com"}, "registry.redhat.io":{"auth":"NTE3MTMwNDB8dWhjLTFEZlN3VH3BGSTd4VGVGVU1MdTpleUpoYkdjaU9fZw==","email":"user@example.com"}, "registry.svc.ci.openshift.org":{"auth":"dXNlcjpyWjAwWVFjSEJiT2RKVW1pSmg4dW92dGp1SXRxQ3RGN1pwajJhN1ZXeTRV"},"my-registry:5000/my-namespace/":{"auth":"dXNlcm5hbWU6cGFzc3dvcmQ="}}}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.4. 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
클러스터가 올바르게 구성된 후에는 외부 저장소의 이미지를 미러 저장소로 미러링할 수 있습니다.
프로세스
Operator Lifecycle Manager(OLM) 이미지를 미러링합니다.
oc adm catalog mirror registry.redhat.io/redhat/redhat-operator-index:v{product-version} <mirror_registry>:<port>/olm -a <reg_creds>
$ oc adm catalog mirror registry.redhat.io/redhat/redhat-operator-index:v{product-version} <mirror_registry>:<port>/olm -a <reg_creds>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
product-version
-
설치할 OpenShift Container Platform 버전에 해당하는 태그를 지정합니다(예:
4.8
). mirror_registry
-
Operator 콘텐츠를 미러링할 대상 레지스트리와 네임스페이스에 대한 정규화된 도메인 이름(FQDN)을 지정합니다. 여기서
<네임스페이스>는
레지스트리에 있는 기존 네임스페이스입니다. reg_creds
-
수정된
.dockerconfigjson
파일의 위치를 지정합니다.
예를 들면 다음과 같습니다.
oc adm catalog mirror registry.redhat.io/redhat/redhat-operator-index:v4.8 mirror.registry.com:443/olm -a ./.dockerconfigjson --index-filter-by-os='.*'
$ oc adm catalog mirror registry.redhat.io/redhat/redhat-operator-index:v4.8 mirror.registry.com:443/olm -a ./.dockerconfigjson --index-filter-by-os='.*'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다른 Red Hat 제공 운영자에 대한 콘텐츠를 미러링합니다.
oc adm catalog mirror <index_image> <mirror_registry>:<port>/<namespace> -a <reg_creds>
$ oc adm catalog mirror <index_image> <mirror_registry>:<port>/<namespace> -a <reg_creds>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
index_image
- 미러링하려는 카탈로그의 인덱스 이미지를 지정합니다.
mirror_registry
-
Operator 콘텐츠를 미러링할 대상 레지스트리와 네임스페이스의 FQDN을 지정합니다. 여기서
<네임스페이스>
는 레지스트리에 있는 기존 네임스페이스입니다. reg_creds
- 선택 사항: 필요한 경우 레지스트리 자격 증명 파일의 위치를 지정합니다.
예를 들면 다음과 같습니다.
oc adm catalog mirror registry.redhat.io/redhat/community-operator-index:v4.8 mirror.registry.com:443/olm -a ./.dockerconfigjson --index-filter-by-os='.*'
$ oc adm catalog mirror registry.redhat.io/redhat/community-operator-index:v4.8 mirror.registry.com:443/olm -a ./.dockerconfigjson --index-filter-by-os='.*'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift 컨테이너 플랫폼 이미지 저장소를 미러링합니다.
oc adm release mirror -a .dockerconfigjson --from=quay.io/openshift-release-dev/ocp-release:v<product-version>-<architecture> --to=<local_registry>/<local_repository> --to-release-image=<local_registry>/<local_repository>:v<product-version>-<architecture>
$ oc adm release mirror -a .dockerconfigjson --from=quay.io/openshift-release-dev/ocp-release:v<product-version>-<architecture> --to=<local_registry>/<local_repository> --to-release-image=<local_registry>/<local_repository>:v<product-version>-<architecture>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
product-version
-
설치할 OpenShift Container Platform 버전에 해당하는 태그(예:
4.8.15-x86_64)
를 지정합니다. architecture
-
서버의 아키텍처 유형(예:
x86_64
)을 지정합니다. local_registry
- 미러 저장소에 대한 레지스트리 도메인 이름을 지정합니다.
local_repository
-
레지스트리에 생성할 저장소의 이름을 지정합니다(예:
ocp4/openshift4
).
예를 들면 다음과 같습니다.
oc adm release mirror -a .dockerconfigjson --from=quay.io/openshift-release-dev/ocp-release:4.8.15-x86_64 --to=mirror.registry.com:443/ocp/release --to-release-image=mirror.registry.com:443/ocp/release:4.8.15-x86_64
$ oc adm release mirror -a .dockerconfigjson --from=quay.io/openshift-release-dev/ocp-release:4.8.15-x86_64 --to=mirror.registry.com:443/ocp/release --to-release-image=mirror.registry.com:443/ocp/release:4.8.15-x86_64
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 필요에 따라 다른 레지스트리를 미러링합니다.
oc image mirror <online_registry>/my/image:latest <mirror_registry>
$ oc image mirror <online_registry>/my/image:latest <mirror_registry>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.5. 미러 레지스트리를 위한 클러스터 구성 링크 복사링크가 클립보드에 복사되었습니다!
이미지를 생성하고 미러 레지스트리에 미러링한 후에는 포드가 미러 레지스트리에서 이미지를 가져올 수 있도록 클러스터를 수정해야 합니다.
다음을 수행해야 합니다.
- 글로벌 풀 시크릿에 미러 레지스트리 자격 증명을 추가합니다.
- 클러스터에 미러 레지스트리 서버 인증서를 추가합니다.
미러 레지스트리를 소스 레지스트리와 연결하는
ImageContentSourcePolicy
사용자 정의 리소스(ICSP)를 만듭니다.클러스터 글로벌 풀 시크릿에 미러 레지스트리 자격 증명을 추가합니다.
oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=<pull_secret_location>
$ oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=<pull_secret_location>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 새 풀 시크릿 파일의 경로를 제공합니다.
예를 들면 다음과 같습니다.
oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=.mirrorsecretconfigjson
$ oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=.mirrorsecretconfigjson
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 클러스터의 노드에 CA 서명 미러 레지스트리 서버 인증서를 추가합니다.
미러 레지스트리에 대한 서버 인증서를 포함하는 구성 맵을 만듭니다.
oc create configmap <config_map_name> --from-file=<mirror_address_host>..<port>=$path/ca.crt -n openshift-config
$ oc create configmap <config_map_name> --from-file=<mirror_address_host>..<port>=$path/ca.crt -n openshift-config
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예를 들면 다음과 같습니다.
S oc create configmap registry-config --from-file=mirror.registry.com..443=/root/certs/ca-chain.cert.pem -n openshift-config
S oc create configmap registry-config --from-file=mirror.registry.com..443=/root/certs/ca-chain.cert.pem -n openshift-config
Copy to Clipboard Copied! Toggle word wrap Toggle overflow config 맵을 사용하여
image.config.openshift.io/cluster
사용자 정의 리소스(CR)를 업데이트합니다. OpenShift Container Platform은 이 CR에 대한 변경 사항을 클러스터의 모든 노드에 적용합니다.oc patch image.config.openshift.io/cluster --patch '{"spec":{"additionalTrustedCA":{"name":"<config_map_name>"}}}' --type=merge
$ oc patch image.config.openshift.io/cluster --patch '{"spec":{"additionalTrustedCA":{"name":"<config_map_name>"}}}' --type=merge
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예를 들면 다음과 같습니다.
oc patch image.config.openshift.io/cluster --patch '{"spec":{"additionalTrustedCA":{"name":"registry-config"}}}' --type=merge
$ oc patch image.config.openshift.io/cluster --patch '{"spec":{"additionalTrustedCA":{"name":"registry-config"}}}' --type=merge
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
온라인 레지스트리에서 미러 레지스트리로 컨테이너 풀 요청을 리디렉션하기 위해 ICSP를 만듭니다.
ImageContentSourcePolicy
사용자 지정 리소스를 만듭니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow ICSP 객체를 생성합니다.
oc create -f registryrepomirror.yaml
$ oc create -f registryrepomirror.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
imagecontentsourcepolicy.operator.openshift.io/mirror-ocp created
imagecontentsourcepolicy.operator.openshift.io/mirror-ocp created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Container Platform은 이 CR에 대한 변경 사항을 클러스터의 모든 노드에 적용합니다.
미러 레지스트리에 대한 자격 증명, CA 및 ICSP가 추가되었는지 확인하세요.
노드에 로그인:
oc debug node/<node_name>
$ oc debug node/<node_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 디버그 쉘 내에서
/host
를 root 디렉터리로 설정합니다.chroot /host
sh-4.4# chroot /host
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 자격 증명을 확인하려면
config.json
파일을 확인하세요.cat /var/lib/kubelet/config.json
sh-4.4# cat /var/lib/kubelet/config.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
{"auths":{"brew.registry.redhat.io":{"xx=="},"brewregistry.stage.redhat.io":{"auth":"xxx=="},"mirror.registry.com:443":{"auth":"xx="}}}
{"auths":{"brew.registry.redhat.io":{"xx=="},"brewregistry.stage.redhat.io":{"auth":"xxx=="},"mirror.registry.com:443":{"auth":"xx="}}}
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 미러 레지스트리 및 인증 정보가 있는지 확인합니다.
certs.d
디렉토리로 변경cd /etc/docker/certs.d/
sh-4.4# cd /etc/docker/certs.d/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow certs.d
디렉토리에 있는 인증서를 나열하세요.ls
sh-4.4# ls
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
image-registry.openshift-image-registry.svc.cluster.local:5000 image-registry.openshift-image-registry.svc:5000 mirror.registry.com:443
image-registry.openshift-image-registry.svc.cluster.local:5000 image-registry.openshift-image-registry.svc:5000 mirror.registry.com:443
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 미러 레지스트리가 목록에 있는지 확인하세요.
ICSP가
registries.conf
파일에 미러 레지스트리를 추가했는지 확인하세요.cat /etc/containers/registries.conf
sh-4.4# cat /etc/containers/registries.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow registry.mirror
매개변수는 원본 레지스트리보다 미러 레지스트리가 먼저 검색된다는 것을 나타냅니다.노드를 종료합니다.
exit
sh-4.4# exit
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.6. 응용 프로그램이 계속 작동하는지 확인하세요 링크 복사링크가 클립보드에 복사되었습니다!
네트워크에서 클러스터의 연결을 끊기 전에 클러스터가 예상대로 작동하고 모든 애플리케이션이 예상대로 작동하는지 확인하세요.
프로세스
다음 명령을 사용하여 클러스터 상태를 확인하세요.
포드가 실행 중인지 확인하세요.
oc get pods --all-namespaces
$ oc get pods --all-namespaces
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 노드가 READY 상태인지 확인하세요.
oc get nodes
$ oc get nodes
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.7. 네트워크에서 클러스터를 분리합니다. 링크 복사링크가 클립보드에 복사되었습니다!
필요한 모든 저장소를 미러링하고 클러스터를 연결 해제된 클러스터로 작동하도록 구성한 후 네트워크에서 클러스터의 연결을 끊을 수 있습니다.
클러스터의 인터넷 연결이 끊어지면 Insights Operator의 성능이 저하됩니다. Insights Operator를 복원할 때까지 일시적으로 비활성화 하면 이 문제를 방지할 수 있습니다.
2.8. 성능 저하된 Insights Operator 복원 링크 복사링크가 클립보드에 복사되었습니다!
클러스터를 네트워크에서 분리하면 클러스터의 인터넷 연결도 반드시 끊어집니다. Insights Operator는 Red Hat Insights 에 액세스해야 하므로 성능이 저하됩니다.
이 주제에서는 성능이 저하된 Insights Operator를 복구하는 방법을 설명합니다.
프로세스
예를 들어
.dockerconfigjson
파일을 편집하여cloud.openshift.com
항목을 제거합니다."cloud.openshift.com":{"auth":"<hash>","email":"user@example.com"}
"cloud.openshift.com":{"auth":"<hash>","email":"user@example.com"}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 파일을 저장합니다.
편집된
.dockerconfigjson
파일로 클러스터 비밀을 업데이트합니다.oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=./.dockerconfigjson
$ oc set data secret/pull-secret -n openshift-config --from-file=.dockerconfigjson=./.dockerconfigjson
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Insights Operator가 더 이상 저하되지 않았는지 확인하세요.
oc get co insights
$ oc get co insights
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE insights 4.5.41 True False False 3d
NAME VERSION AVAILABLE PROGRESSING DEGRADED SINCE insights 4.5.41 True False False 3d
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.9. 네트워크 복구 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 클러스터를 다시 연결하고 온라인 레지스트리에서 이미지를 가져오려면 클러스터의 ImageContentSourcePolicy(ICSP) 객체를 삭제합니다. ICSP가 없으면 외부 레지스트리로 가져오기 요청이 더 이상 미러 레지스트리로 리디렉션되지 않습니다.
프로세스
클러스터의 ICSP 객체를 확인하세요.
oc get imagecontentsourcepolicy
$ oc get imagecontentsourcepolicy
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME AGE mirror-ocp 6d20h ocp4-index-0 6d18h qe45-index-0 6d15h
NAME AGE mirror-ocp 6d20h ocp4-index-0 6d18h qe45-index-0 6d15h
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 클러스터 연결을 끊을 때 생성한 모든 ICSP 객체를 삭제합니다.
oc delete imagecontentsourcepolicy <icsp_name> <icsp_name> <icsp_name>
$ oc delete imagecontentsourcepolicy <icsp_name> <icsp_name> <icsp_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예를 들면 다음과 같습니다.
oc delete imagecontentsourcepolicy mirror-ocp ocp4-index-0 qe45-index-0
$ oc delete imagecontentsourcepolicy mirror-ocp ocp4-index-0 qe45-index-0
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
imagecontentsourcepolicy.operator.openshift.io "mirror-ocp" deleted imagecontentsourcepolicy.operator.openshift.io "ocp4-index-0" deleted imagecontentsourcepolicy.operator.openshift.io "qe45-index-0" deleted
imagecontentsourcepolicy.operator.openshift.io "mirror-ocp" deleted imagecontentsourcepolicy.operator.openshift.io "ocp4-index-0" deleted imagecontentsourcepolicy.operator.openshift.io "qe45-index-0" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 모든 노드가 다시 시작되고 READY 상태로 돌아갈 때까지 기다린 후
registries.conf
파일이 미러 레지스트리가 아닌 원본 레지스트리를 가리키는지 확인하세요.노드에 로그인:
oc debug node/<node_name>
$ oc debug node/<node_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 디버그 쉘 내에서
/host
를 root 디렉터리로 설정합니다.chroot /host
sh-4.4# chroot /host
Copy to Clipboard Copied! Toggle word wrap Toggle overflow registries.conf
파일을 살펴보세요.cat /etc/containers/registries.conf
sh-4.4# cat /etc/containers/registries.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 삭제한 ICSP에서 생성된
registry
및registry.mirror
항목이 제거됩니다.
3장. 연결이 끊긴 환경에서의 미러링 링크 복사링크가 클립보드에 복사되었습니다!
3.1. 연결 해제된 설치 미러링 정보 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 관리자는 미러 레지스트리를 사용하여 클러스터가 외부 콘텐츠에 대한 조직적 통제를 충족하는 컨테이너 이미지만 사용하도록 할 수 있습니다.
3.1.1. 연결이 끊긴 환경에 클러스터를 설치하기 위한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
클러스터를 설치하고 프로비저닝하려면 먼저 필요한 컨테이너 이미지를 연결이 끊긴 환경으로 미러링해야 합니다. 해당 컨테이너 이미지를 미러링하려면 미러 레지스트리가 필요합니다. 미러 레지스트리를 만들고 사용하기 위해 다음 옵션을 고려하세요.
- Red Hat Quay와 같은 컨테이너 이미지 레지스트리가 이미 있는 경우 이를 미러 레지스트리로 사용할 수 있습니다. 아직 레지스트리가 없다면 레지스트리를 만들어야 합니다.
-
레지스트리를 구축한 후에는 미러링 도구가 필요합니다. 연결이 끊긴 환경에서 OpenShift Container Platform 이미지 저장소를 미러링하려면 oc-mirror OpenShift CLI(
oc
) 플러그인을 사용할 수 있습니다. oc-mirror 플러그인은 모든 필수 OpenShift Container Platform 콘텐츠와 기타 이미지를 미러 레지스트리로 미러링하는 단일 도구입니다. oc-mirror 플러그인은 미러링을 위한 선호되는 방법입니다. -
또는
oc adm
명령을 사용하여 OpenShift Container Platform의 릴리스 및 카탈로그 이미지만 미러링할 수 있습니다.
3.2. Red Hat OpenShift용 미러 레지스트리를 사용하여 미러 레지스트리 생성 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift용 미러 레지스트리는 연결이 끊긴 설치 환경에서 OpenShift Container Platform의 필수 컨테이너 이미지를 미러링하기 위한 대상으로 사용할 수 있는 작고 간소화된 컨테이너 레지스트리입니다.
Red Hat Quay 와 같은 컨테이너 이미지 레지스트리가 이미 있는 경우 이 섹션을 건너뛰고 바로 OpenShift 컨테이너 플랫폼 이미지 저장소 미러링 으로 이동할 수 있습니다.
Red Hat OpenShift의 미러 레지스트리는 Red Hat Quay의 프로덕션 배포를 대체하기 위한 것이 아닙니다.
3.2.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
- OpenShift Container Platform 서브스크립션
- Podman 3.4.2 이상과 OpenSSL이 설치된 Red Hat Enterprise Linux(RHEL) 8 및 9.
- DNS 서버를 통해 확인되어야 하는 Red Hat Quay 서비스에 대한 정규화된 도메인 이름입니다.
- 대상 호스트의 키 기반 SSH 연결 로컬 설치를 위해 SSH 키가 자동으로 생성됩니다. 원격 호스트의 경우 자체 SSH 키를 생성해야 합니다.
- 2개 이상의 vCPU
- 8GB RAM.
OpenShift Container Platform 4.19 릴리스 이미지의 경우 약 12GB, OpenShift Container Platform 4.19 릴리스 이미지와 OpenShift Container Platform 4.19 Red Hat Operator 이미지의 경우 약 358GB입니다.
중요- 스트림당 최대 1TB 또는 그 이상이 권장됩니다.
- 이러한 요구 사항은 릴리스 이미지 및 Operator 이미지만을 사용한 로컬 테스트 결과를 기반으로 합니다. 스토리지 요구 사항은 조직의 요구에 따라 다를 수 있습니다. 예를 들어 여러 z-streams를 미러링할 때 더 많은 공간이 필요할 수 있습니다. 표준 Red Hat Quay 기능 이나 적절한 API 콜아웃을 사용하여 불필요한 이미지를 제거하고 공간을 확보할 수 있습니다.
3.2.2. Red Hat OpenShift 배포를 위한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform의 연결이 끊긴 배포의 경우 클러스터 설치를 수행하려면 컨테이너 레지스트리가 필요합니다. 이러한 클러스터에서 프로덕션 레벨 레지스트리 서비스를 실행하려면 첫 번째 클러스터를 설치하기 위해 별도의 레지스트리 배포를 생성해야 합니다. Red Hat OpenShift용 미러 레지스트리는 이러한 요구 사항을 해결하며 모든 OpenShift Container Platform 구독에 포함되어 있습니다. OpenShift 콘솔 다운로드 페이지에서 다운로드할 수 있습니다.
Red Hat OpenShift용 미러 레지스트리를 사용하면 사용자가 미러 레지스트리
명령줄 인터페이스(CLI) 도구를 사용하여 소규모 버전의 Red Hat Quay와 필수 구성 요소를 설치할 수 있습니다. Red Hat OpenShift용 미러 레지스트리는 사전 구성된 로컬 스토리지와 로컬 데이터베이스를 사용하여 자동으로 배포됩니다. 또한 단일 입력 세트로 자동 생성된 사용자 자격 증명 및 액세스 권한이 포함되며, 추가 구성 옵션 없이 시작할 수 있습니다.
Red Hat OpenShift용 미러 레지스트리는 미리 결정된 네트워크 구성을 제공하고 성공 시 배포된 구성 요소 자격 증명과 액세스 URL을 보고합니다. 또한, 정규화된 도메인 이름(FQDN) 서비스, 슈퍼유저 이름 및 비밀번호, 사용자 지정 TLS 인증서와 같은 제한된 선택적 구성 입력 세트도 제공됩니다. 이를 통해 제한된 네트워크 환경에서 OpenShift Container Platform을 실행할 때 모든 OpenShift Container Platform 릴리스 콘텐츠의 오프라인 미러를 쉽게 생성할 수 있도록 컨테이너 레지스트리가 제공됩니다.
설치 환경에서 다른 컨테이너 레지스트리가 이미 사용 가능한 경우 Red Hat OpenShift용 미러 레지스트리를 사용하는 것은 선택 사항입니다.
3.2.2.1. Red Hat OpenShift 제한 사항에 대한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift의 미러 레지스트리 에는 다음과 같은 제한 사항이 적용됩니다.
- Red Hat OpenShift용 미러 레지스트리는 고가용성 레지스트리가 아니며 로컬 파일 시스템 스토리지만 지원됩니다. Red Hat Quay나 OpenShift Container Platform의 내부 이미지 레지스트리를 대체하려는 것이 아닙니다.
- Red Hat OpenShift의 미러 레지스트리는 Red Hat Quay의 프로덕션 배포를 대체하기 위한 것이 아닙니다.
Red Hat OpenShift용 미러 레지스트리는 릴리스 이미지나 Red Hat Operator 이미지와 같이 연결이 끊긴 OpenShift Container Platform 클러스터를 설치하는 데 필요한 이미지를 호스팅하는 경우에만 지원됩니다. Red Hat Enterprise Linux(RHEL) 시스템의 로컬 스토리지를 사용하고, RHEL에서 지원하는 스토리지는 Red Hat OpenShift의 미러 레지스트리 에서도 지원됩니다.
참고Red Hat OpenShift의 미러 레지스트리는 로컬 스토리지를 사용하므로 이미지를 미러링할 때 사용되는 스토리지 사용량을 파악하고 Red Hat Quay의 가비지 수집 기능을 사용하여 잠재적인 문제를 완화해야 합니다. 이 기능에 대한 자세한 내용은 "Red Hat Quay 가비지 수집"을 참조하세요.
- 부트스트래핑 목적으로 Red Hat OpenShift의 미러 레지스트리 에 푸시되는 Red Hat 제품 이미지에 대한 지원은 각 제품에 대한 유효한 구독을 통해 제공됩니다. 부트스트랩 환경을 더욱 활성화하기 위한 예외 목록은 자체 관리형 Red Hat OpenShift 크기 조정 및 구독 가이드 에서 확인할 수 있습니다.
- 고객이 구축한 콘텐츠는 Red Hat OpenShift 미러 레지스트리 에서 호스팅되어서는 안 됩니다.
- 여러 클러스터가 있는 Red Hat OpenShift에 미러 레지스트리를 사용하는 것은 권장되지 않습니다. 클러스터 플릿을 업데이트할 때 여러 클러스터가 단일 실패 지점을 생성할 수 있기 때문입니다. 대신 Red Hat OpenShift용 미러 레지스트리를 사용하여 Red Hat Quay와 같은 프로덕션 수준의 고가용성 레지스트리를 호스팅할 수 있는 클러스터를 설치합니다. 그러면 다른 클러스터에 OpenShift Container Platform 콘텐츠를 제공할 수 있습니다.
3.2.3. Red Hat OpenShift의 미러 레지스트리를 사용하여 로컬 호스트에서 미러링 링크 복사링크가 클립보드에 복사되었습니다!
이 절차에서는 mirror-registry
설치 도구를 사용하여 로컬 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치하는 방법을 설명합니다. 이렇게 하면 OpenShift Container Platform 이미지의 미러를 저장하기 위해 포트 443에서 실행되는 로컬 호스트 레지스트리를 생성할 수 있습니다.
mirror-registry
CLI 도구를 사용하여 Red Hat OpenShift용 미러 레지스트리를 설치하면 컴퓨터에 여러 가지 변경 사항이 적용됩니다. 설치 후 $HOME/quay-install
디렉토리가 생성되는데, 여기에는 설치 파일, 로컬 저장소, 구성 번들이 들어 있습니다. 배포 대상이 로컬 호스트인 경우 신뢰할 수 있는 SSH 키가 생성되고, 컨테이너 런타임이 영구적인지 확인하기 위해 호스트 시스템의 systemd 파일이 설정됩니다. 또한 init
라는 초기 사용자는 자동으로 생성된 암호를 사용하여 생성됩니다. 모든 액세스 인증 정보는 설치 루틴이 끝나면 출력됩니다.
프로세스
-
OpenShift 콘솔 다운로드 페이지에서 Red Hat OpenShift용 미러 레지스트리 의 최신 버전인
mirror-registry.tar.gz
패키지를 다운로드하세요. mirror-registry
도구를 사용하여 현재 사용자 계정으로 로컬 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치합니다. 사용 가능한 플래그의 전체 목록을 보려면 "Red Hat OpenShift 플래그용 미러 레지스트리"를 참조하세요../mirror-registry install \ --quayHostname <host_example_com> \ --quayRoot <example_directory_name>
$ ./mirror-registry install \ --quayHostname <host_example_com> \ --quayRoot <example_directory_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 설치 중에 생성된 사용자 이름과 비밀번호를 사용하여 레지스트리에 로그인합니다.
podman login -u init \ -p <password> \ <host_example_com>:8443> \ --tls-verify=false
$ podman login -u init \ -p <password> \ <host_example_com>:8443> \ --tls-verify=false
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 생성된 rootCA 인증서를 신뢰하도록 시스템을 구성하여
--tls-verify=false
실행을 방지할 수 있습니다. 자세한 내용은 "Red Hat Quay 보안" 및 "인증 기관을 신뢰하도록 시스템 구성"을 참조하세요.
참고설치 후
https://<host.example.com>:8443
에서 UI에 액세스하여 로그인할 수도 있습니다.로그인 후 OpenShift Container Platform 이미지를 미러링할 수 있습니다. 필요에 따라 이 문서의 "OpenShift Container Platform 이미지 리포지토리 미러링" 또는 "연결이 끊긴 클러스터에 사용할 Operator 카탈로그 미러링" 섹션을 참조하십시오.
참고스토리지 계층 문제로 인해 Red Hat OpenShift의 미러 레지스트리 에 저장된 이미지에 문제가 있는 경우, OpenShift Container Platform 이미지를 다시 미러링하거나, 더 안정적인 스토리지에 미러 레지스트리를 다시 설치할 수 있습니다.
3.2.4. 로컬 호스트에서 Red Hat OpenShift의 미러 레지스트리 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
이 절차에서는 upgrade
명령을 사용하여 로컬 호스트에서 Red Hat OpenShift의 미러 레지스트리를 업데이트하는 방법을 설명합니다. 최신 버전으로 업데이트하면 새로운 기능, 버그 수정, 보안 취약점 수정이 보장됩니다.
버전 1에서 버전 2로 업그레이드할 때 다음 제약 사항을 유의하세요.
-
SQLite에서는 여러 쓰기가 허용되지 않으므로 작업자 수는
1
로 설정됩니다. - Red Hat OpenShift 사용자 인터페이스(UP)에는 미러 레지스트리를 사용하면 안 됩니다.
-
업그레이드하는 동안
sqlite-storage
Podman 볼륨에 액세스하지 마세요. - 업그레이드 프로세스 중에 미러 레지스트리가 다시 시작되므로 간헐적으로 다운타임이 발생합니다.
-
PostgreSQL 데이터는 복구를 위해
/$HOME/quay-install/quay-postgres-backup/
디렉토리에 백업됩니다.
사전 요구 사항
- 로컬 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치했습니다.
프로세스
Red Hat OpenShift의 미러 레지스트리를 1.3 → 2.y로 업그레이드하고 설치 디렉터리가 기본값인
/etc/quay-install인
경우 다음 명령을 입력할 수 있습니다.sudo ./mirror-registry upgrade -v
$ sudo ./mirror-registry upgrade -v
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고-
Red Hat OpenShift용 미러 레지스트리는 Red Hat Quay 스토리지, Postgres 데이터 및
/etc/quay-install
데이터의 Podman 볼륨을 새로운$HOME/quay-install
위치로 마이그레이션합니다. 이를 통해 향후 업그레이드 시--quayRoot
플래그 없이도 Red Hat OpenShift에 대한 미러 레지스트리를 사용할 수 있습니다. -
./mirror-registry upgrade -v
플래그를 사용하여 Red Hat OpenShift의 미러 레지스트리를 업그레이드하는 사용자는 미러 레지스트리를 만들 때 사용한 것과 동일한 자격 증명을 포함해야 합니다. 예를 들어,--quayHostname <host_example_com>
및--quayRoot <example_directory_name>
을 사용하여 Red Hat OpenShift용 미러 레지스트리를 설치한 경우 미러 레지스트리를 올바르게 업그레이드하려면 해당 문자열을 포함해야 합니다.
-
Red Hat OpenShift용 미러 레지스트리는 Red Hat Quay 스토리지, Postgres 데이터 및
Red Hat OpenShift의 미러 레지스트리를 1.3 → 2.y로 업그레이드하고 1.y 배포에서 사용자 지정 quay 구성 및 스토리지 디렉터리를 사용한 경우
--quayRoot
및--quayStorage
플래그를 전달해야 합니다. 예를 들면 다음과 같습니다.sudo ./mirror-registry upgrade --quayHostname <host_example_com> --quayRoot <example_directory_name> --quayStorage <example_directory_name>/quay-storage -v
$ sudo ./mirror-registry upgrade --quayHostname <host_example_com> --quayRoot <example_directory_name> --quayStorage <example_directory_name>/quay-storage -v
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat OpenShift의 미러 레지스트리를 1.3 → 2.y로 업그레이드하고 사용자 정의 SQLite 스토리지 경로를 지정하려면 다음과 같이
--sqliteStorage
플래그를 전달해야 합니다.sudo ./mirror-registry upgrade --sqliteStorage <example_directory_name>/sqlite-storage -v
$ sudo ./mirror-registry upgrade --sqliteStorage <example_directory_name>/sqlite-storage -v
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 Red Hat OpenShift의 미러 레지스트리가 업데이트되었는지 확인하세요.
podman ps
$ podman ps
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
registry.redhat.io/quay/quay-rhel8:v3.12.10
registry.redhat.io/quay/quay-rhel8:v3.12.10
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2.5. Red Hat OpenShift의 미러 레지스트리를 사용하여 원격 호스트에서 미러링 링크 복사링크가 클립보드에 복사되었습니다!
이 절차에서는 mirror-registry
도구를 사용하여 원격 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치하는 방법을 설명합니다. 이렇게 하면 사용자가 OpenShift Container Platform 이미지의 미러를 저장할 레지스트리를 생성할 수 있습니다.
mirror-registry
CLI 도구를 사용하여 Red Hat OpenShift용 미러 레지스트리를 설치하면 컴퓨터에 여러 가지 변경 사항이 적용됩니다. 설치 후 $HOME/quay-install
디렉토리가 생성되는데, 여기에는 설치 파일, 로컬 저장소, 구성 번들이 들어 있습니다. 배포 대상이 로컬 호스트인 경우 신뢰할 수 있는 SSH 키가 생성되고, 컨테이너 런타임이 영구적인지 확인하기 위해 호스트 시스템의 systemd 파일이 설정됩니다. 또한 init
라는 초기 사용자는 자동으로 생성된 암호를 사용하여 생성됩니다. 모든 액세스 인증 정보는 설치 루틴이 끝나면 출력됩니다.
프로세스
-
OpenShift 콘솔 다운로드 페이지에서 Red Hat OpenShift용 미러 레지스트리 의 최신 버전인
mirror-registry.tar.gz
패키지를 다운로드하세요. mirror-registry
도구를 사용하여 현재 사용자 계정으로 로컬 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치합니다. 사용 가능한 플래그의 전체 목록을 보려면 "Red Hat OpenShift 플래그용 미러 레지스트리"를 참조하세요.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 설치 중에 생성된 사용자 이름과 비밀번호를 사용하여 미러 레지스트리에 로그인합니다.
podman login -u init \ -p <password> \ <host_example_com>:8443> \ --tls-verify=false
$ podman login -u init \ -p <password> \ <host_example_com>:8443> \ --tls-verify=false
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 생성된 rootCA 인증서를 신뢰하도록 시스템을 구성하여
--tls-verify=false
실행을 방지할 수 있습니다. 자세한 내용은 "Red Hat Quay 보안" 및 "인증 기관을 신뢰하도록 시스템 구성"을 참조하세요.
참고설치 후
https://<host.example.com>:8443
에서 UI에 액세스하여 로그인할 수도 있습니다.로그인 후 OpenShift Container Platform 이미지를 미러링할 수 있습니다. 필요에 따라 이 문서의 "OpenShift Container Platform 이미지 리포지토리 미러링" 또는 "연결이 끊긴 클러스터에 사용할 Operator 카탈로그 미러링" 섹션을 참조하십시오.
참고스토리지 계층 문제로 인해 Red Hat OpenShift의 미러 레지스트리 에 저장된 이미지에 문제가 있는 경우, OpenShift Container Platform 이미지를 다시 미러링하거나, 더 안정적인 스토리지에 미러 레지스트리를 다시 설치할 수 있습니다.
3.2.6. 원격 호스트에서 Red Hat OpenShift의 미러 레지스트리 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
이 절차에서는 upgrade
명령을 사용하여 원격 호스트에서 Red Hat OpenShift의 미러 레지스트리를 업데이트하는 방법을 설명합니다. 최신 버전으로 업데이트하면 버그 수정 및 보안 취약점 수정이 제공됩니다.
버전 1에서 버전 2로 업그레이드할 때 다음 제약 사항을 유의하세요.
-
SQLite에서는 여러 쓰기가 허용되지 않으므로 작업자 수는
1
로 설정됩니다. - Red Hat OpenShift 사용자 인터페이스(UP)에는 미러 레지스트리를 사용하면 안 됩니다.
-
업그레이드하는 동안
sqlite-storage
Podman 볼륨에 액세스하지 마세요. - 업그레이드 프로세스 중에 미러 레지스트리가 다시 시작되므로 간헐적으로 다운타임이 발생합니다.
-
PostgreSQL 데이터는 복구를 위해
/$HOME/quay-install/quay-postgres-backup/
디렉토리에 백업됩니다.
사전 요구 사항
- 원격 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치했습니다.
프로세스
원격 호스트에서 Red Hat OpenShift의 미러 레지스트리를 업그레이드하려면 다음 명령을 입력하세요.
./mirror-registry upgrade -v --targetHostname <remote_host_url> --targetUsername <user_name> -k ~/.ssh/my_ssh_key
$ ./mirror-registry upgrade -v --targetHostname <remote_host_url> --targetUsername <user_name> -k ~/.ssh/my_ssh_key
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고./mirror-registry upgrade -v
플래그를 사용하여 Red Hat OpenShift의 미러 레지스트리를 업그레이드하는 사용자는 미러 레지스트리를 만들 때 사용한 것과 동일한 자격 증명을 포함해야 합니다. 예를 들어,--quayHostname <host_example_com>
및--quayRoot <example_directory_name>
을 사용하여 Red Hat OpenShift용 미러 레지스트리를 설치한 경우 미러 레지스트리를 올바르게 업그레이드하려면 해당 문자열을 포함해야 합니다.Red Hat OpenShift의 미러 레지스트리를 1.3 → 2.y로 업그레이드하고 사용자 정의 SQLite 스토리지 경로를 지정하려면 다음과 같이
--sqliteStorage
플래그를 전달해야 합니다../mirror-registry upgrade -v --targetHostname <remote_host_url> --targetUsername <user_name> -k ~/.ssh/my_ssh_key --sqliteStorage <example_directory_name>/quay-storage
$ ./mirror-registry upgrade -v --targetHostname <remote_host_url> --targetUsername <user_name> -k ~/.ssh/my_ssh_key --sqliteStorage <example_directory_name>/quay-storage
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 Red Hat OpenShift의 미러 레지스트리가 업데이트되었는지 확인하세요.
podman ps
$ podman ps
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
registry.redhat.io/quay/quay-rhel8:v3.12.10
registry.redhat.io/quay/quay-rhel8:v3.12.10
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2.7. Red Hat OpenShift SSL/TLS 인증서용 미러 레지스트리 교체 링크 복사링크가 클립보드에 복사되었습니다!
어떤 경우에는 Red Hat OpenShift의 미러 레지스트리 에 대한 SSL/TLS 인증서를 업데이트해야 할 수도 있습니다. 이 기능은 다음과 같은 시나리오에서 유용합니다.
- Red Hat OpenShift 인증서의 현재 미러 레지스트리를 교체하는 경우.
- Red Hat OpenShift 설치를 위해 이전 미러 레지스트리 와 동일한 인증서를 사용하는 경우.
- Red Hat OpenShift 인증서에 대한 미러 레지스트리를 주기적으로 업데이트하는 경우.
Red Hat OpenShift SSL/TLS 인증서의 미러 레지스트리를 교체하려면 다음 절차를 따르세요.
사전 요구 사항
-
OpenShift 콘솔 다운로드 페이지에서
./mirror-registry
바이너리를 다운로드하여 설치했습니다.
프로세스
Red Hat OpenShift용 미러 레지스트리를 설치하려면 다음 명령을 입력하세요.
./mirror-registry install \ --quayHostname <host_example_com> \ --quayRoot <example_directory_name>
$ ./mirror-registry install \ --quayHostname <host_example_com> \ --quayRoot <example_directory_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이렇게 하면 Red Hat OpenShift의 미러 레지스트리가
$HOME/quay-install
디렉토리에 설치됩니다.-
새 CA(인증 기관) 번들을 준비하고 새
ssl.key
및ssl.crt
키 파일을 생성합니다. 자세한 내용은 Red Hat Quay에 대한 SSL 및 TLS 구성을 참조하세요. 다음 명령을 입력하여
/$HOME/quay-install에
QUAY
와 같은 환경 변수를 할당합니다.export QUAY=/$HOME/quay-install
$ export QUAY=/$HOME/quay-install
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 입력하여 새
ssl.crt
파일을/$HOME/quay-install
디렉터리에 복사합니다.cp ~/ssl.crt $QUAY/quay-config
$ cp ~/ssl.crt $QUAY/quay-config
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 입력하여 새
ssl.key
파일을/$HOME/quay-install
디렉토리에 복사합니다.cp ~/ssl.key $QUAY/quay-config
$ cp ~/ssl.key $QUAY/quay-config
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 입력하여
quay-app
애플리케이션 포드를 다시 시작합니다.systemctl --user restart quay-app
$ systemctl --user restart quay-app
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2.8. Red Hat OpenShift의 미러 레지스트리 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
로컬 호스트에서 Red Hat OpenShift의 미러 레지스트리를 제거하려면 다음 절차를 따르세요.
사전 요구 사항
- 로컬 호스트에 Red Hat OpenShift용 미러 레지스트리를 설치했습니다.
프로세스
다음 명령을 실행하여 로컬 호스트에서 Red Hat OpenShift의 미러 레지스트리를 제거하세요.
./mirror-registry uninstall -v \ --quayRoot <example_directory_name>
$ ./mirror-registry uninstall -v \ --quayRoot <example_directory_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고-
Red Hat OpenShift의 미러 레지스트리를 삭제하면 삭제하기 전에 사용자에게 알림이 표시됩니다.
--autoApprove
를 사용하여 이 프롬프트를 건너뛸 수 있습니다. -
--quayRoot
플래그와 함께 Red Hat OpenShift용 미러 레지스트리를 설치하는 사용자는 제거 시--quayRoot
플래그를 포함해야 합니다. 예를 들어,--quayRoot example_directory_name 을
사용하여 Red Hat OpenShift용 미러 레지스트리를 설치한 경우 미러 레지스트리를 올바르게 제거하려면 해당 문자열을 포함해야 합니다.
-
Red Hat OpenShift의 미러 레지스트리를 삭제하면 삭제하기 전에 사용자에게 알림이 표시됩니다.
3.2.9. Red Hat OpenShift 플래그의 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
다음은 Red Hat OpenShift의 미러 레지스트리 에 사용할 수 있는 플래그입니다.
플래그 | 설명 |
---|---|
|
대화형 프롬프트를 비활성화하는 부울 값입니다. |
| Quay 설치 중에 생성된 init 사용자의 암호입니다. 8자 이상이어야 하며 공백을 포함하지 않아야 합니다. |
|
초기 사용자의 사용자 이름을 표시합니다. 지정되지 않은 경우 기본값은 |
| 사용자가 색상 시퀀스를 비활성화하고 설치, 제거 및 업그레이드 명령을 실행할 때 해당 내용을 Ansible에 전파할 수 있습니다. |
|
클라이언트가 레지스트리에 연결하는 데 사용할 미러 레지스트리의 정규화된 도메인 이름입니다. Quay |
|
Quay 영구 저장소 데이터가 저장되는 폴더입니다. |
|
|
|
SQLite 데이터베이스 데이터가 저장되는 폴더입니다. 지정하지 않으면 Podman 볼륨이 |
|
SSH ID 키의 경로입니다. 지정되지 않은 경우 기본값은 |
|
SSL/TLS 공개 키 / 인증서의 경로입니다. 기본값은 |
|
|
|
HTTPS 통신에 사용되는 SSL/TLS 개인 키의 경로입니다. 기본값은 |
|
Quay를 설치할 대상의 호스트 이름입니다. 지정되지 않은 경우 기본값은 |
|
SSH에 사용할 대상 호스트의 사용자입니다. 기본값은 |
| 디버그 로그와 Ansible Playbook 출력을 보여줍니다. |
| Red Hat OpenShift의 미러 레지스트리 버전을 보여줍니다. |
-
시스템의 공용 DNS 이름이 로컬 호스트 이름과 다른 경우
--quayHostname
을 수정해야 합니다. 또한--quayHostname
플래그는 IP 주소와 함께 설치를 지원하지 않습니다. 호스트 이름으로 설치해야 합니다. -
--sslCheckSkip
은 미러 레지스트리가 프록시 뒤에 설정되고 노출된 호스트 이름이 내부 Quay 호스트 이름과 다른 경우 사용됩니다. 설치하는 동안 제공된 Quay 호스트 이름에 대해 인증서의 유효성을 검사하는 것을 원하지 않을 때 사용할 수도 있습니다.
3.2.10. Red Hat OpenShift 릴리스 노트용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift용 미러 레지스트리는 연결이 끊긴 설치 환경에서 OpenShift Container Platform의 필수 컨테이너 이미지를 미러링하기 위한 대상으로 사용할 수 있는 작고 간소화된 컨테이너 레지스트리입니다.
이 릴리스 노트는 OpenShift Container Platform의 Red Hat OpenShift용 미러 레지스트리 개발 과정을 추적합니다.
3.2.10.1. Red Hat OpenShift 2.0 릴리스 노트에 대한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
다음 섹션에서는 Red Hat OpenShift용 미러 레지스트리의 각 2.0 릴리스에 대한 세부 정보를 제공합니다.
3.2.10.1.1. Red Hat OpenShift 2.0.7용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
발행일: 2025년 7월 14일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.10에서 사용 가능합니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.2. Red Hat OpenShift 2.0.6용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2025년 4월 28일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.8에서 사용 가능합니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.3. Red Hat OpenShift 2.0.5용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2025년 1월 13일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.5와 함께 제공됩니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.4. Red Hat OpenShift 2.0.4용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2025년 1월 06일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.4와 함께 제공됩니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.5. Red Hat OpenShift 2.0.3용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2024년 11월 25일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.3에서 사용 가능합니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.6. Red Hat OpenShift 2.0.2용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2024년 10월 31일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.2와 함께 제공됩니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.7. Red Hat OpenShift 2.0.1용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2024년 9월 26일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.1과 함께 제공됩니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
3.2.10.1.8. Red Hat OpenShift 2.0.0용 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
출시 날짜: 2024년 9월 3일
Red Hat OpenShift용 미러 레지스트리가 이제 Red Hat Quay 3.12.0에서 사용 가능합니다.
다음은 Red Hat OpenShift의 미러 레지스트리 에 대한 권고 사항입니다.
Red Hat OpenShift 2.0.0용 미러 레지스트리에는 다음과 같은 새로운 기능이 제공됩니다.
Red Hat OpenShift용 미러 레지스트리가 출시되면서 내부 데이터베이스가 PostgreSQL에서 SQLite로 업그레이드되었습니다. 결과적으로, 데이터는 기본적으로
sqlite-storage
Podman 볼륨에 저장되고, 전체 tarball 크기는 300MB 줄었습니다.새로 설치하면 기본적으로 SQLite가 사용됩니다. 버전 2.0으로 업그레이드하기 전에 환경에 따라 "로컬 호스트에서 Red Hat OpenShift용 미러 레지스트리 업데이트" 또는 "원격 호스트에서 Red Hat OpenShift용 미러 레지스트리 업데이트"를 참조하세요.
-
새로운 기능 플래그
--sqliteStorage가
추가되었습니다. 이 플래그를 사용하면 SQLite 데이터베이스 데이터가 저장되는 위치를 수동으로 설정할 수 있습니다. -
Red Hat OpenShift용 미러 레지스트리는 이제 IBM Power 및 IBM Z 아키텍처(
s390x
및ppc64le
)에서 사용할 수 있습니다.
3.2.10.2. Red Hat OpenShift 1.3 릴리스 노트에 대한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift 1.3 릴리스 노트의 미러 레지스트리 를 보려면 Red Hat OpenShift 1.3 릴리스 노트의 미러 레지스트리를 참조하세요.
3.2.10.3. Red Hat OpenShift 1.2 릴리스 노트에 대한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift 1.2 릴리스 노트의 미러 레지스트리 를 보려면 Red Hat OpenShift 1.2 릴리스 노트의 미러 레지스트리를 참조하세요.
3.2.10.4. Red Hat OpenShift 1.1 릴리스 노트에 대한 미러 레지스트리 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift 1.1 릴리스 노트의 미러 레지스트리 를 보려면 Red Hat OpenShift 1.1 릴리스 노트의 미러 레지스트리를 참조하세요.
3.2.11. Red Hat OpenShift의 미러 레지스트리 문제 해결 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift의 미러 레지스트리 문제를 해결하는 데 도움이 되도록 미러 레지스트리에서 설치한 systemd 서비스의 로그를 수집할 수 있습니다. 다음 서비스가 설치되었습니다.
- quay-app.service
- quay-redis.service
- quay-pod.service
사전 요구 사항
- Red Hat OpenShift에 대한 미러 레지스트리를 설치했습니다.
프로세스
루트 권한으로 Red Hat OpenShift용 미러 레지스트리를 설치한 경우 다음 명령을 입력하여 systemd 서비스의 상태 정보를 얻을 수 있습니다.
sudo systemctl status <service>
$ sudo systemctl status <service>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 표준 사용자로 Red Hat OpenShift용 미러 레지스트리를 설치한 경우 다음 명령을 입력하여 systemd 서비스의 상태 정보를 얻을 수 있습니다.
systemctl --user status <service>
$ systemctl --user status <service>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2.12. 추가 리소스 링크 복사링크가 클립보드에 복사되었습니다!
3.3. oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치에 대한 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
개인 레지스트리에 있는 OpenShift Container Platform 컨테이너 이미지의 미러링된 세트에서 클러스터를 설치하는 경우 연결이 끊긴 환경에서 클러스터를 실행할 수 있습니다. 클러스터가 실행될 때마다 이 레지스트리가 실행되어야 합니다.
oc-mirror 플러그인 v2를 사용하여 완전히 또는 부분적으로 연결이 끊긴 환경의 미러 레지스트리에 이미지를 미러링할 수 있습니다. 공식 Red Hat 레지스트리에서 필요한 이미지를 다운로드하려면 인터넷 연결이 있는 시스템에서 oc-mirror 플러그인 v2를 실행해야 합니다.
3.3.1. oc-mirror 플러그인 v2 정보 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror OpenShift CLI(oc
) 플러그인은 필요한 모든 OpenShift Container Platform 콘텐츠 및 기타 이미지를 미러 레지스트리에 미러링하는 단일 툴입니다.
새 버전의 oc-mirror를 사용하려면 oc-mirror 플러그인 v2 명령줄에 --v2
플래그를 추가합니다.
oc-mirror 플러그인 v2에는 다음과 같은 기능이 있습니다.
- OpenShift Container Platform 릴리스, Operator, helm 차트 및 기타 이미지를 미러링하는 중앙 집중식 방법을 제공합니다.
- 이미지 세트 구성 파일에 지정된 전체 이미지 세트가 이전에 미러링되었는지 여부에 관계없이 미러링된 레지스트리에 미러링되었는지 확인합니다.
- 프로세스 단일 단계에서 오류가 발생하는 경우 미러링 프로세스를 시작할 필요가 없도록 메타데이터 대신 캐시 시스템을 사용합니다.
- 새 이미지만 아카이브에 통합하여 최소한의 아카이브 크기를 유지합니다.
- 미러링 날짜별로 선택한 콘텐츠로 미러링 아카이브를 생성합니다.
-
v1을 사용한 각 미러링 작업에 대한 이미지 세트만 적용되는
ImageContentSourcePolicy
(ICSP) 리소스 대신 전체 이미지 세트를 포함하는ImageDigestMirrorSet
(IDMS) 및ImageTagMirrorSet
(ITMS) 리소스를 생성할 수 있습니다. -
자동 정리를 수행하지 않습니다. v2에서는 이제
Delete
기능을 사용하여 사용자에게 이미지 삭제를 보다 효과적으로 제어할 수 있습니다. -
registries.conf
파일을 지원합니다. 이 변경으로 동일한 캐시를 사용하는 동안 여러 개의 enclaves로 미러링할 수 있습니다.
3.3.1.1. 고급 워크플로 링크 복사링크가 클립보드에 복사되었습니다!
다음 단계에서는 oc-mirror 플러그인을 사용하여 이미지를 미러 레지스트리에 미러링하는 방법에 대한 고급 워크플로를 간략하게 설명합니다.
- 이미지 세트 구성 파일을 생성합니다.
다음 워크플로우 중 하나를 사용하여 대상 미러 레지스트리에 설정된 이미지를 미러링합니다.
- 대상 미러 레지스트리(mirror to mirror)에 직접 설정된 이미지를 미러링합니다.
-
이미지 세트를 디스크로 미러링하고,
tar
파일을 대상 환경으로 전송한 다음, 대상 미러 레지스트리로 설정된 이미지를 미러링합니다(디스크를 미러링할 디스크).
- oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터를 구성합니다.
- 필요에 따라 대상 미러 레지스트리를 업데이트하려면 다음 단계를 반복합니다.
3.3.1.2. oc-mirror 플러그인 v2 호환성 및 지원 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2는 OpenShift Container Platform에서 지원됩니다.
aarch64
,ppc64le
및 s390x
아키텍처에서 oc-mirror 플러그인 v2는 OpenShift Container Platform 4.14 이상에서만 지원됩니다.
미러링해야 하는 OpenShift Container Platform 버전에 관계없이 사용 가능한 최신 oc-mirror 플러그인 v2 버전을 사용합니다.
3.3.2. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Quay와 같이 OpenShift Container Platform 클러스터를 호스팅할 위치에 Docker v2-2 를 지원하는 컨테이너 이미지 레지스트리가 있어야 합니다.
참고- Red Hat Quay를 사용하는 경우 oc-mirror 플러그인과 함께 버전 3.6 이상을 사용하십시오. OpenShift Container Platform (Red Hat Quay 문서)에 Red Hat Quay Operator 배포를 참조하십시오. 레지스트리를 선택 및 설치하는 데 추가 지원이 필요한 경우 영업 담당자 또는 Red Hat 지원팀에 문의하십시오.
- 컨테이너 이미지 레지스트리에 대한 기존 솔루션이 없는 경우 OpenShift Container Platform 구독자에게 Red Hat OpenShift의 미러 레지스트리가 제공됩니다. 이 미러 레지스트리는 서브스크립션에 포함되어 있으며 소규모 컨테이너 레지스트리 역할을 합니다. 이 레지스트리를 사용하여 연결이 끊긴 설치에 필요한 OpenShift Container Platform 컨테이너 이미지를 미러링할 수 있습니다.
- 프로비저닝된 클러스터의 모든 시스템은 미러 레지스트리에 액세스할 수 있어야 합니다. 레지스트리에 연결할 수 없는 경우 설치, 업데이트 또는 워크로드 재배치와 같은 일상적인 작업과 같은 작업이 실패할 수 있습니다. 미러 레지스트리는 고가용성 방식으로 작동하여 OpenShift Container Platform 클러스터의 프로덕션 가용성과 일치하도록 해야 합니다.
3.3.3. 미러 호스트 준비 링크 복사링크가 클립보드에 복사되었습니다!
이미지 미러링에 oc-mirror 플러그인 v2를 사용하려면 플러그인을 설치하고 컨테이너 이미지에 대한 인증 정보가 있는 파일을 생성하여 Red Hat에서 미러로 미러링할 수 있어야 합니다.
3.3.3.1. oc-mirror OpenShift CLI 플러그인 설치 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror OpenShift CLI 플러그인을 설치하여 연결이 끊긴 환경에서 이미지 세트를 관리합니다.
사전 요구 사항
OpenShift CLI(
oc
)가 설치되어 있습니다. 완전히 연결이 끊긴 환경에서 이미지 세트를 미러링하는 경우 다음을 확인하십시오.- 인터넷 접속이 가능한 호스트에 oc-mirror 플러그인을 설치했습니다.
- 연결이 끊긴 환경의 호스트는 대상 미러 레지스트리에 액세스할 수 있습니다.
-
oc-mirror를 사용하는 운영 체제에서
umask
매개변수를0022
로 설정했습니다. - 사용 중인 RHEL 버전에 맞는 올바른 바이너리를 설치했습니다.
프로세스
oc-mirror CLI 플러그인을 다운로드하세요:
- Red Hat Hybrid Cloud Console의 다운로드 페이지로 이동합니다.
- OpenShift 연결 설치 툴 섹션의 드롭다운 메뉴에서 OpenShift Client(oc) 미러 플러그인 의 OS 유형 및 아키텍처 유형을 선택합니다.
- 다운로드를 클릭하여 파일을 저장하세요.
다음 명령을 실행하여 아카이브를 추출합니다.
tar xvzf oc-mirror.tar.gz
$ tar xvzf oc-mirror.tar.gz
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 필요한 경우 다음 명령을 실행하여 플러그인 파일을 실행 가능하도록 업데이트합니다.
chmod +x oc-mirror
$ chmod +x oc-mirror
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고oc-mirror
파일의 이름을 바꾸지 마십시오.다음 명령을 실행하여
PATH
(예:/usr/local/bin
)에 파일을 넣어 oc-mirror CLI 플러그인을 설치합니다.sudo mv oc-mirror /usr/local/bin/.
$ sudo mv oc-mirror /usr/local/bin/.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 oc-mirror 플러그인 v2가 성공적으로 설치되었는지 확인하세요.
oc mirror --v2 --help
$ oc mirror --v2 --help
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3.3.2. 이미지를 미러링할 수 있는 인증 정보 설정 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat에서 미러로 이미지를 미러링할 수 있는 컨테이너 이미지 레지스트리 자격 증명 파일을 만듭니다.
클러스터를 설치할 때 이 이미지 레지스트리 인증 정보 파일을 풀 시크릿(pull secret)으로 사용하지 마십시오. 클러스터를 설치할 때 이 파일을 지정하면 클러스터의 모든 시스템에 미러 레지스트리에 대한 쓰기 권한이 부여됩니다.
사전 요구 사항
- 연결이 끊긴 환경에서 사용할 미러 레지스트리를 구성했습니다.
- 미러 레지스트리에서 이미지를 미러링할 이미지 저장소 위치를 확인했습니다.
- 이미지를 해당 이미지 저장소에 업로드할 수 있는 미러 레지스트리 계정을 제공하고 있습니다.
- 미러 레지스트리에 대한 쓰기 권한이 있습니다.
프로세스
설치 호스트에서 다음 단계를 수행합니다.
-
Red Hat OpenShift Cluster Manager에서
registry.redhat.io
풀 시크릿을 다운로드합니다. 다음 명령을 실행하여 JSON 형식으로 풀 시크릿의 사본을 만듭니다.
cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
$ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 풀 시크릿을 저장할 폴더의 경로와 생성한 JSON 파일의 이름을 지정합니다.
pull secret의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow $XDG_RUNTIME_DIR/containers
디렉토리가 없으면 다음 명령을 입력하여 디렉토리를 만듭니다.mkdir -p $XDG_RUNTIME_DIR/containers
$ mkdir -p $XDG_RUNTIME_DIR/containers
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
풀 시크릿 파일을
$XDG_RUNTIME_DIR/containers/auth.json
으로 저장합니다. 다음 명령을 실행하여 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름과 비밀번호 또는 토큰을 생성합니다.
echo -n '<user_name>:<password>' | base64 -w0
$ echo -n '<user_name>:<password>' | base64 -w0
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
<user_name>
및<password>
의 경우 레지스트리에 설정한 사용자 이름 및 암호를 지정합니다.
출력 예
BGVtbYk3ZHAtqXs=
BGVtbYk3ZHAtqXs=
Copy to Clipboard Copied! Toggle word wrap Toggle overflow JSON 파일을 편집하고 레지스트리를 설명하는 섹션을 추가합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 수정된 풀 시크릿 예시
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3.4. 미러 레지스트리로 이미지 세트 미러링 링크 복사링크가 클립보드에 복사되었습니다!
이미지 세트를 미러 레지스트리로 미러링하면 필요한 이미지를 안전하고 통제된 환경에서 사용할 수 있으므로 배포, 업데이트 및 유지 관리 작업이 더욱 원활해집니다.
3.3.4.1. 이미지 세트 구성 생성 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하여 이미지를 미러링하려면 먼저 이미지 세트 구성 파일을 만들어야 합니다. 이 이미지 세트 구성 파일은 oc-mirror 플러그인 v2에 대한 기타 구성 설정과 함께 미러링할 OpenShift Container Platform 릴리스, 운영자 및 기타 이미지를 정의합니다.
사전 요구 사항
- 컨테이너 이미지 레지스트리 인증 정보 파일이 생성되어 있습니다. 자세한 내용은 이미지 미러링을 허용하는 자격 증명 구성을 참조하세요.
프로세스
ImageSetConfiguration
YAML 파일을 만들고 필요한 이미지를 포함하도록 수정합니다.ImageSetConfiguration
YAML 파일 예시Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- OpenShift Container Platform 이미지를 검색할 채널을 설정합니다.
- 2
그래프 추가: 그래프 데이터 이미지를 빌드하고 미러 레지스트리에 푸시하려면 true를
설정합니다. 그래프 데이터 이미지는 OpenShift Update Service(OSUS)를 생성하는 데 필요합니다.그래프: true
필드는UpdateService
사용자 정의 리소스 매니페스트도 생성합니다.oc
명령줄 인터페이스(CLI)는UpdateService
사용자 정의 리소스 매니페스트를 사용하여 OSUS를 생성할 수 있습니다. 자세한 내용은 OpenShift 업데이트 서비스 정보를 참조하십시오.- 3
- Operator 카탈로그를 설정하여 OpenShift Container Platform 이미지를 검색합니다.
- 4
- 이미지 세트에 포함할 특정 Operator 패키지만 지정합니다. 이 필드를 제거하여 카탈로그의 모든 패키지를 검색합니다.
- 5
- 이미지 세트에 포함할 추가 이미지를 지정합니다.
3.3.4.2. 부분적으로 연결이 끊긴 환경에서 이미지 세트 미러링 링크 복사링크가 클립보드에 복사되었습니다!
인터넷 접속이 제한된 환경에서는 oc-mirror 플러그인 v2를 사용하여 이미지 세트를 레지스트리에 미러링할 수 있습니다.
사전 요구 사항
- oc-mirror 플러그인 v2를 실행 중인 환경에서는 인터넷과 미러 레지스트리에 액세스할 수 있습니다.
프로세스
다음 명령을 실행하여 지정된 이미지 세트 구성의 이미지를 지정된 레지스트리로 미러링합니다.
oc mirror -c <image_set_configuration> --workspace file://<file_path> docker://<mirror_registry_url> --v2
$ oc mirror -c <image_set_configuration> --workspace file://<file_path> docker://<mirror_registry_url> --v2
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
- <image_set_configuration>
- 이미지 세트 구성 파일의 이름을 지정합니다.
- <file_path>
- 클러스터 리소스가 생성될 디렉토리를 지정합니다.
- <mirror_registry_url>
- 이미지가 저장되어 있고 삭제해야 하는 미러 레지스트리의 URL 또는 주소를 지정합니다.
검증
-
<file_path>
디렉터리에 생성된working-dir/cluster-resources
디렉터리로 이동합니다. -
ImageDigestMirrorSet
,ImageTagMirrorSet
및CatalogSource
리소스에 대한 YAML 파일이 있는지 확인합니다.
다음 단계
- oc-mirror 플러그인 v2에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
3.3.4.3. 완전히 연결이 끊긴 환경에서 이미지 세트 미러링 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터가 공용 인터넷에 액세스할 수 없는 완전히 분리된 환경에서 이미지 세트를 미러링할 수 있습니다. 다음은 미러링 프로세스를 설명하는 고급 워크플로입니다.
- 디스크로 미러링 : 이미지 세트를 아카이브로 미러링합니다.
- 디스크 전송 : 연결이 끊긴 미러 레지스트리의 네트워크로 아카이브를 수동으로 전송합니다.
- 디스크에서 미러링 : 아카이브에서 대상의 연결이 끊긴 레지스트리로 이미지 세트를 미러링합니다.
3.3.4.3.1. 미러에서 디스크로 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하면 이미지 세트를 생성하고 내용을 디스크에 저장할 수 있습니다. 그 후, 생성된 이미지 세트를 연결이 끊긴 환경으로 전송하고 대상 레지스트리로 미러링할 수 있습니다.
oc-mirror 플러그인 v2는 이미지 세트 구성 파일에 지정된 소스에서 컨테이너 이미지를 검색하여 로컬 디렉토리의 tar 아카이브에 압축합니다.
프로세스
다음 명령을 실행하여 지정된 이미지 세트 구성의 이미지를 디스크로 미러링합니다.
oc mirror -c <image_set_configuration> file://<file_path> --v2
$ oc mirror -c <image_set_configuration> file://<file_path> --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
- <image_set_configuration>
- 이미지 세트 구성 파일의 이름을 지정합니다.
- <file_path>
- 이미지 세트가 포함된 아카이브가 생성될 디렉토리를 지정합니다.
검증
-
생성된
<file_path>
디렉터리로 이동합니다. - 보관 파일이 생성되었는지 확인하세요.
다음 단계
- 디스크에서 미러로 미러링
3.3.4.3.2. 디스크에서 미러로 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하면 디스크에서 대상 미러 레지스트리로 이미지 세트를 미러링할 수 있습니다.
oc-mirror 플러그인 v2는 로컬 디스크에서 컨테이너 이미지를 검색하여 지정된 미러 레지스트리로 전송합니다.
프로세스
- 미러링된 이미지 세트가 들어 있는 디스크를 대상 미러 레지스트리가 있는 환경으로 전송합니다.
다음 명령을 실행하여 디스크에 있는 이미지 세트 파일을 처리하고 내용을 대상 미러 레지스트리로 미러링합니다.
oc mirror -c <image_set_configuration> --from file://<file_path> docker://<mirror_registry_url> --v2
$ oc mirror -c <image_set_configuration> --from file://<file_path> docker://<mirror_registry_url> --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
- <image_set_configuration>
- 이미지 세트 구성 파일의 이름을 지정합니다.
- <file_path>
- 아카이브가 들어 있는 디스크의 디렉토리를 지정합니다. 이 폴더에는 클러스터에 적용하기 위해 생성된 클러스터 리소스(예: ImageDigestMirrorSet(IDMS) 또는 ImageTagMirrorSet(ITMS) 리소스)도 포함됩니다.
- <mirror_registry_url>
- 이미지가 저장된 미러 레지스트리의 URL 또는 주소를 지정합니다.
검증
-
<file_path>
디렉터리에 생성된working-dir
디렉터리 내에서cluster-resources
디렉터리로 이동합니다. -
ImageDigestMirrorSet
,ImageTagMirrorSet
및CatalogSource
리소스에 대한 YAML 파일이 있는지 확인합니다.
다음 단계
- oc-mirror 플러그인 v2에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
3.3.5. oc-mirror 플러그인 v2에서 생성된 사용자 정의 리소스에 관하여 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2는 다음 사용자 정의 리소스를 자동으로 생성합니다.
ImageDigestMirrorSet
(IDMS)- 이미지 다이제스트 풀 사양을 사용할 때 레지스트리 미러 규칙을 처리합니다. 다이제스트에 의해 이미지 세트의 이미지 중 하나 이상이 미러링되는 경우 생성됩니다.
ImageTagMirrorSet
(ITMS)- 이미지 태그 풀 사양을 사용할 때 레지스트리 미러 규칙을 처리합니다. 이미지 세트에서 하나 이상의 이미지가 태그로 미러링되는 경우 생성됩니다.
CatalogSource
- 미러 레지스트리에서 사용 가능한 운영자에 대한 정보를 검색합니다. Operator Lifecycle Manager(OLM) Classic에서 사용됩니다.
ClusterCatalog
- 미러 레지스트리에서 사용 가능한 클러스터 확장(운영자 포함)에 대한 정보를 검색합니다. OLM v1에서 사용됨.
UpdateService
- 연결이 끊긴 환경에 업데이트된 그래프 데이터를 제공합니다. OpenShift 업데이트 서비스에서 사용됩니다.
3.3.5.1. oc-mirror 플러그인에서 생성된 리소스 수정에 대한 제한 사항 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2에서 생성된 리소스를 사용하여 클러스터를 구성하는 경우 특정 필드를 변경해서는 안 됩니다. 이러한 필드를 수정하면 오류가 발생할 수 있으며 지원되지 않습니다.
다음 표에는 변경되지 않아야 하는 리소스와 해당 필드가 나열되어 있습니다.
리소스 | 변경하면 안되는 필드 |
---|---|
|
|
|
|
|
|
|
|
서명 |
|
|
|
이러한 리소스에 대한 자세한 내용은 CatalogSource
, ImageDigestMirrorSet
, ImageTagMirrorSet
에 대한 OpenShift API 문서를 참조하세요.
3.3.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-resources
Copy 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.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요클러스터 대신 Operator를 미러링하는 경우 이전 명령을 실행하지 마십시오. 명령을 실행하면 적용할 릴리스 이미지 서명이 없기 때문에 오류가 발생합니다.
또한 YAML 파일은 동일한 디렉터리
working-dir/cluster-resources/
에서 사용할 수 있습니다. JSON 또는 YAML 형식을 사용할 수 있습니다.
검증
다음 명령을 실행하여
ImageDigestMirrorSet
리소스가 성공적으로 설치되었는지 확인하세요.oc get imagedigestmirrorset
$ oc get imagedigestmirrorset
Copy 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 imagetagmirrorset
Copy 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-marketplace
Copy 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 clustercatalog
Copy 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에서 생성된 리소스를 사용하도록 클러스터를 구성한 후, 미러링된 이미지를 사용하여 수행할 수 있는 작업에 대한 자세한 내용은 다음 단계를 참조하세요.
3.3.6. 연결이 끊긴 환경에서 이미지 삭제 링크 복사링크가 클립보드에 복사되었습니다!
이전에 oc-mirror 플러그인 v2를 사용하여 이미지를 배포한 적이 있는 경우 이러한 이미지를 삭제하여 미러 레지스트리의 공간을 확보할 수 있습니다. oc-mirror 플러그인 v2는 ImageSetConfiguration
파일에 포함되지 않은 이미지를 자동으로 정리하지 않습니다. 이렇게 하면 ImageSetConfig.yaml
파일을 변경할 때 필요하거나 배포된 이미지가 실수로 삭제되는 것을 방지할 수 있습니다.
어떤 이미지를 삭제할지 지정하려면 DeleteImageSetConfiguration
파일을 만들어야 합니다.
다음 예에서 DeleteImageSetConfiguration
파일은 다음 이미지를 제거합니다.
- OpenShift Container Platform 4.13.3의 모든 릴리스 이미지입니다.
-
aws-load-balancer-operator
v0.0.1 번들과 모든 관련 이미지. -
ubi
및ubi-minimal에
대한 추가 이미지는 해당 다이제스트에서 참조됩니다.
DeleteImageSetConfiguration
파일 예제
삭제 문제를 줄이려면 미러-디스크 및 디스크-미러 워크플로를 사용하는 것을 고려하세요.
oc-mirror 플러그인 v2는 이미지의 매니페스트만 삭제하므로 레지스트리에서 차지하는 저장 공간은 줄어들지 않습니다.
삭제된 매니페스트 등 불필요한 이미지에서 저장 공간을 확보하려면 컨테이너 레지스트리에서 가비지 수집기를 활성화해야 합니다. 가비지 수집기를 활성화하면 레지스트리는 더 이상 매니페스트에 대한 참조가 없는 이미지 블롭을 삭제하여 삭제된 블롭이 차지했던 저장 공간을 줄입니다. 가비지 컬렉터를 활성화하는 프로세스는 컨테이너 레지스트리에 따라 다릅니다.
자세한 내용은 "배포 레지스트리에서 저장소 정리 문제 해결"을 참조하세요.
운영자 이미지를 삭제하는 동안 운영자 카탈로그 이미지 삭제를 건너뛰려면
DeleteImageSetConfiguration
파일의 운영자 카탈로그 이미지 아래에 특정 운영자를 나열해야 합니다. 이렇게 하면 카탈로그 이미지가 아닌 지정된 연산자만 삭제됩니다.운영자 카탈로그 이미지만 지정된 경우 해당 카탈로그 내의 모든 운영자와 카탈로그 이미지 자체가 삭제됩니다.
oc-mirror 플러그인 v2는 다른 Operator가 여전히 배포되어 있고 이러한 이미지에 의존할 수 있으므로 Operator 카탈로그 이미지를 자동으로 삭제하지 않습니다.
카탈로그의 운영자가 레지스트리나 클러스터에 더 이상 남아 있지 않다고 확신하는 경우
DeleteImageSetConfiguration
의additionalImages
에 카탈로그 이미지를 명시적으로 추가하여 제거할 수 있습니다.- 가비지 수집 동작은 레지스트리에 따라 달라집니다. 일부 레지스트리는 삭제된 이미지를 자동으로 제거하지 않으므로 시스템 관리자가 수동으로 가비지 수집을 실행하여 공간을 확보해야 합니다.
3.3.6.1. 배포 레지스트리에서 저장소 정리 문제 해결 링크 복사링크가 클립보드에 복사되었습니다!
배포 레지스트리의 알려진 문제로 인해 가비지 수집기가 예상대로 저장소를 확보하지 못합니다. Red Hat Quay를 사용하면 이 문제가 발생하지 않습니다.
프로세스
배포 레지스트리의 알려진 문제를 해결하기 위해 적절한 방법을 선택하세요.
컨테이너 레지스트리를 다시 시작하려면 다음 명령을 실행하세요.
podman restart <registry_container>
$ podman restart <registry_container>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 레지스트리 구성에서 캐싱을 비활성화하려면 다음 단계를 수행하세요.
Blobdescriptor
캐시를 비활성화하려면/etc/docker/registry/config.yml
파일을 수정하세요.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 변경 사항을 적용하려면 다음 명령을 실행하여 컨테이너 레지스트리를 다시 시작하세요.
podman restart <registry_container>
$ podman restart <registry_container>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3.6.2. 연결이 끊긴 환경에서 이미지 삭제 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 환경에서 이미지를 삭제하려면 다음 절차를 따르세요.
사전 요구 사항
- 더 이상 매니페스트를 참조하지 않는 이미지를 삭제하기 위해 환경에서 가비지 수집을 활성화했습니다.
프로세스
delete-image-set-config.yaml
파일을 만들고 다음 내용을 포함합니다.DeleteImageSetConfiguration
파일Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1 1
- 삭제할 OpenShift Container Platform 채널의 이름을 지정합니다(예:
stable-4.15)
. - 2 3
- 채널 내에서 삭제할 이미지의 버전 범위를 지정합니다(예: 최소 버전의 경우
4.15.0
, 최대 버전의 경우4.15.1
). 하나의 버전의 이미지만 삭제하려면minVersion
및maxVersion
필드 모두에 해당 버전 번호를 사용하세요. - 4
- 삭제할 운영자가 포함된 운영자 카탈로그 이미지를 지정합니다(예:
registry.redhat.io/redhat/redhat-operator-index:v4.14
). Operator 카탈로그 이미지는 삭제되지 않습니다. 클러스터에 남아 있는 다른 운영자에게도 레지스트리에 있는 것이 필요할 수 있습니다. - 5
- 삭제할 특정 운영자(예:
aws-load-balancer-operator )를
지정합니다. - 6 7
- 운영자에 대해 삭제할 이미지의 버전 범위를 지정합니다. 예를 들어, 최소 버전은
0.0.1
이고 최대 버전은0.0.2입니다
.
다음 명령을 실행하여
delete-images.yaml
파일을 만듭니다.oc mirror delete --config delete-image-set-config.yaml --workspace file://<previously_mirrored_work_folder> --v2 --generate docker://<remote_registry>
$ oc mirror delete --config delete-image-set-config.yaml --workspace file://<previously_mirrored_work_folder> --v2 --generate docker://<remote_registry>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
- <previously_mirrored_work_folder>
- 미러링 프로세스 중에 이미지가 이전에 미러링되거나 저장된 디렉토리를 지정합니다.
- <remote_registry>
이미지를 삭제할 원격 컨테이너 레지스트리의 URL이나 주소를 지정합니다.
중요이미지를 삭제할 때 올바른 작업 공간 디렉토리를 지정하세요. 새 클러스터를 설정하는 등 미러링을 처음부터 시작할 때만 캐시 디렉토리를 수정하거나 삭제하세요. 캐시 디렉토리를 잘못 변경하면 추가적인 미러링 작업이 중단될 수 있습니다.
-
생성된
<previously_mirrored_work_folder>/delete
디렉토리로 이동합니다. -
delete-images.yaml
파일이 생성되었는지 확인하세요. - 클러스터에 더 이상 필요하지 않은 파일 내의 각 이미지를 수동으로 확인하고 레지스트리에서 안전하게 제거하세요.
delete-images
YAML 파일을 생성한 후 다음 명령을 실행하여 원격 레지스트리에서 이미지를 삭제합니다.oc mirror delete --v2 --delete-yaml-file <previously_mirrored_work_folder>/working-dir/delete/delete-images.yaml docker://<remote_registry>
$ oc mirror delete --v2 --delete-yaml-file <previously_mirrored_work_folder>/working-dir/delete/delete-images.yaml docker://<remote_registry>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
- <previously_mirrored_work_folder>
- 미러링 프로세스 중에 이미지가 이전에 미러링되거나 저장된 디렉토리를 지정합니다.
- <remote_registry>
이미지를 삭제할 원격 컨테이너 레지스트리의 URL이나 주소를 지정합니다.
중요미러-투-미러 방식을 사용하여 이미지를 미러링하는 경우 이미지가 로컬에 캐시되지 않으므로 로컬 캐시에서 이미지를 삭제할 수 없습니다.
3.3.7. 미러링을 위해 선택한 이미지 확인 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하면 실제로 이미지를 미러링하지 않는 테스트 실행(드라이 런)을 수행할 수 있습니다. 이를 통해 미러링될 이미지 목록을 검토할 수 있습니다. 또한, 드라이런을 사용하여 이미지 세트 구성의 오류를 일찍 포착할 수도 있습니다. 디스크 미러링 워크플로우에서 드라이런을 실행할 때, oc-mirror 플러그인 v2는 이미지 세트 내의 모든 이미지가 캐시에 있는지 확인합니다. 누락된 이미지는 missing.txt
파일에 나열되어 있습니다. 미러링 전에 드라이런을 수행하면 missing.txt
파일과 mapping.txt
파일에 모두 동일한 이미지 목록이 포함됩니다.
3.3.7.1. oc-mirror 플러그인 v2의 예행 실행 수행 링크 복사링크가 클립보드에 복사되었습니다!
이미지를 미러링하지 않고 테스트 실행을 수행하여 이미지 세트 구성을 확인합니다. 이렇게 하면 설정이 올바른지 확인하고 의도치 않은 변경을 방지할 수 있습니다.
프로세스
테스트 실행을 수행하려면
oc mirror
명령을 실행하고 명령에--dry-run
인수를 추가하세요.oc mirror -c <image_set_config_yaml> file://<oc_mirror_workspace_path> --dry-run --v2
$ oc mirror -c <image_set_config_yaml> file://<oc_mirror_workspace_path> --dry-run --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
<image_set_config_yaml>
- 생성한 이미지 세트 구성 파일을 지정합니다.
<oc_mirror_workspace_path>
- 작업 공간 경로의 주소를 삽입합니다.
<mirror_registry_url>
이미지를 미러링하거나 삭제할 원격 컨테이너 레지스트리의 URL이나 주소를 삽입하세요.
출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
생성된 작업 공간 디렉토리로 이동합니다.
cd <oc_mirror_workspace_path>
$ cd <oc_mirror_workspace_path>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
생성된
mapping.txt
및missing.txt
파일을 검토합니다. 이러한 파일에는 미러링될 모든 이미지 목록이 포함되어 있습니다.
3.3.7.2. oc-mirror 플러그인 v2 오류 문제 해결 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2는 이제 모든 이미지 미러링 오류를 별도의 파일에 기록하여 오류를 추적하고 진단하기가 더 쉬워졌습니다.
릴리스 또는 릴리스 구성 요소 이미지를 미러링하는 동안 오류가 발생하면 이는 매우 중요합니다. 이렇게 하면 미러링 프로세스가 즉시 중지됩니다.
미러링 운영자, 운영자 관련 이미지 또는 추가 이미지에 오류가 발생해도 미러링 프로세스는 중단되지 않습니다. 미러링은 계속되고, oc-mirror 플러그인 v2는 어느 Operator가 미러링에 실패했는지 설명하는 파일을 working-dir/logs
디렉토리에 저장합니다.
이미지 미러링에 실패하고 해당 이미지가 하나 이상의 Operator 번들의 일부로 미러링되는 경우, oc-mirror 플러그인 v2는 어떤 Operator가 불완전한지 사용자에게 알려서 오류의 영향을 받는 Operator 번들에 대한 명확성을 제공합니다.
프로세스
서버 관련 문제를 확인하세요.
오류 예시
[ERROR] : [Worker] error mirroring image localhost:55000/openshift/graph-image:latest error: copying image 1/4 from manifest list: trying to reuse blob sha256:edab65b863aead24e3ed77cea194b6562143049a9307cd48f86b542db9eecb6e at destination: pinging container registry localhost:5000: Get "https://localhost:5000/v2/": http: server gave HTTP response to HTTPS client
[ERROR] : [Worker] error mirroring image localhost:55000/openshift/graph-image:latest error: copying image 1/4 from manifest list: trying to reuse blob sha256:edab65b863aead24e3ed77cea194b6562143049a9307cd48f86b542db9eecb6e at destination: pinging container registry localhost:5000: Get "https://localhost:5000/v2/": http: server gave HTTP response to HTTPS client
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
oc-mirror 플러그인 v2 출력 디렉토리에 있는
working-dir/logs
폴더에 있는mirroring_error_date_time.log
파일을 엽니다. -
HTTP 500
오류, 만료된 토큰 또는 시간 초과와 같이 일반적으로 서버 측 문제를 나타내는 오류 메시지를 찾아보세요. - 문제가 지속되면 미러링 프로세스를 다시 시도하거나 지원팀에 문의하세요.
-
oc-mirror 플러그인 v2 출력 디렉토리에 있는
운영자의 불완전한 미러링을 확인하세요.
오류 예시
error mirroring image docker://registry.redhat.io/3scale-amp2/zync-rhel9@sha256:8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d (Operator bundles: [3scale-operator.v0.11.12] - Operators: [3scale-operator]) error: initializing source docker://localhost:55000/3scale-amp2/zync-rhel9:8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d: reading manifest 8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d in localhost:55000/3scale-amp2/zync-rhel9: manifest unknown error mirroring image docker://registry.redhat.io/3scale-amp2/3scale-rhel7-operator-metadata@sha256:de0a70d1263a6a596d28bf376158056631afd0b6159865008a7263a8e9bf0c7d error: skipping operator bundle docker://registry.redhat.io/3scale-amp2/3scale-rhel7-operator-metadata@sha256:de0a70d1263a6a596d28bf376158056631afd0b6159865008a7263a8e9bf0c7d because one of its related images failed to mirror error mirroring image docker://registry.redhat.io/3scale-amp2/system-rhel7@sha256:fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e (Operator bundles: [3scale-operator.v0.11.12] - Operators: [3scale-operator]) error: initializing source docker://localhost:55000/3scale-amp2/system-rhel7:fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e: reading manifest fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e in localhost:55000/3scale-amp2/system-rhel7: manifest unknown
error mirroring image docker://registry.redhat.io/3scale-amp2/zync-rhel9@sha256:8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d (Operator bundles: [3scale-operator.v0.11.12] - Operators: [3scale-operator]) error: initializing source docker://localhost:55000/3scale-amp2/zync-rhel9:8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d: reading manifest 8bb6b31e108d67476cc62622f20ff8db34efae5d58014de9502336fcc479d86d in localhost:55000/3scale-amp2/zync-rhel9: manifest unknown error mirroring image docker://registry.redhat.io/3scale-amp2/3scale-rhel7-operator-metadata@sha256:de0a70d1263a6a596d28bf376158056631afd0b6159865008a7263a8e9bf0c7d error: skipping operator bundle docker://registry.redhat.io/3scale-amp2/3scale-rhel7-operator-metadata@sha256:de0a70d1263a6a596d28bf376158056631afd0b6159865008a7263a8e9bf0c7d because one of its related images failed to mirror error mirroring image docker://registry.redhat.io/3scale-amp2/system-rhel7@sha256:fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e (Operator bundles: [3scale-operator.v0.11.12] - Operators: [3scale-operator]) error: initializing source docker://localhost:55000/3scale-amp2/system-rhel7:fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e: reading manifest fe77272021867cc6b6d5d0c9bd06c99d4024ad53f1ab94ec0ab69d0fda74588e in localhost:55000/3scale-amp2/system-rhel7: manifest unknown
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 콘솔이나 로그 파일에서 어떤 연산자가 불완전한지 나타내는 경고를 확인하세요.
운영자가 불완전하다고 표시된 경우 해당 운영자와 관련된 이미지가 미러링되지 않았을 가능성이 높습니다.
- 누락된 이미지를 수동으로 미러링하거나 미러링 프로세스를 다시 시도하세요.
생성된 클러스터 리소스와 관련된 오류를 확인합니다. 일부 이미지가 미러링에 실패하더라도 oc-mirror v2는 성공적으로 미러링된 이미지에 대해
IDMS.yaml
및ITMS.yaml
파일과 같은 클러스터 리소스를 생성합니다.- 생성된 파일의 출력 디렉토리를 확인하세요.
- 특정 이미지에서 이러한 파일이 누락된 경우 미러링 프로세스 중에 해당 이미지에 심각한 오류가 발생하지 않았는지 확인하세요.
이러한 단계를 따르면 문제를 더 정확하게 진단하고 더 원활하게 미러링을 보장할 수 있습니다.
3.3.8. 인클레이브 지원의 이점 링크 복사링크가 클립보드에 복사되었습니다!
인클레이브 지원은 네트워크의 특정 부분에 대한 내부 액세스를 제한합니다. 방화벽 경계를 통해 인바운드 및 아웃바운드 트래픽 액세스를 허용하는 비무장지대(DMZ) 네트워크와 달리, 인클레이브는 방화벽 경계를 넘지 않습니다.
새로운 인클레이브 지원 기능은 최소한 하나의 중간 연결 해제 네트워크 뒤에 보안된 여러 인클레이브에 대한 미러링이 필요한 시나리오를 위한 것입니다.
Enclave 지원에는 다음과 같은 이점이 있습니다.
- 여러 개의 엔클레이브에 대한 콘텐츠를 미러링하고 이를 단일 내부 레지스트리에 중앙화할 수 있습니다. 일부 고객은 미러링된 콘텐츠에 대한 보안 검사를 실행하고 싶어하며, 이 설정을 사용하면 모든 검사를 한 번에 실행할 수 있습니다. 그런 다음 해당 콘텐츠는 다운스트림 엔클레이브에 미러링되기 전에 검토됩니다.
- 각 인클레이브에 대해 인터넷에서 미러링 프로세스를 다시 시작하지 않고도 중앙 집중식 내부 레지스트리에서 인클레이브로 직접 콘텐츠를 미러링할 수 있습니다.
- 네트워크 단계 간 데이터 전송을 최소화하여 블롭이나 이미지가 한 단계에서 다른 단계로 한 번만 전송되도록 할 수 있습니다.
3.3.8.1. Enclave 미러링 워크플로 링크 복사링크가 클립보드에 복사되었습니다!
이전 이미지는 인터넷 연결이 있는 환경과 없는 환경을 포함하여 다양한 환경에서 oc-mirror 플러그인을 사용하는 흐름을 간략하게 설명합니다.
인터넷 연결 환경 :
- 사용자는 oc-mirror 플러그인 v2를 실행하여 온라인 레지스트리의 콘텐츠를 로컬 디스크 디렉토리로 미러링합니다.
- 미러링된 콘텐츠는 오프라인 환경으로 전송할 수 있도록 디스크에 저장됩니다.
연결이 끊긴 기업 환경(인터넷 없음) :
흐름 1:
-
사용자는 oc-mirror 플러그인 v2를 실행하여 온라인 환경에서 전송된 디스크 디렉토리의 미러링된 콘텐츠를
enterprise-registry.in
레지스트리로 로드합니다.
-
사용자는 oc-mirror 플러그인 v2를 실행하여 온라인 환경에서 전송된 디스크 디렉토리의 미러링된 콘텐츠를
흐름 2:
-
registries.conf
파일을 업데이트한 후 사용자는 oc-mirror 플러그인 v2를 실행하여enterprise-registry.in
레지스트리의 콘텐츠를 인클레이브 환경으로 미러링합니다. - 내용은 인클레이브로 전송하기 위해 디스크 디렉토리에 저장됩니다.
-
인클레이브 환경(인터넷 없음) :
-
사용자는 oc-mirror 플러그인 v2를 실행하여 디스크 디렉토리의 콘텐츠를
enclave-registry.in
레지스트리로 로드합니다.
이 이미지는 이러한 환경 전반의 데이터 흐름을 시각적으로 표현하고 인터넷 연결 없이 연결이 끊긴 환경과 고립된 환경을 처리하기 위해 oc-mirror를 사용하는 것을 강조합니다.
3.3.8.2. 인클레이브로의 미러링 링크 복사링크가 클립보드에 복사되었습니다!
인클레이브로 미러링할 경우 먼저 하나 이상의 인클레이브에서 필요한 이미지를 엔터프라이즈 중앙 레지스트리로 전송해야 합니다.
중앙 레지스트리는 보안 네트워크, 구체적으로는 연결이 끊긴 환경에 위치하며, 공개 인터넷에 직접 연결되어 있지 않습니다. 하지만 사용자는 공개 인터넷에 액세스할 수 있는 환경에서 oc mirror를
실행해야 합니다.
프로세스
연결이 끊긴 환경에서 oc-mirror 플러그인 v2를 실행하기 전에
registries.conf
파일을 만드세요. 이 사양에서는 파일의 TOML 형식을 다음과 같이 설명합니다.참고$HOME/.config/containers/registries.conf
또는/etc/containers/registries.conf
에 파일을 저장하는 것이 좋습니다.예제
registries.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 미러 아카이브를 생성합니다.
<file_path>/enterprise-content
아래의 디스크에 있는 아카이브에 모든 OpenShift Container Platform 콘텐츠를 수집하려면 다음 명령을 실행하세요.oc mirror --v2 -c isc.yaml file://<file_path>/enterprise-content
$ oc mirror --v2 -c isc.yaml file://<file_path>/enterprise-content
Copy to Clipboard Copied! Toggle word wrap Toggle overflow isc.yaml의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 아카이브가 생성된 후 연결이 끊긴 환경으로 전송됩니다. 전송 메커니즘은 oc-mirror 플러그인 v2의 일부가 아닙니다. 기업 네트워크 관리자가 전송 전략을 결정합니다.
어떤 경우에는 디스크를 한 위치에서 물리적으로 분리하고 연결이 끊긴 환경의 다른 컴퓨터에 연결하는 방식으로 전송이 수동으로 수행됩니다. 다른 경우에는 SFTP(Secure File Transfer Protocol)나 다른 프로토콜이 사용됩니다.
아카이브 전송이 완료되면 oc-mirror 플러그인 v2를 다시 실행하여 관련 아카이브 내용을 레지스트리(예시에서는
entrerpise_registry.in
)에 미러링할 수 있습니다. 이는 다음 예에서 확인할 수 있습니다.oc mirror --v2 -c isc.yaml --from file://<disconnected_environment_file_path>/enterprise-content docker://<enterprise_registry.in>/
$ oc mirror --v2 -c isc.yaml --from file://<disconnected_environment_file_path>/enterprise-content docker://<enterprise_registry.in>/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
-
--from
은 아카이브가 들어 있는 폴더를 가리킵니다.file://
로 시작합니다. -
docker://
는 미러링의 목적지이며 마지막 인수입니다. 도커 레지스트리이기 때문이죠. -
-c
(--config
)는 필수 인수입니다. 이를 통해 oc-mirror 플러그인 v2가 아카이브의 하위 부분만 레지스트리에 미러링할 수 있습니다. 하나의 아카이브에는 여러 개의 OpenShift Container Platform 릴리스가 포함될 수 있지만, 연결이 끊긴 환경이나 인클레이브는 몇 개만 미러링할 수 있습니다.
-
인클레이브에 미러링할 콘텐츠를 설명하는
imageSetConfig
YAML 파일을 준비합니다.isc-enclave.yaml 예시
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 연결이 끊긴 레지스트리에 액세스할 수 있는 컴퓨터에서 oc-mirror 플러그인 v2를 실행해야 합니다. 이전 예에서 연결이 끊긴 환경인
enterprise-registry.in
에 액세스할 수 있습니다.그래프 URL 업데이트
graph:true를
사용하는 경우, oc-mirror 플러그인 v2는cincinnati
API 엔드포인트에 도달하려고 시도합니다. 이 환경은 연결이 끊어졌으므로 OpenShift 업데이트 서비스(OSUS)의 URL을 참조하도록 환경 변수UPDATE_URL_OVERRIDE를
내보내야 합니다.export UPDATE_URL_OVERRIDE=https://<osus.enterprise.in>/graph
$ export UPDATE_URL_OVERRIDE=https://<osus.enterprise.in>/graph
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift 클러스터에서 OSUS를 설정하는 방법에 대한 자세한 내용은 "OpenShift 업데이트 서비스를 사용하여 연결이 끊긴 환경에서 클러스터 업데이트"를 참조하세요.
참고OpenShift Container Platform Extended Update Support(EUS) 버전 간에 업데이트하는 경우 현재 버전과 대상 버전 사이의 중간 마이너 버전에 대한 이미지도 포함해야 합니다. oc-mirror 플러그인 v2는 항상 이 요구 사항을 자동으로 감지하지 못할 수 있으므로 Red Hat OpenShift Container Platform 업데이트 그래프 페이지에서 필요한 중간 버전을 확인하세요.
업데이트 그래프 페이지를 사용하여 애플리케이션에서 제안한 중간 마이너 버전을 찾은 다음, oc-mirror 플러그인 v2를 사용할 때 이러한 버전을
ImageSetConfiguration
파일에 포함하세요.엔클레이브에 대한 엔터프라이즈 레지스트리에서 미러 아카이브를 생성합니다.
enclave1
에 대한 아카이브를 준비하려면 사용자는 해당 enclave에 특정한imageSetConfiguration
을 사용하여 엔터프라이즈 연결 해제 환경에서 oc-mirror 플러그인 v2를 실행합니다. 이렇게 하면 해당 앙클레이브에 필요한 이미지만 미러링됩니다.oc mirror --v2 -c isc-enclave.yaml
$ oc mirror --v2 -c isc-enclave.yaml file:///disk-enc1/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 작업은 모든 OpenShift Container Platform 콘텐츠를 아카이브로 수집하고 디스크에 아카이브를 생성합니다.
-
아카이브가 생성된 후
enclave1
네트워크로 전송됩니다. 전송 메커니즘은 oc-mirror 플러그인 v2의 책임이 아닙니다. 인클레이브 레지스트리에 대한 미러 콘텐츠
아카이브 전송이 완료된 후 사용자는 oc-mirror 플러그인 v2를 다시 실행하여 관련 아카이브 내용을 레지스트리에 미러링할 수 있습니다.
oc mirror --v2 -c isc-enclave.yaml --from file://local-disk docker://registry.enc1.in
$ oc mirror --v2 -c isc-enclave.yaml --from file://local-disk docker://registry.enc1.in
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이제
enclave1
에 있는 OpenShift Container Platform 클러스터의 관리자는 해당 클러스터를 설치하거나 업그레이드할 준비가 되었습니다.
3.3.9. oc-mirror 플러그인 v2는 프록시 설정을 지원합니다. 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2는 프록시 구성 환경에서 작동할 수 있습니다. 플러그인은 시스템 프록시 설정을 사용하여 OpenShift Container Platform, Operator 카탈로그 및 additionalImages
레지스트리에 대한 이미지를 검색할 수 있습니다.
3.3.10. oc-mirror 플러그인 v2에서 이미지 시그니처 미러링 및 검증 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 4.19부터 oc-mirror 플러그인 v2는 컨테이너 이미지에 대한 cosign 태그 기반 서명의 미러링과 검증을 지원합니다.
3.3.10.1. oc-mirror 플러그인 v2에 대한 서명 미러링 활성화 링크 복사링크가 클립보드에 복사되었습니다!
기본적으로 서명 미러링은 비활성화되어 있습니다. oc mirror
명령에 --remove-signatures=false
플래그를 설정하면 모든 이미지에 대해 서명 미러링을 활성화할 수 있습니다.
활성화된 경우, oc-mirror 플러그인 v2는 다음 이미지에 대한 Sigstore
태그 기반 서명을 미러링합니다.
- OpenShift 컨테이너 플랫폼 릴리스 이미지
- 운영자 이미지
- 추가 이미지
- Helm 차트
구성 파일을 제공하지 않으면 oc-mirror 플러그인 v2는 --remove-signatures=false
플래그를 사용할 때 기본적으로 모든 이미지에 대한 서명 미러링을 활성화합니다.
사용자 정의 구성 디렉토리를 지정하려면 --registries.d
플래그를 사용합니다.
자세한 내용은 containers-registries.d(5)
매뉴얼을 참조하세요.
프로세스
모든 이미지에 대해 서명 미러링을 활성화하려면 다음 명령을 실행하세요.
oc mirror --remove-signatures=false
$ oc mirror --remove-signatures=false
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 전송 프로토콜, 레지스트리, 네임스페이스 또는 이미지와 같은 특정 요소에 대한 서명 미러링을 활성화하거나 비활성화하려면 다음 단계를 따르세요.
-
$HOME/.config/containers/registries.d/
또는/etc/containers/registries.d/
디렉토리에 YAML 파일을 만듭니다. 다음 예에서 볼 수 있듯이
use-sigstore-attachments
매개변수를 지정하고 제어하려는 특정 요소에서 이를true
또는false
로 설정합니다.예:
quay.io
레지스트리에 대한 서명 미러링 비활성화# ... docker: quay.io: use-sigstore-attachments: false # ...
# ... docker: quay.io: use-sigstore-attachments: false # ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예: 모든 레지스트리에 대한 서명 미러링 활성화
# ... default-docker: use-sigstore-attachments: true # ...
# ... default-docker: use-sigstore-attachments: true # ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
-
3.3.10.2. oc-mirror 플러그인 v2에 대한 서명 검증 활성화 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 4.19부터 oc-mirror 플러그인 v2는 서명 검증을 지원하지만, 이는 기본적으로 비활성화되어 있습니다. 이 플러그인을 활성화하면 컨테이너 이미지가 서명과 일치하는지 확인하여 변경되지 않았고 신뢰할 수 있는 출처에서 왔는지 확인합니다. 서명 불일치가 감지되면 미러링 워크플로가 실패합니다.
프로세스
모든 이미지에 대해 서명 검증을 활성화하려면 다음 명령을 실행하세요.
oc mirror --secure-policy=true
$ oc mirror --secure-policy=true
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 전송 프로토콜, 레지스트리, 네임스페이스 또는 이미지와 같은 특정 요소에 대한 서명 검증을 활성화하거나 비활성화하려면 다음 단계를 따르세요.
$HOME/.config/containers/
또는/etc/containers/
디렉토리에policy.json
파일을 만듭니다.참고정책 구성 파일이 기본 디렉토리 외부에 있는 경우
oc mirror
명령과 함께--policy
플래그를 사용하여 해당 경로를 지정할 수 있습니다.자세한 내용은
containers-policy.json(5)을
참조하세요.적절한 정책 구성을 사용하여 원하는 범위(예: 레지스트리 또는 이미지)에 대한 검증 규칙을 정의합니다. 각 요소 아래에 원하는 규칙을 지정하여 검증 요구 사항을 설정할 수 있습니다.
예: 특정 이미지에 대해서만 검증을 활성화하고 다른 모든 이미지는 거부합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3.11. 연산자 카탈로그에서 필터링이 작동하는 방식 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2는 imageSetConfig
에 있는 정보를 처리하여 미러링할 번들 목록을 선택합니다.
oc-mirror 플러그인 v2가 미러링을 위한 번들을 선택할 때, 그룹 버전 종류(GVK)나 번들 종속성을 추론하지 않으며, 이를 미러링 세트에서 제외합니다. 대신, 사용자 지침을 엄격히 준수합니다. 필수 종속 패키지와 해당 버전을 명시적으로 지정해야 합니다.
ImageSetConfig 연산자 필터링 | 예상 번들 버전 |
---|---|
시나리오 1 mirror: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.10
| 카탈로그의 각 패키지에는 해당 패키지의 각 채널에 대한 헤드 버전에 해당하는 번들 하나가 있습니다. |
시나리오 2 mirror: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.10 full: true
| 지정된 카탈로그의 모든 채널의 모든 번들입니다. |
시나리오 3 mirror: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.10 packages: - name: compliance-operator
| 각 채널의 헤드 버전에 해당하는 하나의 번들입니다. |
시나리오 4 | 지정된 패키지에 대한 모든 채널의 모든 번들입니다. |
시나리오 5 |
모든 채널의 모든 번들( |
시나리오 6 |
해당 패키지의 |
시나리오 7 |
패키지의 |
시나리오 8 |
해당 패키지의 선택된 채널에 대한 헤드 번들입니다. 필터링된 채널이 기본값이 아닌 경우 |
시나리오 9 |
지정된 패키지 및 채널에 대한 모든 번들입니다. 필터링된 채널이 기본값이 아닌 경우에는 |
시나리오 10 | 해당 패키지의 선택된 각 채널에 대한 헤드 번들입니다. |
시나리오 11 |
해당 패키지의 선택된 채널 내에서 |
시나리오 12 |
해당 패키지의 선택된 채널 내에서 |
시나리오 13 |
해당 패키지의 선택된 채널 내에서 |
시나리오 14 |
이 시나리오를 사용하지 마십시오. |
시나리오 15 |
이 시나리오는 사용하지 마세요. |
시나리오 16 |
이 시나리오는 사용하지 마세요. |
3.3.12. oc-mirror 플러그인 v2에 대한 ImageSet 구성 매개변수 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인에는 미러링할 이미지를 정의하는 이미지 세트 구성 파일이 필요합니다. 다음 표에는 ImageSetConfiguration
리소스에 사용 가능한 매개변수가 나열되어 있습니다.
minVersion
및 maxVersion
속성을 사용하여 특정 Operator 버전 범위를 필터링하면 여러 채널 헤드 오류가 발생할 수 있습니다. 오류 메시지는 여러 채널 헤드
가 있음을 나타냅니다. 필터가 적용되면 Operator의 업데이트 그래프가 잘립니다.
OLM에는 모든 Operator 채널에 정확히 하나의 엔드 포인트, 즉 최신 버전의 Operator가 있는 업데이트 그래프를 형성하는 버전이 포함되어 있어야 합니다. 필터 범위가 적용되면 해당 그래프는 두 개 이상의 개별 그래프 또는 두 개 이상의 끝점이 있는 그래프로 전환할 수 있습니다.
이 오류를 방지하려면 최신 버전의 Operator를 필터링하지 마십시오. Operator에 따라 오류가 계속 실행되는 경우 maxVersion
속성을 늘리거나 minVersion
속성을 줄여야 합니다. 모든 Operator 그래프는 다를 수 있으므로 오류가 해결될 때까지 이러한 값을 조정해야 할 수 있습니다.
매개변수 | 설명 | 값 |
---|---|---|
|
|
문자열 예: |
| 이미지 세트 내의 각 아카이브 파일의 최대 크기(GiB)입니다. |
정수 예: |
|
|
부울 예 |
| 이미지 세트의 구성입니다. | 개체 |
| 이미지 세트의 추가 이미지 구성입니다. | 개체 배열 예제: additionalImages: - name: registry.redhat.io/ubi8/ubi:latest
|
| 미러링할 이미지의 태그 또는 다이제스트입니다. |
문자열 예: |
| 미러링을 차단할 태그 또는 다이제스트(SHA)가 포함된 이미지 목록입니다. |
문자열 배열 예: |
|
이미지 세트의 helm 구성입니다. oc-mirror 플러그인은 수동으로 수정된 | 개체 |
| 미러링할 로컬 helm 차트입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. local: - name: podinfo path: /test/podinfo-5.0.0.tar.gz
|
| 미러링할 로컬 helm 차트의 이름입니다. |
문자열. 예: |
| 미러링할 로컬 helm 차트의 경로입니다. |
문자열. 예: |
| 미러링할 원격 helm 리포지토리입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. |
| 미러링할 helm 저장소 이름입니다. |
문자열. 예: |
| 미러링할 helm 리포지토리의 URL입니다. |
문자열. 예: |
| 미러링할 원격 helm 차트입니다. | 개체의 배열입니다. |
| 미러링할 helm 차트의 이름입니다. |
문자열. 예: |
| Helm 차트 내부의 컨테이너 이미지의 사용자 정의 경로입니다. + 참고
|
문자열 배열. 예: |
| 이미지 세트의 Operator 구성 | 개체 배열 예제: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:4.19 packages: - name: elasticsearch-operator minVersion: '2.4.0'
|
| 이미지 세트에 포함할 Operator 카탈로그입니다. |
문자열 예: |
|
|
Boolean 기본값은 |
| Operator 패키지 구성입니다. | 개체 배열 예제: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:4.19 packages: - name: elasticsearch-operator minVersion: '5.2.3-31'
|
| 이미지 세트에 포함할 Operator 패키지 이름입니다. |
문자열 예: |
| 운영자 패키지 채널 구성 | 개체 |
| 이미지 세트에 포함할 Operator 채널 이름은 패키지 내에서 고유합니다. |
문자열 예제: |
| 모든 채널에 걸쳐 가장 높은 버전의 Operator mirror입니다. |
문자열 예: |
| 존재하는 모든 채널에 걸쳐 미러링할 수 있는 Operator의 가장 낮은 버전입니다. |
문자열 예: |
| 모든 채널에 걸쳐 미러링할 수 있는 Operator의 가장 높은 버전입니다. |
문자열 예: |
| 모든 채널에 걸쳐 미러링할 수 있는 가장 낮은 버전의 Operator입니다. |
문자열 예: |
| 참조된 카탈로그를 미러링하기 위한 대체 이름 및 선택적 네임스페이스 계층 |
문자열 예: |
| oc-mirror 플러그인 v2에서 생성된 catalogSource 사용자 정의 리소스를 완성하는 데 사용할 템플릿의 디스크 경로입니다. |
문자열 예: |
|
|
문자열 예: |
| 이미지 세트의 플랫폼 구성입니다. | 개체 |
| 플랫폼 릴리스 페이로드의 아키텍처는 미러링됩니다. | 문자열 배열 예:
기본값은 |
| 이미지 세트의 플랫폼 채널 구성입니다. | 객체 배열 예: channels: - name: stable-4.12 - name: stable-4.19
|
|
|
Boolean 기본값은 |
| 릴리스 채널의 이름 |
문자열 예: |
| 미러링할 참조 플랫폼의 최소 버전입니다. |
문자열 예: |
| 미러링할 참조 플랫폼의 가장 높은 버전입니다. |
문자열 예: |
| 최단 경로 미러링이나 전체 범위 미러링을 전환합니다. |
Boolean 기본값은 |
| 미러링할 플랫폼의 유형 |
문자열 예: |
| OSUS 그래프가 이미지 세트에 추가되고 이후 미러에 게시되는지 여부를 나타냅니다. |
Boolean 기본값은 |
| 필터링에서 기본 채널을 제외할 때 정의해야 합니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. |
3.3.12.1. ImageSet 구성 매개변수 삭제 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하려면 미러 레지스트리에서 삭제할 이미지를 정의하는 이미지 세트 구성 파일을 삭제해야 합니다. 다음 표는 DeleteImageSetConfiguration
리소스에 사용 가능한 매개변수를 나열합니다.
매개변수 | 설명 | 값 |
---|---|---|
|
|
문자열 예: |
| 삭제할 이미지 세트의 구성입니다. | 개체 |
| 삭제 이미지 세트의 추가 이미지 구성입니다. | 객체 배열 예: additionalImages: - name: registry.redhat.io/ubi8/ubi:latest
|
| 삭제할 이미지의 태그 또는 다이제스트입니다. |
문자열 예: |
| 삭제 이미지 세트의 연산자 구성입니다. | 객체 배열 예: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:{product-version} packages: - name: elasticsearch-operator minVersion: '2.4.0'
|
| 삭제 이미지 세트에 포함할 Operator 카탈로그입니다. |
문자열 예: |
| true인 경우 전체 카탈로그, 운영자 패키지 또는 운영자 채널을 삭제합니다. |
Boolean 기본값은 |
| 운영자 패키지 구성 | 객체 배열 예: operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:{product-version} packages: - name: elasticsearch-operator minVersion: '5.2.3-31'
|
| 삭제 이미지 세트에 포함할 Operator 패키지 이름입니다. |
문자열 예: |
| 운영자 패키지 채널 구성 | 개체 |
| 패키지 내에서 고유한 운영자 채널 이름으로, 삭제 이미지 세트에 포함됩니다. |
문자열 예: |
| 선택한 채널 내에서 삭제할 연산자의 가장 높은 버전입니다. |
문자열 예: |
| 선택 영역 내에서 삭제할 연산자의 가장 낮은 버전입니다. |
문자열 예: |
| 모든 채널에서 삭제할 연산자의 가장 높은 버전입니다. |
문자열 예: |
| 존재하는 모든 채널에서 삭제할 가장 낮은 버전의 연산자입니다. |
문자열 예: |
| 이미지 세트의 플랫폼 구성 | 개체 |
| 플랫폼 릴리스 페이로드의 아키텍처를 삭제합니다. | 문자열 배열 예:
기본값은 |
| 이미지 세트의 플랫폼 채널 구성입니다. | 개체 배열 예제: channels: - name: stable-4.12 - name: stable-4.19
|
|
|
Boolean 기본값은 |
| 릴리스 채널의 이름 |
문자열 예: |
| 삭제할 참조 플랫폼의 최소 버전입니다. |
문자열 예: |
| 삭제할 참조 플랫폼의 가장 높은 버전입니다. |
문자열 예: |
| 가장 짧은 경로 삭제와 전체 범위 삭제 사이를 전환합니다. |
Boolean 기본값은 |
| 삭제할 플랫폼의 유형 |
문자열 예: |
| 미러 레지스트리에서도 OSUS 그래프를 삭제할지 여부를 결정합니다. |
Boolean 기본값은 |
3.3.13. oc-mirror 플러그인 v2에 대한 명령어 참조 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 oc-mirror 플러그인 v2에 대한 oc mirror
하위 명령과 플래그를 설명합니다.
하위 명령 | 설명 |
---|---|
| 모든 하위 명령에 대한 도움말 표시 |
| oc-mirror 버전을 출력합니다 |
| 원격 레지스트리 및 로컬 캐시의 이미지를 삭제합니다. |
플래그 | 설명 |
---|---|
|
인증 파일의 문자열 경로를 표시합니다. 기본값은 |
| 이미지 세트 구성 파일의 경로를 지정합니다. |
|
이 플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 블롭과 매니페스트의 영구 캐시를 저장하는 디렉토리를 지정할 수 있습니다. oc-mirror 플러그인은 |
|
컨테이너 레지스트리나 데몬에 액세스할 때 HTTPS가 필요하고 인증서를 확인합니다. 기본값은 |
| 이미지를 미러링하지 않고 동작을 인쇄합니다. |
| oc-mirror 플러그인 v2를 실행하여 대상 레지스트리를 로드하여 생성된 이미지 세트 아카이브의 경로를 지정합니다. |
| 도움말 표시 |
|
이미지 미러링 시간 초과. 기본값은 10m0s입니다. 유효한 시간 단위는 |
|
문자열 로그 수준을 표시합니다. 지원되는 값에는 info, debug, trace, error가 있습니다. 기본값은 |
|
oc-mirror 플러그인 v2 로컬 스토리지 인스턴스에서 사용되는 HTTP 포트를 결정합니다. 기본값은 |
|
병렬로 미러링되는 이미지의 수를 지정합니다. 기본값은 |
|
병렬로 미러링되는 이미지 레이어의 수를 지정합니다. 기본값은 |
|
중첩 경로를 제한하는 대상 레지스트리의 중첩 경로의 최대 수를 지정합니다. 기본값은 |
|
기본값은 |
|
지정된 날짜 이후의 모든 새 콘텐츠를 포함합니다(형식: |
| 컨테이너 레지스트리나 데몬에 액세스할 때 HTTPS가 필요하고 인증서를 확인합니다. |
|
기본값은 |
| oc-mirror 플러그인 v2의 버전을 표시합니다. |
|
|
|
두 번 재시도 사이의 지연 시간입니다. 기본값은 |
|
재시도 횟수. 기본값은 |
|
기본 컨테이너 루트리스 스토리지 경로(일반적으로 |
| 원본 이미지에서 서명을 복사하지 않습니다. |
| 레지스트리 구성 파일이 포함된 디렉토리를 지정합니다. |
| 모든 이미지에 대한 서명 검증이 가능합니다. |
| 서명 검증 정책 파일의 경로를 지정합니다. |
3.3.13.1. 이미지 삭제를 위한 명령어 참조 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 oc mirror
하위 명령과 이미지 삭제 플래그를 설명합니다.
하위 명령 | 설명 |
---|---|
|
인증 파일의 경로입니다. 기본값은 |
|
이 플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 블롭과 매니페스트의 영구 캐시를 저장하는 디렉토리를 지정할 수 있습니다. oc-mirror 플러그인은 |
| 삭제 이미지셋 구성 파일의 경로입니다. |
| 삭제 기능으로 생성된 파일의 버전을 구별하는 데 사용됩니다. |
|
|
| 설정하면 생성되거나 업데이트된 YAML 파일을 사용하여 콘텐츠를 삭제합니다. |
|
컨테이너 레지스트리나 데몬과 통신할 때 HTTPS를 요구하고 인증서를 확인합니다. 기본값은 |
| 로컬 캐시 매니페스트와 블롭을 강제로 삭제하는 데 사용됩니다. |
| 매니페스트와 블롭 목록에 대한 삭제 YAML을 생성하는 데 사용되며, 로컬 캐시와 원격 레지스트리에서 삭제할 때 사용됩니다. |
| 도움말을 표시합니다. |
|
|
|
동시에 삭제되는 이미지의 개수를 나타냅니다. 기본값은 |
|
병렬로 미러링되는 이미지 레이어의 수를 나타냅니다. 기본값은 |
|
oc-mirror의 로컬 스토리지 인스턴스에서 사용하는 HTTP 포트입니다. 기본값은 |
|
2번의 재시도 사이의 지연 시간입니다. 기본값은 |
|
재시도 횟수. 기본값은 |
|
컨테이너 레지스트리나 데몬과 통신할 때 HTTPS를 요구하고 인증서를 확인합니다. 기본값은 |
|
|
3.3.13.2. --cache-dir 및 --workspace 플래그에 관하여 링크 복사링크가 클립보드에 복사되었습니다!
--cache-dir
플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 블롭과 매니페스트의 영구 캐시를 저장하는 디렉토리를 지정할 수 있습니다.
oc-mirror 플러그인은 디스크-미러
및 미러-디스크 워크
플로에서 캐시를 사용하지만 미러-미러
워크플로에서는 캐시를 사용하지 않습니다. 이 플러그인은 캐시를 사용하여 증분 미러링을 수행하고 변경되지 않은 이미지를 다시 미러링하지 않으므로 시간이 절약되고 네트워크 대역폭 사용량이 줄어듭니다.
캐시 디렉토리에는 마지막으로 성공한 미러링 작업까지의 데이터만 포함됩니다. 캐시 디렉토리를 삭제하거나 손상시키면 oc-mirror 플러그인이 이미지 블롭과 매니페스트를 다시 가져오는데, 이로 인해 전체 리미러링이 강제로 수행되어 네트워크 사용량이 늘어날 수 있습니다.
--workspace
플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 생성하는 작업 파일(예: ImageDigestMirrorSet
및 ImageTagMirrorSet
매니페스트)을 저장하는 디렉토리를 지정할 수 있습니다. 작업 공간 디렉토리를 사용하여 다음 작업을 수행할 수도 있습니다.
- 릴리스 및 운영자 이미지에 대한 압축 해제된 메타데이터를 저장합니다.
-
디스크-투-미러
워크플로에 사용할 tar 아카이브를 생성합니다. - 생성된 구성을 클러스터에 적용합니다.
- 이전 미러링 작업을 반복하거나 재개합니다.
작업 공간 디렉토리를 제거하거나 수정하면 향후 미러링 작업이 실패하거나 클러스터에서 일관되지 않은 이미지 소스를 사용할 수 있습니다.
캐시 또는 작업 공간 디렉토리의 내용을 삭제하거나 수정하면 다음과 같은 문제가 발생할 수 있습니다.
- 미러링 작업이 실패했거나 완료되지 않았습니다.
- 증분 미러링 데이터 손실.
- 전체 리미러링 요구 사항과 네트워크 오버헤드 증가.
영향을 완전히 이해하지 않는 한 이러한 디렉토리를 수정, 이전 또는 삭제하지 마십시오. 성공적인 미러링 작업 후에는 캐시 디렉토리를 정기적으로 백업해야 합니다. 각 미러링 주기 동안 내용이 다시 생성되므로 작업 공간 디렉토리를 백업할 필요가 없습니다.
캐시 및 작업 공간 디렉터리를 효과적으로 관리할 수 있도록 다음의 모범 사례를 고려하세요.
- 영구 저장소 사용: 캐시 및 작업 공간 디렉터리를 안정적이고 백업된 저장소에 저장합니다.
- 성공적인 작업 후 백업: 특히 미러링 주기를 완료한 후에는 캐시 디렉토리를 정기적으로 백업하세요.
- 필요할 때 복원: 데이터 손실이 발생한 경우 전체 리미러링을 수행하지 않고도 백업에서 캐시 및 작업 공간 디렉터리를 복원하여 미러링 작업을 재개합니다.
- 별도의 환경: 충돌을 방지하기 위해 다양한 환경에 대한 전용 디렉토리를 사용합니다.
oc-mirror 명령을 실행할 때 캐시 및 작업 공간 디렉토리를 지정하려면 다음 예를 사용하세요.
oc mirror --config=imageset-config.yaml \ file://local_mirror \ --workspace /mnt/mirror-data/workspace \ --cache-dir /mnt/mirror-data/cache
$ oc mirror --config=imageset-config.yaml \
file://local_mirror \
--workspace /mnt/mirror-data/workspace \
--cache-dir /mnt/mirror-data/cache
--v2
미러링 작업이 완료된 후 디렉토리 구조는 다음과 같습니다.
성공적인 미러링 작업이 끝날 때마다 /mnt/mirror-data/cache
디렉토리를 백업해야 합니다.
3.3.14. 다음 단계 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 환경으로 이미지를 미러링한 후 다음 작업을 수행할 수 있습니다.
3.4. oc-mirror 플러그인 v1에서 v2로 마이그레이션 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror v2 플러그인으로 인해 이미지 미러링 워크플로에 대한 주요 변경 사항이 추가되었습니다. 이 가이드에서는 oc-mirror 플러그인 v2와의 호환성을 보장하면서 마이그레이션에 대한 단계별 지침을 제공합니다.
API 버전을 수정하고 더 이상 사용되지 않는 필드를 제거하여 구성을 수동으로 업데이트해야 합니다. 자세한 내용은 "oc-mirror 플러그인 v1에서 v2로의 변경 사항"을 참조하세요.
3.4.1. oc-mirror 플러그인 v1에서 v2로의 변경 사항 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v1에서 v2로 마이그레이션하기 전에 oc-mirror 플러그인 v1과 v2의 다음 차이점을 확인하세요.
-
명시적 버전 선택: 사용자는
oc-mirror를
사용할 때--v2를
명시적으로 지정해야 합니다. 버전을 지정하지 않으면 기본적으로 v1이 실행됩니다. 이러한 동작은 향후 릴리스에서 변경될 것으로 예상되며, 이 경우--v2가
기본값이 됩니다. 업데이트된 명령: 워크플로우 미러링 명령이 oc-mirror 플러그인 v2의 새로운 워크플로우에 맞게 변경되었습니다.
디스크로 미러링하려면 다음 명령을 실행하세요.
oc-mirror --config isc.yaml file://<directory_name> --v2
$ oc-mirror --config isc.yaml file://<directory_name> --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 디스크-투-미러링의 경우 다음 명령을 실행합니다.
oc-mirror --config isc.yaml --from file://<directory_name> docker://<remote_registry> --v2
$ oc-mirror --config isc.yaml --from file://<directory_name> docker://<remote_registry> --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 미러 투 미러의 경우 다음 명령을 실행합니다.
oc-mirror --config isc.yaml --workspace file://<directory_name> docker://<remote_registry> --v2
$ oc-mirror --config isc.yaml --workspace file://<directory_name> docker://<remote_registry> --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고--workspace
는 이제 미러 간 작업에 필요합니다.
-
API 버전 업데이트:
ImageSetConfiguration
API 버전이v1alpha2
(v1)에서v2alpha1
(v2)으로 변경됩니다. 마이그레이션 전에 구성 파일을 수동으로 업데이트해야 합니다. 구성 변경 사항:
-
storageConfig는
oc-mirror 플러그인 v2에서 제거되어야 합니다. - 증분 미러링은 이제 작업 디렉토리나 로컬 캐시를 통해 자동으로 처리됩니다.
-
결과 디렉토리의 변경 사항: 연결이 끊긴 클러스터에 적용될 모든 사용자 정의 리소스는 마이그레이션 후
<workspace_path>/working-dir/cluster-resources
디렉토리에 생성됩니다.- oc-mirror 플러그인 v2의 출력은 oc-mirror 플러그인 v1과 같은 위치에 저장되지 않습니다.
작업 디렉토리 아래의
cluster-resources
폴더에서 다음 리소스를 확인해야 합니다.-
ImageDigestMirrorSet
(IDMS) -
ImageTagMirrorSet
(ITMS) -
CatalogSource
-
ClusterCatalog
-
UpdateService
-
작업 공간 및 디렉토리 명명: 버전 간 전환 시 잠재적인 데이터 불일치를 방지하기 위해 새로운 oc-mirror v2 규칙을 따릅니다.
-
oc-mirror 플러그인 v1
oc-mirror-workspace
디렉토리는 더 이상 필요하지 않습니다. - 충돌을 피하기 위해 oc-mirror 플러그인 v2에 대한 새 디렉토리를 사용하세요.
-
oc-mirror 플러그인 v1
ICSP(
ImageContentSourcePolicy
) 리소스를 IDMS/ITMS로 교체:중요모든
ImageContentSourcePolicy
(ICSP) 리소스를 삭제하면 oc-mirror와 관련이 없는 구성이 제거될 수 있습니다.의도치 않은 삭제를 방지하려면 oc-mirror에서 생성된 ICSP 리소스를 제거 전에 식별하세요. 확실하지 않은 경우 클러스터 관리자에게 확인하십시오. 자세한 내용은 "oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치에 대한 이미지 미러링"을 참조하세요.
-
oc-mirror 플러그인 v2에서는 ICSP 리소스가
ImageDigestMirrorSet
(IDMS) 및ImageTagMirrorSet
(ITMS) 리소스로 대체되었습니다.
-
oc-mirror 플러그인 v2에서는 ICSP 리소스가
3.4.2. oc-mirror 플러그인 v2로 마이그레이션 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인 v1에서 v2로 마이그레이션하려면 ImageSetConfiguration
파일을 수동으로 업데이트하고, 미러링 명령을 수정하고, v1 아티팩트를 정리해야 합니다. 다음 단계에 따라 마이그레이션을 완료하세요.
프로세스
API 버전을 수정하고
ImageSetConfiguration
에서 더 이상 사용되지 않는 필드를 제거합니다.oc-mirror 플러그인 v1 구성을 사용한
ImageSetConfiguration
파일 예시Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc-mirror 플러그인 v2 구성을 사용한
ImageSetConfiguration
파일 예시Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 작업 디렉토리 내의
cluster-resources
디렉토리에서 IDMS, ITMS,CatalogSource
및ClusterCatalog
리소스를 확인하세요.ls <v2_workspace>/working-dir/cluster-resources/
$ ls <v2_workspace>/working-dir/cluster-resources/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 마이그레이션이 완료되면 미러링된 이미지와 카탈로그를 사용할 수 있는지 확인하세요.
- 미러링 중에 오류 또는 경고가 발생하지 않았는지 확인합니다.
-
오류 파일이 생성되지 않았는지 확인하세요(
working-dir/logs/mirroring_errors_YYYYMMdd_HHmmss.txt
).
다음 명령을 사용하여 미러링된 이미지와 카탈로그를 사용할 수 있는지 확인하세요.
oc get catalogsource -n openshift-marketplace
$ oc get catalogsource -n openshift-marketplace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc get imagedigestmirrorset,imagetagmirrorset
$ oc get imagedigestmirrorset,imagetagmirrorset
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 자세한 내용은 "oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치에 대한 이미지 미러링"을 참조하세요.
선택 사항: oc-mirror 플러그인 v1을 사용하여 미러링된 이미지를 제거합니다.
- oc-mirror 플러그인 v1을 사용하여 이미지를 미러링합니다.
ImageSetConfiguration
파일에서v1alpha2
(v1)에서v2alpha1
(v2)으로 API 버전을 업데이트한 다음 다음 명령을 실행합니다.oc-mirror -c isc.yaml file://some-dir --v2
$ oc-mirror -c isc.yaml file://some-dir --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고StorageConfig
는ImageSetConfiguration
및DeleteImageSetConfiguration
파일의 유효한 필드가 아닙니다. oc-mirror 플러그인 v2로 업데이트할 때 이 필드를 제거합니다.다음 명령을 실행하여 삭제 매니페스트를 생성하고 v1 이미지를 삭제합니다.
oc-mirror delete --config=delete-isc.yaml --generate --delete-v1-images --workspace file://some-dir docker://registry.example:5000 --v2
$ oc-mirror delete --config=delete-isc.yaml --generate --delete-v1-images --workspace file://some-dir docker://registry.example:5000 --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요oc-mirror 플러그인 v2는 oc-mirror 플러그인 v1과 달리 대상 레지스트리를 자동으로 정리하지 않습니다. 더 이상 필요하지 않은 이미지를 정리하려면
--delete-v1-images
명령 플래그와 함께 v2의 삭제 기능을 사용하세요.oc-mirror 플러그인 v1로 미러링된 모든 이미지가 제거되면 더 이상 이 플래그를 사용할 필요가 없습니다. oc-mirror 플러그인 v2로 미러링된 이미지를 삭제해야 하는 경우
--delete-v1-images를
설정하지 마세요.이미지 삭제에 대한 자세한 내용은 "연결이 끊긴 환경에서 이미지 삭제"를 참조하세요.
다음 명령을 실행하여 생성된 매니페스트를 기반으로 이미지를 삭제합니다.
oc-mirror delete --delete-yaml-file some-dir/working-dir/delete/delete-images.yaml docker://registry.example:5000 --v2
$ oc-mirror delete --delete-yaml-file some-dir/working-dir/delete/delete-images.yaml docker://registry.example:5000 --v2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5. oc-mirror 플러그인을 사용하여 연결이 끊긴 설치의 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
개인 레지스트리에 있는 OpenShift Container Platform 컨테이너 이미지의 미러링된 세트에서 클러스터를 설치하면 직접적인 인터넷 연결 없이 제한된 네트워크에서 클러스터를 실행할 수 있습니다. 클러스터를 실행하는 동안 이 레지스트리는 항상 실행되어야 합니다. 자세한 내용은 필수 조건 섹션을 참조하세요.
oc-mirror OpenShift CLI( oc
) 플러그인을 사용하면 완전히 또는 부분적으로 연결이 끊긴 환경에서 미러 레지스트리로 이미지를 미러링할 수 있습니다. 공식 Red Hat 레지스트리에서 필요한 이미지를 다운로드하려면 인터넷에 연결된 시스템에서 oc-mirror를 실행해야 합니다.
oc-mirror v1 플러그인은 더 이상 사용되지 않습니다. 기본 미러링 방법은 향후 릴리스에서 oc-mirror v2 플러그인으로 변경되며, oc-mirror v1 플러그인을 계속 사용하려면 --v1
플래그를 지정해야 합니다. 지속적인 지원과 개선을 위해 oc-mirror v2 플러그인 으로 전환하세요.
3.5.1. oc-mirror 플러그인에 대하여 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror OpenShift CLI( oc
) 플러그인을 사용하면 단일 도구를 사용하여 모든 필수 OpenShift Container Platform 콘텐츠와 기타 이미지를 미러 레지스트리로 미러링할 수 있습니다. 다음과 같은 기능을 제공합니다.
- OpenShift Container Platform 릴리스, Operator, helm 차트 및 기타 이미지를 미러링하는 중앙 집중식 방법을 제공합니다.
- OpenShift Container Platform 및 Operator의 업데이트 경로를 유지 관리합니다.
- 선언적 이미지 세트 구성 파일을 사용하여 클러스터에 필요한 OpenShift Container Platform 릴리스, Operator 및 이미지만 포함합니다.
- 증분 미러링을 수행하여 향후 이미지 세트의 크기를 줄입니다.
- 이전 실행 이후 이미지 세트 구성에서 제외된 대상 미러 레지스트리에서 이미지를 정리합니다.
- 선택적으로 OpenShift Update Service (OSUS) 사용에 대한 지원 아티팩트를 생성합니다.
oc-mirror 플러그인을 사용하면 이미지 세트 구성 파일에서 미러링할 콘텐츠를 지정합니다. 이 YAML 파일에서는 클러스터에 필요한 OpenShift Container Platform 릴리스와 Operator만 포함하도록 구성을 미세 조정할 수 있습니다. 이렇게 하면 다운로드 및 전송에 필요한 데이터 양이 줄어듭니다. oc-mirror 플러그인은 임의의 헬름 차트와 추가 컨테이너 이미지를 미러링하여 사용자가 작업 부하를 미러 레지스트리에 원활하게 동기화할 수 있도록 지원합니다.
oc-mirror 플러그인을 처음 실행하면 연결이 끊긴 클러스터 설치나 업데이트를 수행하는 데 필요한 콘텐츠로 미러 레지스트리가 채워집니다. 연결이 끊긴 클러스터가 업데이트를 계속 받으려면 미러 레지스트리를 계속 업데이트해야 합니다. 미러 레지스트리를 업데이트하려면 처음 실행했을 때와 동일한 구성을 사용하여 oc-mirror 플러그인을 실행합니다. oc-mirror 플러그인은 스토리지 백엔드의 메타데이터를 참조하고 도구를 마지막으로 실행한 이후에 릴리스된 내용만 다운로드합니다. 이는 OpenShift Container Platform 및 Operator의 업데이트 경로를 제공하고 필요에 따라 종속성 확인을 수행합니다.
3.5.1.1. 고급 워크플로 링크 복사링크가 클립보드에 복사되었습니다!
다음 단계에서는 oc-mirror 플러그인을 사용하여 이미지를 미러 레지스트리로 미러링하는 방법에 대한 고급 워크플로를 설명합니다.
- 이미지 세트 구성 파일을 생성합니다.
다음 방법 중 하나를 사용하여 이미지 세트를 대상 미러 레지스트리로 미러링합니다.
- 이미지 세트를 대상 미러 레지스트리에 직접 미러링합니다.
- 이미지를 디스크에 미러링하고 대상 환경으로 설정된 이미지를 전송한 다음 대상 미러 레지스트리에 설정된 이미지를 업로드합니다.
- oc-mirror 플러그인에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
- 필요에 따라 이 단계를 반복하여 대상 미러 레지스트리를 업데이트합니다.
oc-mirror CLI 플러그인을 사용하여 미러 레지스트리를 채우는 경우, 대상 미러 레지스트리에 대한 추가 업데이트는 oc-mirror 플러그인을 사용하여 수행해야 합니다.
3.5.2. oc-mirror 플러그인 호환성 및 지원 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인은 OpenShift Container Platform 버전 4.12 이상에 대한 OpenShift Container Platform 페이로드 이미지와 Operator 카탈로그 미러링을 지원합니다.
aarch64
,ppc64le
및 s390x
아키텍처에서 oc-mirror 플러그인은 OpenShift Container Platform 버전 4.14 이상에서만 지원됩니다.
미러링해야 하는 OpenShift Container Platform 버전에 관계없이 oc-mirror 플러그인의 최신 버전을 사용하세요.
3.5.3. 미러 레지스트리 정보 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 설치 및 후속 제품 업데이트에 필요한 이미지를 Red Hat Quay와 같이 Docker v2-2를 지원하는 컨테이너 미러 레지스트리에 미러링할 수 있습니다. 대규모 컨테이너 레지스트리에 액세스할 수 없는 경우 OpenShift Container Platform 구독에 포함된 소규모 컨테이너 레지스트리인 Red Hat OpenShift용 미러 레지스트리를 사용할 수 있습니다.
선택한 레지스트리에 관계없이 인터넷상의 Red Hat 호스팅 사이트의 콘텐츠를 격리된 이미지 레지스트리로 미러링하는 절차는 동일합니다. 콘텐츠를 미러링한 후 미러 레지스트리에서 이 콘텐츠를 검색하도록 각 클러스터를 설정합니다.
OpenShift 이미지 레지스트리는 미러링 프로세스 중에 필요한 태그 없이 푸시를 지원하지 않으므로 대상 레지스트리로 사용할 수 없습니다.
Red Hat OpenShift용 미러 레지스트리가 아닌 컨테이너 레지스트리를 선택하는 경우, 프로비저닝하는 클러스터의 모든 머신에서 접근할 수 있어야 합니다. 레지스트리에 연결할 수 없는 경우 설치, 업데이트 또는 워크로드 재배치와 같은 일반 작업이 실패할 수 있습니다. 따라서 고가용성 방식으로 미러 레지스트리를 실행해야하며 미러 레지스트리는 최소한 OpenShift Container Platform 클러스터의 프로덕션 환경의 가용성조건에 일치해야 합니다.
미러 레지스트리를 OpenShift Container Platform 이미지로 채우면 다음 두 가지 시나리오를 수행할 수 있습니다. 호스트가 인터넷과 미러 레지스트리에 모두 액세스할 수 있지만 클러스터 노드에 액세스 할 수 없는 경우 해당 머신의 콘텐츠를 직접 미러링할 수 있습니다. 이 프로세스를 connected mirroring(미러링 연결)이라고 합니다. 그러한 호스트가 없는 경우 이미지를 파일 시스템에 미러링한 다음 해당 호스트 또는 이동식 미디어를 제한된 환경에 배치해야 합니다. 이 프로세스를 미러링 연결 해제라고 합니다.
미러링된 레지스트리의 경우 가져온 이미지의 소스를 보려면 CRI-O 로그의 Trying to access
로그 항목을 검토해야 합니다. 노드에서 crictl images
명령을 사용하는 등의 이미지 가져오기 소스를 보는 다른 방법은 미러링되지 않은 이미지 이름을 표시합니다.
Red Hat은 OpenShift Container Platform에서 타사 레지스트리를 테스트하지 않습니다.
3.5.4. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Quay와 같이 OpenShift Container Platform 클러스터를 호스팅할 위치에 Docker v2-2를 지원하는 컨테이너 이미지 레지스트리가 있어야 합니다.
참고Red Hat Quay를 사용하는 경우 oc-mirror 플러그인과 함께 버전 3.6 이상을 사용해야 합니다. Red Hat Quay에 대한 권한이 있는 경우 개념 증명 목적으로 Red Hat Quay를 배포하거나 Red Hat Quay Operator를 사용하는 방법 에 대한 설명서를 참조하세요. 레지스트리를 선택 및 설치하는 데 추가 지원이 필요한 경우 영업 담당자 또는 Red Hat 지원팀에 문의하십시오.
컨테이너 이미지 레지스트리에 대한 기존 솔루션이 없는 경우 OpenShift Container Platform 구독자에게 Red Hat OpenShift의 미러 레지스트리가 제공됩니다. Red Hat OpenShift용 미러 레지스트리는 구독에 포함되어 있으며, 연결이 끊긴 설치 환경에서 OpenShift Container Platform의 필수 컨테이너 이미지를 미러링하는 데 사용할 수 있는 소규모 컨테이너 레지스트리입니다.
3.5.5. 미러 호스트 준비 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인을 사용하여 이미지를 미러링하려면 먼저 플러그인을 설치하고 컨테이너 이미지 레지스트리 자격 증명 파일을 생성하여 Red Hat에서 미러로 미러링을 허용해야 합니다.
3.5.5.1. oc-mirror OpenShift CLI 플러그인 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 이미지 세트를 관리하려면 oc-mirror OpenShift CLI 플러그인을 설치하세요.
사전 요구 사항
OpenShift CLI(
oc
)가 설치되어 있습니다. 완전히 연결되지 않은 환경에서 이미지 세트를 미러링하는 경우 다음 사항을 확인하세요.- 인터넷 접속이 가능한 호스트에 oc-mirror 플러그인을 설치했습니다.
- 연결이 끊긴 환경의 호스트는 대상 미러 레지스트리에 액세스할 수 있습니다.
-
oc-mirror를 사용하는 운영 체제에서
umask
매개변수를0022
로 설정했습니다. - 사용 중인 RHEL 버전에 맞는 올바른 바이너리를 설치했습니다.
프로세스
oc-mirror CLI 플러그인을 다운로드하세요:
- Red Hat Hybrid Cloud Console의 다운로드 페이지로 이동합니다.
- OpenShift 연결 설치 툴 섹션의 드롭다운 메뉴에서 OpenShift Client(oc) 미러 플러그인 의 OS 유형 및 아키텍처 유형을 선택합니다.
- 다운로드를 클릭하여 파일을 저장하세요.
다음 명령을 실행하여 아카이브를 추출합니다.
tar xvzf oc-mirror.tar.gz
$ tar xvzf oc-mirror.tar.gz
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 필요한 경우 다음 명령을 실행하여 플러그인 파일을 실행 가능하도록 업데이트합니다.
chmod +x oc-mirror
$ chmod +x oc-mirror
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고oc-mirror
파일의 이름을 바꾸지 마십시오.다음 명령을 실행하여
PATH
(예:/usr/local/bin
)에 파일을 넣어 oc-mirror CLI 플러그인을 설치합니다.sudo mv oc-mirror /usr/local/bin/.
$ sudo mv oc-mirror /usr/local/bin/.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
다음 명령을 실행하여 oc-mirror 플러그인 v1이 성공적으로 설치되었는지 확인하세요.
oc mirror help
$ oc mirror help
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.5.2. 이미지를 미러링할 수 있는 인증 정보 설정 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat에서 미러로 이미지를 미러링할 수 있는 컨테이너 이미지 레지스트리 자격 증명 파일을 만듭니다.
클러스터를 설치할 때 이 이미지 레지스트리 인증 정보 파일을 풀 시크릿(pull secret)으로 사용하지 마십시오. 클러스터를 설치할 때 이 파일을 지정하면 클러스터의 모든 시스템에 미러 레지스트리에 대한 쓰기 권한이 부여됩니다.
사전 요구 사항
- 연결이 끊긴 환경에서 사용할 미러 레지스트리를 구성했습니다.
- 미러 레지스트리에서 이미지를 미러링할 이미지 저장소 위치를 확인했습니다.
- 이미지를 해당 이미지 저장소에 업로드할 수 있는 미러 레지스트리 계정을 제공하고 있습니다.
- 미러 레지스트리에 대한 쓰기 권한이 있습니다.
프로세스
설치 호스트에서 다음 단계를 수행합니다.
-
Red Hat OpenShift Cluster Manager에서
registry.redhat.io
풀 시크릿을 다운로드합니다. 다음 명령을 실행하여 JSON 형식으로 풀 시크릿의 사본을 만듭니다.
cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
$ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 풀 시크릿을 저장할 폴더의 경로와 생성한 JSON 파일의 이름을 지정합니다.
pull secret의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 파일을
~/.docker/config.json
또는$XDG_RUNTIME_DIR/containers/auth.json
으로 저장합니다..docker
또는$XDG_RUNTIME_DIR/containers
디렉터리가 없는 경우 다음 명령을 입력하여 만듭니다.mkdir -p <directory_name>
$ mkdir -p <directory_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 여기서
<directory_name>
은~/.docker
또는$XDG_RUNTIME_DIR/containers
입니다.다음 명령을 입력하여 풀 시크릿을 적절한 디렉터리에 복사합니다.
cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>
$ cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 여기서
<directory_name>
은~/.docker
또는$XDG_RUNTIME_DIR/containers
이며<auth_file>
은config.json
또는auth.json
입니다.
다음 명령을 실행하여 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름과 비밀번호 또는 토큰을 생성합니다.
echo -n '<user_name>:<password>' | base64 -w0
$ echo -n '<user_name>:<password>' | base64 -w0
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
<user_name>
및<password>
의 경우 레지스트리에 설정한 사용자 이름 및 암호를 지정합니다.
출력 예
BGVtbYk3ZHAtqXs=
BGVtbYk3ZHAtqXs=
Copy to Clipboard Copied! Toggle word wrap Toggle overflow JSON 파일을 편집하고 레지스트리를 설명하는 섹션을 추가합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 수정된 풀 시크릿 예시
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.6. 이미지 세트 구성 생성 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인을 사용하여 이미지 세트를 미러링하려면 먼저 이미지 세트 구성 파일을 만들어야 합니다. 이 이미지 세트 구성 파일은 oc-mirror 플러그인에 대한 기타 구성 설정과 함께 미러링할 OpenShift Container Platform 릴리스, 운영자 및 기타 이미지를 정의합니다.
이미지 세트 구성 파일에 스토리지 백엔드를 지정해야 합니다. 이 스토리지 백엔드는 로컬 디렉터리 또는 Docker v2-2 를 지원하는 레지스트리일 수 있습니다. oc-mirror 플러그인은 이미지 세트를 생성하는 동안 이 스토리지 백엔드에 메타데이터를 저장합니다.
oc-mirror 플러그인에서 생성된 메타데이터를 삭제하거나 수정하지 마세요. 동일한 미러 레지스트리에 대해 oc-mirror 플러그인을 실행할 때마다 동일한 스토리지 백엔드를 사용해야 합니다.
사전 요구 사항
- 컨테이너 이미지 레지스트리 인증 정보 파일이 생성되어 있습니다. 자세한 내용은 "이미지 미러링을 허용하는 자격 증명 구성"을 참조하세요.
프로세스
oc mirror init
명령을 사용하여 이미지 세트 구성에 대한 템플릿을 생성하고imageset-config.yaml
이라는 파일에 저장합니다.oc mirror init --registry <storage_backend> > imageset-config.yaml
$ oc mirror init --registry <storage_backend> > imageset-config.yaml
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
example.com/mirror/oc-mirror-metadata
와 같이 스토리지 백엔드의 위치를 지정합니다.
파일을 편집하고 필요에 따라 설정을 조정합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
archiveSize
를 추가하여 이미지 세트 내에서 각 파일의 최대 크기를 GiB 단위로 설정합니다.- 2
- 이미지 세트 메타데이터를 저장할 백엔드 위치를 설정합니다. 이 위치는 레지스트리 또는 로컬 디렉터리일 수 있습니다.
storageConfig
값을 지정해야 합니다. - 3
- 스토리지 백엔드의 레지스트리 URL을 설정합니다.
- 4
- 채널을 설정하여 OpenShift Container Platform 이미지를 검색합니다.
- 5
그래프 추가: 그래프 데이터 이미지를 빌드하고 미러 레지스트리에 푸시하려면 true를
설정합니다. 그래프 데이터 이미지는 OpenShift Update Service(OSUS)를 생성하는 데 필요합니다.그래프: true
필드는UpdateService
사용자 정의 리소스 매니페스트도 생성합니다.oc
명령줄 인터페이스(CLI)는UpdateService
사용자 정의 리소스 매니페스트를 사용하여 OSUS를 생성할 수 있습니다. 자세한 내용은 OpenShift 업데이트 서비스 정보를 참조하십시오.- 6
- Operator 카탈로그를 설정하여 OpenShift Container Platform 이미지를 검색합니다.
- 7
- 이미지 세트에 포함할 특정 Operator 패키지만 지정합니다. 이 필드를 제거하여 카탈로그의 모든 패키지를 검색합니다.
- 8
- 이미지 세트에 포함할 Operator 패키지의 특정 채널만 지정합니다. 해당 채널에서 번들을 사용하지 않더라도 항상 Operator 패키지의 기본 채널을 포함해야 합니다. 다음 명령을 실행하면 기본 채널을 찾을 수 있습니다:
oc mirror list operators --catalog=<catalog_name> --package=<package_name>
. - 9
- 이미지 세트에 포함할 추가 이미지를 지정합니다.
참고그래프: 트루
필드는 다른 미러링된 이미지와 함께유비마이크로
이미지도 미러링합니다.OpenShift Container Platform Extended Update Support(EUS) 버전을 업그레이드할 때 현재 버전과 대상 버전 사이에 중간 버전이 필요할 수 있습니다. 예를 들어, 현재 버전이
4.14
이고 대상 버전이4.16
인 경우 oc-mirror 플러그인 v1을 사용할 때ImageSetConfiguration
에4.15.8
과 같은 버전을 포함해야 할 수도 있습니다.oc-mirror 플러그인 v1은 이를 항상 자동으로 감지하지 못할 수 있으므로 Cincinnati Graph 웹페이지에서 필요한 중간 버전을 확인하고 구성에 수동으로 추가하세요.
전체 매개변수 목록은 "이미지 세트 구성 매개변수"를 참조하고, 다양한 미러링 사용 사례는 "이미지 세트 구성 예시"를 참조하세요.
업데이트된 파일을 저장합니다.
이 이미지 세트 구성 파일은 컨텐츠를 미러링할 때
oc mirror
명령에 필요합니다.
3.5.7. 미러 레지스트리로 이미지 세트 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror CLI 플러그인을 사용하여 부분적으로 연결이 끊긴 환경 또는 완전히 연결이 끊긴 환경에서 미러 레지스트리에 이미지를 미러링할 수 있습니다.
이 절차에서는 이미 미러 레지스트리가 설정되어 있다고 가정합니다.
3.5.7.1. 부분적으로 연결이 끊긴 환경에서 이미지 세트 미러링 링크 복사링크가 클립보드에 복사되었습니다!
부분적으로 연결이 끊긴 환경에서는 대상 미러 레지스트리에 직접 설정된 이미지를 미러링할 수 있습니다.
3.5.7.1.1. 미러에서 미러로 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인을 사용하면 이미지 세트를 생성하는 동안 접근 가능한 대상 미러 레지스트리에 이미지 세트를 직접 미러링할 수 있습니다.
이미지 세트 구성 파일에서 스토리지 백엔드를 지정해야 합니다. 이 스토리지 백엔드는 로컬 디렉터리 또는 Docker v2 레지스트리일 수 있습니다. oc-mirror 플러그인은 이미지 세트를 생성하는 동안 이 스토리지 백엔드에 메타데이터를 저장합니다.
oc-mirror 플러그인에서 생성된 메타데이터를 삭제하거나 수정하지 마세요. 동일한 미러 레지스트리에 대해 oc-mirror 플러그인을 실행할 때마다 동일한 스토리지 백엔드를 사용해야 합니다.
사전 요구 사항
- 필요한 컨테이너 이미지를 얻으려면 인터넷에 접속해야 합니다.
-
OpenShift CLI(
oc
)가 설치되어 있습니다. - oc-mirror CLI 플러그인을 설치했습니다.
- 이미지 세트 구성 파일을 생성했습니다.
프로세스
oc mirror
명령을 실행하여 지정된 이미지 세트 구성의 이미지를 지정된 레지스트리로 미러링합니다.oc mirror --config=./<imageset-config.yaml> \ docker://registry.example:5000
$ oc mirror --config=./<imageset-config.yaml> \
1 docker://registry.example:5000
2 Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
-
생성된
oc-mirror-workspace/
디렉터리로 이동합니다. -
결과 디렉터리로 이동합니다 (예:
results-1639608409/
). -
ImageContentSourcePolicy
및CatalogSource
리소스에 YAML 파일이 있는지 확인합니다.
ImageContentSourcePolicy
YAML 파일의 repositoryDigestMirrors
섹션은 설치 중에 install-config.yaml
파일에 사용됩니다.
다음 단계
- oc-mirror에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
문제 해결
3.5.7.2. 완전히 연결이 끊긴 환경에서 이미지 세트 미러링 링크 복사링크가 클립보드에 복사되었습니다!
완전히 연결이 끊긴 환경에서 이미지 세트를 미러링하려면 먼저 이미지 세트를 디스크로 미러링 한 다음 디스크의 이미지 세트 파일을 미러에 미러링해야 합니다.
3.5.7.2.1. 미러에서 디스크로 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인을 사용하면 이미지 세트를 생성하고 내용을 디스크에 저장할 수 있습니다. 그런 다음 생성된 이미지 세트를 연결이 끊긴 환경으로 전송하고 대상 레지스트리에 미러링할 수 있습니다.
이미지 세트 구성 파일에 지정된 구성에 따라 oc-mirror를 사용하여 이미지를 미러링하는 경우 수백 기가바이트의 데이터를 디스크에 다운로드할 수 있습니다.
미러 레지스트리를 채울 때 초기 이미지 세트 다운로드는 종종 가장 큰 것입니다. 마지막으로 명령을 실행한 이후 변경된 이미지만 다운로드하므로 oc-mirror 플러그인을 다시 실행하면 생성된 이미지 세트가 더 작아지는 경우가 많습니다.
이미지 세트 구성 파일에서 스토리지 백엔드를 지정해야 합니다. 이 스토리지 백엔드는 로컬 디렉터리 또는 docker v2 레지스트리일 수 있습니다. oc-mirror 플러그인은 이미지 세트를 생성하는 동안 이 스토리지 백엔드에 메타데이터를 저장합니다.
oc-mirror 플러그인에서 생성된 메타데이터를 삭제하거나 수정하지 마세요. 동일한 미러 레지스트리에 대해 oc-mirror 플러그인을 실행할 때마다 동일한 스토리지 백엔드를 사용해야 합니다.
사전 요구 사항
- 필요한 컨테이너 이미지를 얻으려면 인터넷에 액세스할 수 있습니다.
-
OpenShift CLI(
oc
)가 설치되어 있습니다. - oc-mirror CLI 플러그인을 설치했습니다.
- 이미지 세트 구성 파일을 생성했습니다.
프로세스
oc mirror
명령을 실행하여 지정된 이미지 세트 구성의 이미지를 디스크로 미러링합니다.oc mirror --config=./imageset-config.yaml \ file://<path_to_output_directory>
$ oc mirror --config=./imageset-config.yaml \
1 file://<path_to_output_directory>
2 Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
출력 디렉터리로 이동합니다.
cd <path_to_output_directory>
$ cd <path_to_output_directory>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이미지 세트
.tar
파일이 생성되었는지 확인합니다.ls
$ ls
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
mirror_seq1_000000.tar
mirror_seq1_000000.tar
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
다음 단계
- 이미지 세트 .tar 파일을 연결이 끊긴 환경으로 전송합니다.
문제 해결
3.5.7.2.2. 디스크에서 미러로 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인을 사용하면 생성된 이미지 세트의 내용을 대상 미러 레지스트리로 미러링할 수 있습니다.
사전 요구 사항
-
연결이 끊긴 환경에 OpenShift CLI (
oc
)를 설치했습니다. - 연결이 끊긴 환경에 oc-mirror CLI 플러그인을 설치했습니다.
-
oc mirror
명령을 사용하여 이미지 세트 파일을 생성했습니다. - 이미지 세트 파일을 연결이 끊긴 환경으로 전송했습니다.
프로세스
oc mirror
명령을 실행하여 디스크에서 이미지 세트 파일을 처리하고 콘텐츠를 대상 미러 레지스트리에 미러링합니다.oc mirror --from=./mirror_seq1_000000.tar \ docker://registry.example:5000
$ oc mirror --from=./mirror_seq1_000000.tar \
1 docker://registry.example:5000
2 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 명령은 이미지 세트로 미러 레지스트리를 업데이트하고
ImageContentSourcePolicy
및CatalogSource
리소스를 생성합니다.
검증
-
생성된
oc-mirror-workspace/
디렉터리로 이동합니다. -
결과 디렉터리로 이동합니다 (예:
results-1639608409/
). -
ImageContentSourcePolicy
및CatalogSource
리소스에 YAML 파일이 있는지 확인합니다.
다음 단계
- oc-mirror에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
문제 해결
3.5.8. oc-mirror에서 생성된 리소스를 사용하도록 클러스터 구성 링크 복사링크가 클립보드에 복사되었습니다!
이미지 세트를 미러 레지스트리로 미러링한 후에는 생성된 ImageContentSourcePolicy
, CatalogSource를
적용하고 이미지 서명 리소스를 클러스터에 릴리스해야 합니다.
ImageContentSourcePolicy
리소스는 미러 레지스트리를 소스 레지스트리와 연결하고 온라인 레지스트리에서 미러 레지스트리로 이미지 가져오기 요청을 리디렉션합니다. CatalogSource
리소스는 OLM(Operator Lifecycle Manager) Classic에서 미러 레지스트리에서 사용 가능한 Operator에 대한 정보를 검색하는 데 사용됩니다. 릴리스 이미지 서명은 미러링된 릴리스 이미지를 확인하는 데 사용됩니다.
OLM v1은 ClusterCatalog
리소스를 사용하여 미러 레지스트리에서 사용 가능한 클러스터 확장에 대한 정보를 검색합니다.
oc-mirror 플러그인 v1은 ClusterCatalog
리소스를 자동으로 생성하지 않습니다. 수동으로 생성해야 합니다. ClusterCatalog
리소스를 만들고 적용하는 방법에 대한 자세한 내용은 "확장"의 "클러스터에 카탈로그 추가"를 참조하세요.
사전 요구 사항
- 연결이 끊긴 환경에서 레지스트리 미러로 이미지를 미러링했습니다.
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
프로세스
-
cluster-admin
역할이 있는 사용자로 OpenShift CLI(oc
)에 로그인합니다. 다음 명령을 실행하여 결과 디렉토리의 YAML 파일을 클러스터에 적용합니다.
oc apply -f ./oc-mirror-workspace/results-1639608409/
$ oc apply -f ./oc-mirror-workspace/results-1639608409/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 미러링된 릴리스 이미지가 있는 경우 다음 명령을 실행하여 릴리스 이미지 서명을 클러스터에 적용합니다.
oc apply -f ./oc-mirror-workspace/results-1639608409/release-signatures/
$ oc apply -f ./oc-mirror-workspace/results-1639608409/release-signatures/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고클러스터 대신 Operator를 미러링하는 경우
$ oc apply -f ./oc-mirror-workspace/results-1639608409/release-signatures/
를 실행할 필요가 없습니다. 적용할 릴리스 이미지 서명이 없으므로 해당 명령을 실행하면 오류가 반환됩니다.
검증
다음 명령을 실행하여
ImageContentSourcePolicy
리소스가 성공적으로 설치되었는지 확인하세요.oc get imagecontentsourcepolicy
$ oc get imagecontentsourcepolicy
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여
CatalogSource
리소스가 성공적으로 설치되었는지 확인하세요.oc get catalogsource -n openshift-marketplace
$ oc get catalogsource -n openshift-marketplace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.9. 미러 레지스트리 콘텐츠 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
이미지 세트 구성 파일을 업데이트하고 이미지 세트를 미러 레지스트리에 미러링하여 미러 레지스트리 콘텐츠를 업데이트할 수 있습니다. 다음에 oc-mirror 플러그인을 실행하면 이전 실행 이후 새롭고 업데이트된 이미지만 포함된 이미지 세트가 생성됩니다.
미러 레지스트리를 업데이트할 때 다음 사항을 고려해야 합니다.
최신 이미지 세트에 더 이상 포함되지 않은 이미지는 생성되어 미러링된 경우 대상 미러 레지스트리에서 정리됩니다. 따라서 다음 주요 구성 요소의 동일한 조합에 대해 이미지를 업데이트하여 차등 이미지 세트만 생성되고 미러링되도록 해야 합니다.
- 이미지 세트 구성
- 목적지 레지스트리
- 스토리지 구성
- 디스크 대 미러 또는 미러 대 미러 워크플로의 경우 이미지를 정리할 수 있습니다.
- 생성된 이미지 세트는 순서대로 대상 미러 레지스트리에 푸시되어야 합니다. 생성된 이미지 세트 아카이브 파일의 파일 이름에서 시퀀스 번호를 파생할 수 있습니다.
- oc-mirror 플러그인이 생성한 메타데이터 이미지를 삭제하거나 수정하지 마세요.
- 초기 이미지 세트 생성 중에 미러 레지스트리에 대한 최상위 네임스페이스를 지정한 경우 동일한 미러 레지스트리에 대해 oc-mirror 플러그인을 실행할 때마다 동일한 네임스페이스를 사용해야 합니다.
미러 레지스트리 콘텐츠를 업데이트하는 워크플로에 대한 자세한 내용은 "고급 워크플로" 섹션을 참조하세요.
3.5.9.1. 미러 레지스트리 업데이트 예 링크 복사링크가 클립보드에 복사되었습니다!
이 섹션에서는 디스크에서 미러로 미러 레지스트리를 업데이트하는 사용 사례를 다룹니다.
이전에 미러링에 사용되었던 ImageSetConfiguration
파일 예시
기존 이미지를 정리하여 특정 OpenShift 컨테이너 플랫폼 버전을 미러링합니다.
ImageSetConfiguration
파일이 업데이트되었습니다.
- 1
stable-4.13
으로 교체하면stable-4.12
의 모든 이미지가 제거됩니다.
기존 이미지를 정리하여 최신 버전의 Operator로 업데이트
ImageSetConfiguration
파일이 업데이트되었습니다.
- 1
- 버전을 지정하지 않고 동일한 채널을 사용하면 기존 이미지가 정리되고 최신 버전의 이미지로 업데이트됩니다.
기존 Operator를 정리하여 새로운 Operator를 미러링합니다.
ImageSetConfiguration
파일이 업데이트되었습니다.
- 1
rhacs-operator를
new_operator_name
으로 바꾸면 Red Hat Advanced Cluster Security for Kubernetes Operator가 제거됩니다.
모든 OpenShift 컨테이너 플랫폼 이미지 정리
ImageSetConfiguration
파일이 업데이트되었습니다.
3.5.10. 드라이런 수행 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror를 사용하면 실제로 이미지를 미러링하지 않고도 테스트 실행을 수행할 수 있습니다. 이를 통해 미러링될 이미지 목록과 미러 레지스트리에서 제거될 이미지를 검토할 수 있습니다. 연습 실행을 통해 이미지 세트 구성의 오류를 일찍 발견하거나 생성된 이미지 목록을 다른 도구와 함께 사용하여 미러링 작업을 수행할 수도 있습니다.
사전 요구 사항
- 필요한 컨테이너 이미지를 얻으려면 인터넷에 액세스할 수 있습니다.
-
OpenShift CLI(
oc
)가 설치되어 있습니다. - oc-mirror CLI 플러그인을 설치했습니다.
- 이미지 세트 구성 파일을 생성했습니다.
프로세스
--dry-run
플래그와 함께oc mirror
명령을 실행하여 테스트 실행을 수행합니다.oc mirror --config=./imageset-config.yaml \ docker://registry.example:5000 \ --dry-run
$ oc mirror --config=./imageset-config.yaml \
1 docker://registry.example:5000 \
2 --dry-run
3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 생성된 작업 공간 디렉토리로 이동합니다.
cd oc-mirror-workspace/
$ cd oc-mirror-workspace/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 생성된
mapping.txt
파일을 검토합니다.이 파일에는 미러링될 모든 이미지 목록이 포함되어 있습니다.
생성된
pruning-plan.json
파일을 검토합니다.이 파일에는 이미지 세트가 게시될 때 미러 레지스트리에서 제거되는 모든 이미지 목록이 포함되어 있습니다.
참고pruning-plan.json
파일은 oc-mirror 명령이 미러 레지스트리를 가리키고 정리할 이미지가 있는 경우에만 생성됩니다.
3.5.11. 로컬 OCI 운영자 카탈로그 포함 링크 복사링크가 클립보드에 복사되었습니다!
레지스트리에서 OpenShift Container Platform 릴리스, Operator 카탈로그 및 추가 이미지를 부분적으로 연결이 끊긴 클러스터로 미러링하는 동안 디스크에 있는 로컬 파일 기반 카탈로그의 Operator 카탈로그 이미지를 포함할 수 있습니다. 로컬 카탈로그는 OCI(Open Container Initiative) 형식이어야 합니다.
로컬 카탈로그와 그 내용은 이미지 세트 구성 파일의 필터링 정보를 기반으로 대상 미러 레지스트리에 미러링됩니다.
로컬 OCI 카탈로그를 미러링하는 경우 로컬 OCI 형식 카탈로그와 함께 미러링하려는 모든 OpenShift Container Platform 릴리스나 추가 이미지를 레지스트리에서 가져와야 합니다.
디스크에 있는 oc-mirror 이미지 세트 파일과 함께 OCI 카탈로그를 미러링할 수 없습니다.
OCI 기능을 사용하는 한 가지 사용 사례는 CI/CD 시스템이 디스크의 위치에 OCI 카탈로그를 빌드하고, 해당 OCI 카탈로그를 OpenShift Container Platform 릴리스와 함께 미러 레지스트리에 미러링하려는 경우입니다.
OpenShift Container Platform 4.12의 oc-mirror 플러그인에 대한 Technology Preview OCI 로컬 카탈로그 기능을 사용한 경우, 더 이상 oc-mirror 플러그인의 OCI 로컬 카탈로그 기능을 사용하여 카탈로그를 로컬로 복사하고 완전히 연결 해제된 클러스터로 미러링하기 위한 첫 번째 단계로 OCI 형식으로 변환할 수 없습니다.
사전 요구 사항
- 필요한 컨테이너 이미지를 얻으려면 인터넷에 액세스할 수 있습니다.
-
OpenShift CLI(
oc
)가 설치되어 있습니다. - oc-mirror CLI 플러그인을 설치했습니다.
프로세스
이미지 세트 구성 파일을 만들고 필요에 따라 설정을 조정합니다.
다음 예제 이미지 세트 구성은 OpenShift Container Platform 릴리스와
registry.redhat.io
의 UBI 이미지와 함께 디스크에 있는 OCI 카탈로그를 미러링합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 이미지 세트 메타데이터를 저장할 백엔드 위치를 설정합니다. 이 위치는 레지스트리 또는 로컬 디렉터리일 수 있습니다.
storageConfig
값을 지정해야 합니다. - 2
- 선택적으로
registry.redhat.io
에서 미러링할 OpenShift Container Platform 릴리스를 포함합니다. - 3
- 디스크에서 OCI 카탈로그의 위치에 대한 절대 경로를 지정합니다. OCI 기능을 사용하는 경우 경로는
oci://
로 시작해야 합니다. - 4
- 선택적으로 카탈로그를 미러링할 대체 네임스페이스와 이름을 지정합니다.
- 5
- 선택적으로 레지스트리에서 가져올 추가 운영자 카탈로그를 지정합니다.
- 6
- 선택적으로 레지스트리에서 가져올 추가 이미지를 지정합니다.
oc mirror
명령을 실행하여 OCI 카탈로그를 대상 미러 레지스트리로 미러링합니다.oc mirror --config=./imageset-config.yaml \ docker://registry.example:5000
$ oc mirror --config=./imageset-config.yaml \
1 docker://registry.example:5000
2 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 선택적으로 OCI 기능의 동작을 조정하기 위해 다른 플래그를 지정할 수 있습니다.
--oci-insecure-signature-policy
- 서명을 대상 미러 레지스트리로 내보내지 마십시오.
--oci-registries-config
TOML 형식의
registries.conf
파일의 경로를 지정합니다. 이 기능을 사용하면 이미지 세트 구성 파일을 변경하지 않고도 테스트를 위한 사전 프로덕션 위치 등 다른 레지스트리에서 미러링할 수 있습니다. 이 플래그는 로컬 OCI 카탈로그에만 영향을 미치며, 다른 미러링된 콘텐츠에는 영향을 미치지 않습니다.registries.conf 파일 예시
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
다음 단계
- oc-mirror에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
3.5.12. 이미지 세트 구성 매개변수 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror 플러그인에는 어떤 이미지를 미러링할지 정의하는 이미지 세트 구성 파일이 필요합니다. 다음 표에는 ImageSetConfiguration
리소스에 사용 가능한 매개변수가 나열되어 있습니다.
매개변수 | 설명 | 값 |
---|---|---|
|
|
문자열. 예: |
| 이미지 세트 내의 각 아카이브 파일의 최대 크기(GiB)입니다. |
정수. 예: |
| 이미지 세트의 구성입니다. | 개체 |
| 이미지 세트의 추가 이미지 구성입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. additionalImages: - name: registry.redhat.io/ubi8/ubi:latest
|
| 미러링할 이미지의 태그 또는 다이제스트입니다. |
문자열. 예: |
| 미러링을 차단할 이미지의 전체 태그, 다이제스트 또는 패턴입니다. |
문자열의 배열. 예: |
| 이미지 세트의 helm 구성입니다. oc-mirror 플러그인은 렌더링 시 사용자 입력이 필요하지 않은 헬름 차트만 지원합니다. | 개체 |
| 미러링할 로컬 helm 차트입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. local: - name: podinfo path: /test/podinfo-5.0.0.tar.gz
|
| 미러링할 로컬 helm 차트의 이름입니다. |
문자열. 예: |
| 미러링할 로컬 helm 차트의 경로입니다. |
문자열. 예: |
| 미러링할 원격 helm 리포지토리입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. |
| 미러링할 helm 저장소 이름입니다. |
문자열. 예: |
| 미러링할 helm 리포지토리의 URL입니다. |
문자열. 예: |
| 미러링할 원격 helm 차트입니다. | 개체의 배열입니다. |
| 미러링할 helm 차트의 이름입니다. |
문자열. 예: |
| 미러링할 이름이 helm 차트의 버전입니다. |
문자열. 예: |
| 이미지 세트의 Operator 구성 | 개체의 배열입니다. 예를 들면 다음과 같습니다. operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.19 packages: - name: elasticsearch-operator minVersion: '2.4.0'
|
| 이미지 세트에 포함할 Operator 카탈로그입니다. |
문자열. 예: |
|
|
부울. 기본값은 |
| Operator 패키지 구성입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. operators: - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.19 packages: - name: elasticsearch-operator minVersion: '5.2.3-31'
|
| 이미지 세트에 포함할 Operator 패키지 이름 |
문자열. 예: |
| Operator 패키지 채널 구성입니다. | 개체 |
| 이미지 세트에 포함할 Operator 채널 이름은 패키지 내에서 고유합니다. |
문자열. 예를 들어: |
| 모든 채널에 걸쳐 가장 높은 버전의 Operator mirror입니다. 자세한 내용은 다음 참고사항을 참조하세요. |
문자열. 예: |
| 채널 헤드에 업데이트 그래프에 포함된 모든 번들과 함께 포함할 최소 번들의 이름입니다. 명명된 번들에 의미적 버전 메타데이터가 없는 경우에만 이 필드를 설정합니다. |
문자열. 예: |
| 모든 채널에 걸쳐 미러링할 수 있는 가장 낮은 버전의 Operator입니다. 자세한 내용은 다음 참고사항을 참조하세요. |
문자열. 예: |
| 모든 채널에 걸쳐 미러링할 수 있는 Operator의 가장 높은 버전입니다. 자세한 내용은 다음 참고 사항을 참조하십시오. |
문자열. 예: |
| 존재하는 모든 채널에 미러링할 Operator의 가장 낮은 버전입니다. 자세한 내용은 다음 참고 사항을 참조하십시오. |
문자열. 예: |
|
|
부울. 기본값은 |
| 참조된 카탈로그를 미러링하는 대체 이름 및 선택적 네임스페이스 계층 구조입니다. |
문자열. 예: |
| 참조된 카탈로그를 반영하는 대체 이름입니다.
|
문자열. 예: |
|
|
문자열. 예: |
| 이미지 세트의 플랫폼 구성입니다. | 개체 |
| 플랫폼 릴리스 페이로드의 아키텍처는 미러링됩니다. | 문자열의 배열. 예를 들면 다음과 같습니다.
기본값은 |
| 이미지 세트의 플랫폼 채널 구성입니다. | 개체의 배열입니다. 예를 들면 다음과 같습니다. channels: - name: stable-4.10 - name: stable-4.19
|
|
|
부울. 기본값은 |
| 릴리스 채널의 이름입니다. |
문자열. 예: |
| 미러링할 참조된 플랫폼의 최소 버전입니다. |
문자열. 예를 들면 |
| 참조된 플랫폼의 가장 높은 버전을 미러링합니다. |
문자열. 예를 들면 |
| 경로 미러링 또는 전체 범위 미러링을 전환합니다. |
부울. 기본값은 |
| 미러링할 플랫폼의 유형입니다. |
문자열. 예: |
| OSUS 그래프가 이미지 세트에 추가되고 나중에 미러에 게시되는지 여부를 나타냅니다. |
부울. 기본값은 |
| 이미지 세트의 백엔드 구성입니다. | 개체 |
| 이미지 세트의 로컬 백엔드 구성입니다. | 개체 |
| 이미지 세트 메타데이터를 포함할 디렉터리의 경로입니다. |
문자열. 예: |
| 이미지 세트의 레지스트리 백엔드 구성입니다. | 개체 |
| 백엔드 레지스트리 URI입니다. URI에 네임스페이스 참조를 선택적으로 포함할 수 있습니다. |
문자열. 예: |
| 필요한 경우 참조된 백엔드 레지스트리의 TLS 확인을 건너뜁니다. |
부울. 기본값은 |
minVersion
및 maxVersion
속성을 사용하여 특정 Operator 버전 범위를 필터링하면 여러 채널 헤드 오류가 발생할 수 있습니다. 오류 메시지는 여러 채널 헤드
가 있음을 나타냅니다. 필터가 적용되면 Operator의 업데이트 그래프가 잘립니다.
Operator Lifecycle Manager를 사용하려면 모든 Operator 채널에 정확히 하나의 엔드 포인트, 즉 최신 버전의 Operator가 있는 업데이트 그래프를 구성하는 버전이 포함되어 있어야 합니다. 필터 범위가 적용되면 해당 그래프는 두 개 이상의 개별 그래프 또는 두 개 이상의 끝점이 있는 그래프로 전환할 수 있습니다.
이 오류를 방지하려면 최신 버전의 Operator를 필터링하지 마십시오. Operator에 따라 오류가 계속 실행되는 경우 maxVersion
속성을 늘리거나 minVersion
속성을 줄여야 합니다. 모든 Operator 그래프는 다를 수 있으므로 오류가 해결될 때까지 이러한 값을 조정해야 할 수 있습니다.
3.5.13. 이미지 세트 구성 예 링크 복사링크가 클립보드에 복사되었습니다!
다음 ImageSetConfiguration
파일 예제에서는 다양한 미러링 사용 사례에 대한 구성을 보여줍니다.
사용 사례: 가장 짧은 OpenShift 컨테이너 플랫폼 업데이트 경로 포함
다음 ImageSetConfiguration
파일은 로컬 스토리지 백엔드를 사용하고 최소 버전 4.11.37
에서 최대 버전 4.12.15
까지의 가장 짧은 업데이트 경로를 따라 모든 OpenShift Container Platform 버전을 포함합니다.
ImageSetConfiguration
파일 예
사용 사례: 다중 아키텍처 릴리스를 위해 최소 버전부터 최신 버전까지 OpenShift Container Platform의 모든 버전을 포함합니다.
다음 ImageSetConfiguration
파일은 레지스트리 스토리지 백엔드를 사용하고 채널의 최신 버전인 최소 4.13.4
부터 시작하여 모든 OpenShift Container Platform 버전을 포함합니다. 이 이미지 세트 구성으로 oc-mirror를 호출할 때마다 stable-4.13
채널의 최신 릴리스가 평가되므로 정기적으로 oc-mirror를 실행하면 OpenShift Container Platform 이미지의 최신 릴리스를 자동으로 받을 수 있습니다.
platform.architectures
값을 multi
로 설정하면 다중 아키텍처 릴리스에 대한 미러링이 지원됩니다.
ImageSetConfiguration
파일 예
사용 사례: Operator 버전 최소에서 최신 버전 포함
다음 ImageSetConfiguration
파일은 로컬 스토리지 백엔드를 사용하며 안정
채널에서 4.0.1 이상 버전부터 시작하는 Red Hat Advanced Cluster Security for Kubernetes Operator만 포함합니다.
최소 또는 최대 버전 범위를 지정하면 해당 범위에 속하는 모든 Operator 버전을 받지 못할 수 있습니다.
기본적으로 oc-mirror는 OLM(Operator Lifecycle Manager) 사양에서 건너뛰거나 최신 버전으로 대체된 모든 버전을 제외합니다. 건너뛴 운영자 버전은 CVE의 영향을 받거나 버그를 포함할 수 있습니다. 대신 최신 버전을 사용하세요. 건너뛴 버전과 바뀐 버전에 대한 자세한 내용은 OLM을 사용하여 업데이트 그래프 만들기를 참조하세요.
지정된 범위 내의 모든 Operator 버전을 받으려면 mirror.operators.full
필드를 true
로 설정하면 됩니다.
ImageSetConfiguration
파일 예
최신 버전 대신 최대 버전을 지정하려면 mirror.operators.packages.channels.maxVersion
필드를 설정합니다.
사용 사례: Nutanix CSI Operator 포함
다음 ImageSetConfiguration
파일은 로컬 스토리지 백엔드를 사용하고 Nutanix CSI Operator, OpenShift Update Service(OSUS) 그래프 이미지, 추가 Red Hat Universal Base Image(UBI)를 포함합니다.
ImageSetConfiguration
파일 예
사용 사례: 기본 운영자 채널 포함
다음 ImageSetConfiguration
파일에는 OpenShift Elasticsearch Operator의 stable-5.7
및 stable
채널이 포함되어 있습니다. stable-5.7
채널의 패키지만 필요한 경우에도, operator의 기본 채널인 stable
채널도 ImageSetConfiguration
파일에 포함되어야 합니다. 해당 채널에서 번들을 사용하지 않더라도 항상 Operator 패키지의 기본 채널을 포함해야 합니다.
다음 명령을 실행하면 기본 채널을 찾을 수 있습니다: oc mirror list operators --catalog=<catalog_name> --package=<package_name>
.
ImageSetConfiguration
파일 예
사용 사례: 전체 카탈로그(모든 버전) 포함
다음 ImageSetConfiguration
파일은 mirror.operators.full
필드를 true
로 설정하여 전체 Operator 카탈로그의 모든 버전을 포함합니다.
ImageSetConfiguration
파일 예
사용 사례: 전체 카탈로그 포함(채널 헤드만)
다음 ImageSetConfiguration
파일에는 전체 Operator 카탈로그에 대한 채널 헤드가 포함되어 있습니다.
기본적으로 카탈로그의 각 운영자에 대해 oc-mirror는 기본 채널의 최신 운영자 버전(채널 헤드)을 포함합니다. 채널 헤드뿐만 아니라 모든 Operator 버전을 미러링하려면 mirror.operators.full
필드를 true
로 설정해야 합니다.
이 예제에서는 targetCatalog
필드를 사용하여 카탈로그를 미러링할 대체 네임스페이스와 이름을 지정합니다.
ImageSetConfiguration
파일 예
사용 사례: 임의의 이미지 및 helm 차트 포함
다음 ImageSetConfiguration
파일은 레지스트리 스토리지 백엔드를 사용하며 helm 차트 및 추가 Red Hat UBI(Universal Base Image)를 포함합니다.
ImageSetConfiguration
파일 예
사용 사례: EUS 릴리스의 업그레이드 경로 포함
다음 ImageSetConfiguration
파일에는 eus-<version>
채널이 포함되어 있으며, 여기서 maxVersion
값은 minVersion
값보다 최소 2개의 마이너 버전 이상 높습니다.
예를 들어, 이 ImageSetConfiguration
파일에서 minVersion은
4.12.28
로 설정되고, eus-4.14
채널의 maxVersion은
4.14.16
입니다.
ImageSetConfiguration
파일 예
사용 사례: 멀티클러스터 엔진 운영자를 위한 멀티 아키텍처 OpenShift 컨테이너 플랫폼 이미지 및 카탈로그 포함
다음 ImageSetConfiguration
파일에는 채널의 최소 버전 4.19.0
부터 시작하는 Kubernetes Operator 및 모든 OpenShift Container Platform 버전에 대한 멀티클러스터 엔진이 포함되어 있습니다.
ImageSetConfiguration
파일 예
3.5.14. oc-mirror에 대한 명령어 참조 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 oc mirror
하위 명령과 플래그를 설명합니다.
하위 명령 | 설명 |
---|---|
| 지정된 셸에 대한 자동 완성 스크립트를 생성합니다. |
| 이미지 세트의 내용을 출력합니다. |
| 모든 하위 명령에 대한 도움말을 표시합니다. |
| 초기 이미지 세트 구성 템플릿을 출력합니다. |
| 사용 가능한 플랫폼과 운영자 콘텐츠와 버전을 나열하세요. |
| oc-mirror 버전을 출력합니다. |
플래그 | 설명 |
---|---|
| 이미지 세트 구성 파일의 경로를 지정합니다. |
| 이미지 풀링과 관련 없는 오류가 발생하면 계속해서 최대한 미러링을 시도하세요. |
| 대상 레지스트리에 대한 TLS 유효성 검사를 비활성화합니다. |
| 대상 레지스트리에 일반 HTTP를 사용합니다. |
|
이미지를 미러링하지 않고 작업을 인쇄합니다. |
| oc-mirror를 실행하여 생성된 이미지 세트 아카이브의 경로를 지정하여 대상 레지스트리에 로드합니다. |
| 도움을 보여주세요. |
| 이미지를 다운로드하고 레이어를 패키징할 때 이전 미러를 무시합니다. 증분 미러링을 비활성화하고 더 많은 데이터를 다운로드할 수 있습니다. |
|
|
|
중첩 경로를 제한하는 대상 레지스트리의 중첩 경로의 최대 수를 지정합니다. 기본값은 |
|
레지스트리당 허용되는 동시 요청 수를 지정합니다. 기본값은 |
|
로컬 OCI 카탈로그를 미러링할 때 서명을 푸시하지 마세요( |
|
|
| 아티팩트 디렉토리 제거를 건너뜁니다. |
| 운영자 카탈로그에서 이미지 태그를 다이제스트 핀으로 바꾸지 마세요. |
| 이미지 세트를 게시할 때 메타데이터를 건너뜁니다. 참고
이 옵션은 |
| 이미지를 찾을 수 없는 경우 오류를 보고하고 실행을 중단하는 대신 이미지를 건너뜁니다. 이미지 세트 구성에 명시적으로 지정된 사용자 정의 이미지에는 적용되지 않습니다. |
| 대상 미러 레지스트리에서 이미지의 자동 정리를 비활성화합니다. |
| 다이제스트 검증을 건너뜁니다. |
| 소스 레지스트리에 대한 TLS 유효성 검사를 비활성화합니다. |
| 소스 레지스트리에는 일반 HTTP를 사용합니다. |
|
로그 수준의 자세한 정도에 대한 숫자를 지정합니다. 유효한 값은 |
3.6. oc adm 명령을 사용하여 연결이 끊긴 설치에 대한 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
클러스터가 외부 콘텐츠에 대한 조직의 제어를 충족하는 컨테이너 이미지만 사용하도록 할 수 있습니다. 제한된 네트워크에서 프로비저닝된 인프라에 클러스터를 설치하기 전에 필요한 컨테이너 이미지를 해당 환경에 미러링해야 합니다. oc adm
명령을 사용하면 OpenShift에서 릴리스 및 카탈로그 이미지를 미러링할 수 있습니다. 컨테이너 이미지를 미러링하려면 미러링을 위한 레지스트리가 있어야 합니다.
필요한 컨테이너 이미지를 얻으려면 인터넷에 액세스해야 합니다. 이 절차에서는 네트워크와 인터넷에 모두 액세스할 수 있는 미러 호스트에 미러 레지스트리를 배치합니다. 미러 호스트에 액세스할 수 없는 경우 연결이 끊긴 클러스터에 사용할 Operator 카탈로그를 미러링하여 네트워크 경계를 이동할 수 있는 장치에 이미지를 복사합니다.
3.6.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
다음 레지스트리 중 하나와 같이 OpenShift Container Platform 클러스터를 호스팅할 위치에 Docker v2-2를 지원하는 컨테이너 이미지 레지스트리가 있어야 합니다.
Red Hat Quay에 대한 권한이 있는 경우 개념 증명 목적으로 Red Hat Quay를 배포하거나 Red Hat Quay Operator를 사용하는 방법 에 대한 설명서를 참조하세요. 레지스트리를 선택 및 설치하는 데 추가 지원이 필요한 경우 영업 담당자 또는 Red Hat 지원팀에 문의하십시오.
- 컨테이너 이미지 레지스트리에 대한 기존 솔루션이 없는 경우 OpenShift Container Platform 구독자에게 Red Hat OpenShift의 미러 레지스트리가 제공됩니다. Red Hat OpenShift용 미러 레지스트리는 구독에 포함되어 있으며, 연결이 끊긴 설치 환경에서 OpenShift Container Platform의 필수 컨테이너 이미지를 미러링하는 데 사용할 수 있는 소규모 컨테이너 레지스트리입니다.
3.6.2. 미러 레지스트리 정보 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 설치 및 후속 제품 업데이트에 필요한 이미지를 Red Hat Quay, JFrog Artifactory, Sonatype Nexus Repository 또는 Harbor와 같은 컨테이너 미러 레지스트리에 미러링할 수 있습니다. 대규모 컨테이너 레지스트리에 액세스할 수 없는 경우 OpenShift Container Platform 구독에 포함된 소규모 컨테이너 레지스트리인 Red Hat OpenShift용 미러 레지스트리를 사용할 수 있습니다.
Red Hat Quay, Red Hat OpenShift의 미러 레지스트리 , Artifactory, Sonatype Nexus Repository 또는 Harbor 등 Docker v2-2를 지원하는 모든 컨테이너 레지스트리를 사용할 수 있습니다. 선택한 레지스트리에 관계없이 인터넷상의 Red Hat 호스팅 사이트의 콘텐츠를 격리된 이미지 레지스트리로 미러링하는 절차는 동일합니다. 콘텐츠를 미러링한 후 미러 레지스트리에서 이 콘텐츠를 검색하도록 각 클러스터를 설정합니다.
OpenShift 이미지 레지스트리는 미러링 프로세스 중에 필요한 태그 없이 푸시를 지원하지 않으므로 대상 레지스트리로 사용할 수 없습니다.
Red Hat OpenShift용 미러 레지스트리가 아닌 컨테이너 레지스트리를 선택하는 경우, 프로비저닝하는 클러스터의 모든 머신에서 접근할 수 있어야 합니다. 레지스트리에 연결할 수 없는 경우 설치, 업데이트 또는 워크로드 재배치와 같은 일반 작업이 실패할 수 있습니다. 따라서 고가용성 방식으로 미러 레지스트리를 실행해야하며 미러 레지스트리는 최소한 OpenShift Container Platform 클러스터의 프로덕션 환경의 가용성조건에 일치해야 합니다.
미러 레지스트리를 OpenShift Container Platform 이미지로 채우면 다음 두 가지 시나리오를 수행할 수 있습니다. 호스트가 인터넷과 미러 레지스트리에 모두 액세스할 수 있지만 클러스터 노드에 액세스 할 수 없는 경우 해당 머신의 콘텐츠를 직접 미러링할 수 있습니다. 이 프로세스를 connected mirroring(미러링 연결)이라고 합니다. 그러한 호스트가 없는 경우 이미지를 파일 시스템에 미러링한 다음 해당 호스트 또는 이동식 미디어를 제한된 환경에 배치해야 합니다. 이 프로세스를 미러링 연결 해제라고 합니다.
미러링된 레지스트리의 경우 가져온 이미지의 소스를 보려면 CRI-O 로그의 Trying to access
로그 항목을 검토해야 합니다. 노드에서 crictl images
명령을 사용하는 등의 이미지 가져오기 소스를 보는 다른 방법은 미러링되지 않은 이미지 이름을 표시합니다.
Red Hat은 OpenShift Container Platform에서 타사 레지스트리를 테스트하지 않습니다.
추가 정보
이미지 소스를 보려면 CRI-O 로그를 확인하는 방법에 대한 자세한 내용은 이미지 가져오기 소스 보기를 참조하십시오.
3.6.3. 미러 호스트 준비 링크 복사링크가 클립보드에 복사되었습니다!
미러 단계를 수행하기 전에 호스트는 콘텐츠를 검색하고 원격 위치로 푸시할 준비가 되어 있어야 합니다.
3.6.3.1. OpenShift CLI 설치 링크 복사링크가 클립보드에 복사되었습니다!
명령줄 인터페이스를 사용하여 OpenShift Container Platform과 상호 작용하기 위해 OpenShift CLI(oc
)를 설치할 수 있습니다. Linux, Windows 또는 macOS에 oc
를 설치할 수 있습니다.
이전 버전의 oc
를 설치한 경우 OpenShift Container Platform 4.19에서 모든 명령을 완료하는 데 사용할 수 없습니다. 새 버전의 oc
를 다운로드하여 설치합니다.
Linux에서 OpenShift CLI 설치
다음 절차를 사용하여 Linux에서 OpenShift CLI(oc
) 바이너리를 설치할 수 있습니다.
프로세스
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 제품 변형 드롭다운 목록에서 아키텍처를 선택합니다.
- 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
- OpenShift v4.19 Linux 클라이언트 항목 옆에 있는 '지금 다운로드'를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
tar xvf <file>
$ tar xvf <file>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc
바이너리를PATH
에 있는 디렉터리에 배치합니다.PATH
를 확인하려면 다음 명령을 실행합니다.echo $PATH
$ echo $PATH
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
OpenShift CLI를 설치한 후
oc
명령을 사용할 수 있습니다.oc <command>
$ oc <command>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Windows에서 OpenSfhit CLI 설치
다음 절차에 따라 Windows에 OpenShift CLI(oc
) 바이너리를 설치할 수 있습니다.
프로세스
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
- OpenShift v4.19 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
- ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc
바이너리를PATH
에 있는 디렉터리로 이동합니다.PATH
를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.path
C:\> path
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
OpenShift CLI를 설치한 후
oc
명령을 사용할 수 있습니다.oc <command>
C:\> oc <command>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
macOS에 OpenShift CLI 설치
다음 절차에 따라 macOS에서 OpenShift CLI(oc
) 바이너리를 설치할 수 있습니다.
프로세스
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.19 macOS 클라이언트 항목 옆에 있는 '지금 다운로드'를 클릭하고 파일을 저장합니다.
참고macOS arm64의 경우 OpenShift v4.19 macOS arm64 클라이언트 항목을 선택합니다.
- 아카이브의 압축을 해제하고 압축을 풉니다.
oc
바이너리 PATH의 디렉터리로 이동합니다.PATH
를 확인하려면 터미널을 열고 다음 명령을 실행합니다.echo $PATH
$ echo $PATH
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
oc
명령을 사용하여 설치를 확인하세요.oc <command>
$ oc <command>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6.4. 이미지를 미러링할 수 있는 인증 정보 설정 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat에서 미러로 이미지를 미러링할 수 있는 컨테이너 이미지 레지스트리 자격 증명 파일을 만듭니다.
클러스터를 설치할 때 이 이미지 레지스트리 인증 정보 파일을 풀 시크릿(pull secret)으로 사용하지 마십시오. 클러스터를 설치할 때 이 파일을 지정하면 클러스터의 모든 시스템에 미러 레지스트리에 대한 쓰기 권한이 부여됩니다.
사전 요구 사항
- 연결이 끊긴 환경에서 사용할 미러 레지스트리를 구성했습니다.
- 미러 레지스트리에서 이미지를 미러링할 이미지 저장소 위치를 확인했습니다.
- 이미지를 해당 이미지 저장소에 업로드할 수 있는 미러 레지스트리 계정을 제공하고 있습니다.
- 미러 레지스트리에 대한 쓰기 권한이 있습니다.
프로세스
설치 호스트에서 다음 단계를 수행합니다.
-
Red Hat OpenShift Cluster Manager에서
registry.redhat.io
풀 시크릿을 다운로드합니다. 다음 명령을 실행하여 JSON 형식으로 풀 시크릿의 사본을 만듭니다.
cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
$ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 풀 시크릿을 저장할 폴더의 경로와 생성한 JSON 파일의 이름을 지정합니다.
pull secret의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름과 비밀번호 또는 토큰을 생성합니다.
echo -n '<user_name>:<password>' | base64 -w0
$ echo -n '<user_name>:<password>' | base64 -w0
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
<user_name>
및<password>
의 경우 레지스트리에 설정한 사용자 이름 및 암호를 지정합니다.
출력 예
BGVtbYk3ZHAtqXs=
BGVtbYk3ZHAtqXs=
Copy to Clipboard Copied! Toggle word wrap Toggle overflow JSON 파일을 편집하고 레지스트리를 설명하는 섹션을 추가합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 수정된 풀 시크릿 예시
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6.5. OpenShift Container Platform 이미지 저장소 미러링 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 설치 또는 업그레이드 중에 사용할 OpenShift Container Platform 이미지 저장소를 레지스트리에 미러링합니다.
사전 요구 사항
- 미러 호스트가 인터넷에 액세스할 수 있습니다.
- 네트워크가 제한된 환경에서 사용할 미러 레지스트리를 설정하고 설정한 인증서 및 인증 정보에 액세스할 수 있습니다.
- Red Hat OpenShift Cluster Manager에서 풀 시크릿을 다운로드하고 미러 저장소에 대한 인증을 포함하도록 수정했습니다.
- 자체 서명된 인증서를 사용하는 경우 인증서에 주체 대체 이름을 지정했습니다.
프로세스
미러 호스트에서 다음 단계를 완료합니다.
- OpenShift Container Platform 다운로드 페이지를 확인하여 설치할 OpenShift Container Platform 버전을 확인하고 Repository Tags 페이지에서 해당 태그를 지정합니다.
필요한 환경 변수를 설정합니다.
릴리스 버전을 내보냅니다.
OCP_RELEASE=<release_version>
$ OCP_RELEASE=<release_version>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <release_version>
에 대해 설치할 OpenShift Container Platform 버전에 해당하는 태그를 지정합니다 (예:4.5.4
).로컬 레지스트리 이름 및 호스트 포트를 내보냅니다.
LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'
$ LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <local_registry_host_name>
의 경우 미러 저장소의 레지스트리 도메인 이름을 지정하고<local_registry_host_port>
의 경우 콘텐츠를 제공하는데 사용되는 포트를 지정합니다.로컬 저장소 이름을 내보냅니다.
LOCAL_REPOSITORY='<local_repository_name>'
$ LOCAL_REPOSITORY='<local_repository_name>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <local_repository_name>
의 경우 레지스트리에 작성할 저장소 이름 (예:ocp4/openshift4
)을 지정합니다.미러링할 저장소 이름을 내보냅니다.
PRODUCT_REPO='openshift-release-dev'
$ PRODUCT_REPO='openshift-release-dev'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 프로덕션 환경의 릴리스의 경우
openshift-release-dev
를 지정해야 합니다.레지스트리 풀 시크릿의 경로를 내보냅니다.
LOCAL_SECRET_JSON='<path_to_pull_secret>'
$ LOCAL_SECRET_JSON='<path_to_pull_secret>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 생성한 미러 레지스트리에 대한 풀 시크릿의 절대 경로 및 파일 이름을
<path_to_pull_secret>
에 지정합니다.릴리스 미러를 내보냅니다.
RELEASE_NAME="ocp-release"
$ RELEASE_NAME="ocp-release"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 프로덕션 환경의 릴리스의 경우
ocp-release
를 지정해야 합니다.클러스터의 아키텍처 유형을 내보냅니다.
ARCHITECTURE=<cluster_architecture>
$ ARCHITECTURE=<cluster_architecture>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
x86_64
,aarch64
,s390x
또는ppc64le
과 같은 클러스터의 아키텍처를 지정합니다.
미러링된 이미지를 호스트할 디렉터리의 경로를 내보냅니다.
REMOVABLE_MEDIA_PATH=<path>
$ REMOVABLE_MEDIA_PATH=<path>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 초기 슬래시 (/) 문자를 포함하여 전체 경로를 지정합니다.
미러 레지스트리에 버전 이미지를 미러링합니다.
미러 호스트가 인터넷에 액세스할 수 없는 경우 다음 작업을 수행합니다.
- 이동식 미디어를 인터넷에 연결된 시스템에 연결합니다.
미러링할 이미지 및 설정 매니페스트를 확인합니다.
oc adm release mirror -a ${LOCAL_SECRET_JSON} \ --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \ --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} --dry-run
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} \ --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \ --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} --dry-run
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
이전 명령의 출력에서 전체
imageContentSources
섹션을 기록합니다. 미러에 대한 정보는 미러링된 저장소에 고유하며 설치 중에imageContentSources
섹션을install-config.yaml
파일에 추가해야 합니다. 이동식 미디어의 디렉터리에 이미지를 미러링합니다.
oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 미디어를 네트워크가 제한된 환경으로 가져와서 이미지를 로컬 컨테이너 레지스트리에 업로드합니다.
oc image mirror -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}
$ oc image mirror -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
REMOVABLE_MEDIA_PATH
의 경우 이미지를 미러링 할 때 지정한 것과 동일한 경로를 사용해야 합니다.
중요oc image mirror
를 실행하면 다음과 같은 오류가 발생할 수 있습니다.error: unable to retrieve source image
. 이 오류는 이미지 인덱스에 이미지 레지스트리에 더 이상 존재하지 않는 이미지에 대한 참조가 포함된 경우 발생합니다. 이미지 인덱스에서는 이러한 이미지를 실행하는 사용자가 업그레이드 그래프의 최신 지점으로 업그레이드 경로를 실행할 수 있도록 이전 참조를 유지할 수 있습니다. 임시 해결 방법으로--skip-missing
옵션을 사용하여 오류를 무시하고 이미지 인덱스를 계속 다운로드할 수 있습니다. 자세한 내용은 Service Mesh Operator 미러링 실패 에서 참조하십시오.
로컬 컨테이너 레지스트리가 미러 호스트에 연결된 경우 다음 작업을 수행합니다.
다음 명령을 사용하여 릴리스 이미지를 로컬 레지스트리에 직접 푸시합니다.
oc adm release mirror -a ${LOCAL_SECRET_JSON} \ --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \ --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} \ --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} \ --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 명령은 요약된 릴리스 정보를 가져오며, 명령 출력에는 클러스터를 설치할 때 필요한
imageContentSources
데이터가 포함됩니다.이전 명령의 출력에서 전체
imageContentSources
섹션을 기록합니다. 미러에 대한 정보는 미러링된 저장소에 고유하며 설치 중에imageContentSources
섹션을install-config.yaml
파일에 추가해야 합니다.참고미러링 프로세스 중에 이미지 이름이 Quay.io에 패치되고 podman 이미지는 부트스트랩 가상 머신의 레지스트리에 Quay.io를 표시합니다.
미러링된 콘텐츠를 기반으로 설치 프로그램을 생성하려면 콘텐츠를 추출하여 릴리스 배포에 고정합니다.
미러 호스트가 인터넷에 액세스할 수 없는 경우 다음 명령을 실행합니다.
oc adm release extract -a ${LOCAL_SECRET_JSON} --icsp-file=<file> --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}" \ --insecure=true
$ oc adm release extract -a ${LOCAL_SECRET_JSON} --icsp-file=<file> --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}" \ --insecure=true
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 선택 사항: 대상 레지스트리에 대한 신뢰를 구성하지 않으려면
--insecure=true
플래그를 추가합니다.
로컬 컨테이너 레지스트리가 미러 호스트에 연결된 경우 다음 명령을 실행합니다.
oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"
$ oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요선택한 OpenShift Container Platform 버전에 올바른 이미지를 사용하려면 미러링된 콘텐츠에서 설치 프로그램을 배포해야 합니다.
인터넷이 연결된 컴퓨터에서 이 단계를 수행해야 합니다.
설치 프로그램에서 제공하는 인프라를 사용하는 클러스터의 경우 다음 명령을 실행합니다.
openshift-install
$ openshift-install
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6.6. 연결이 끊긴 환경의 Cluster Samples Operator 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서는 Cluster Samples Operator를 구성하기 위해 클러스터를 설치한 후 추가 단계를 수행해야 합니다. 준비 과정에서 다음 정보를 검토합니다.
3.6.6.1. 미러링을 위한 Cluster Samples Operator 지원 링크 복사링크가 클립보드에 복사되었습니다!
설치 프로세스 중에 OpenShift Container Platform은 openshift-cluster-samples-operator
네임스페이스에 imagestreamtag-to-image
라는 구성 맵을 생성합니다. imagestreamtag-to-image
구성 맵에는 각 이미지 스트림 태그에 대한 이미지 채우기 항목이 포함되어 있습니다.
구성 맵의 데이터 필드에 있는 각 항목의 키 형식은 <image_stream_name>_<image_stream_tag_name>
입니다.
OpenShift Container Platform의 연결이 끊긴 설치 프로세스 중에 Cluster Samples Operator의 상태가 Removed
로 설정됩니다. Managed
로 변경하려면 샘플이 설치됩니다.
네트워크 제한 또는 중단된 환경에서 샘플을 사용하려면 네트워크 외부의 서비스에 액세스해야 할 수 있습니다. 일부 예제 서비스에는 GitHub, Maven Central, npm, RubyGems, PyPi 등이 있습니다. 클러스터 샘플 Operator의 오브젝트가 필요한 서비스에 도달할 수 있도록 하는 추가 단계가 있을 수 있습니다.
이 구성 맵을 사용하여 이미지 스트림을 가져오려면 이미지를 미러링해야 하는 이미지 참조로 사용할 수 있습니다.
-
Cluster Samples Operator가
Removed
로 설정된 경우 미러링된 레지스트리를 생성하거나 사용할 기존 미러링된 레지스트리를 확인할 수 있습니다. - 새 구성 맵을 가이드로 사용하여 미러링된 레지스트리에 샘플을 미러링합니다.
-
Cluster Samples Operator 구성 개체의
skippedImagestreams
필드에 미러링되지 않은 이미지 스트림을 추가합니다. -
Cluster Samples Operator 구성 개체의
samplesRegistry
를 미러링된 레지스트리로 설정합니다. -
그런 다음 Cluster Samples Operator를
Managed
로 설정하여 미러링된 이미지 스트림을 설치합니다.
3.6.7. 연결이 끊긴 클러스터와 함께 사용할 Operator 카탈로그 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc adm catalog mirror
명령을 사용하여 Red Hat 제공 카탈로그 또는 사용자 정의 카탈로그의 Operator 콘텐츠를 컨테이너 이미지 레지스트리에 미러링할 수 있습니다. 대상 레지스트리는 Docker v2-2를 지원해야 합니다. 제한된 네트워크에 있는 클러스터의 경우 이 레지스트리는 제한된 네트워크 클러스터 설치 중 생성된 미러 레지스트리와 같이 클러스터에 네트워크 액세스 권한이 있는 레지스트리일 수 있습니다.
- OpenShift 이미지 레지스트리는 미러링 프로세스 중에 필요한 태그 없이 푸시를 지원하지 않으므로 대상 레지스트리로 사용할 수 없습니다.
-
oc adm catalog mirror를
실행하면 다음과 같은 오류가 발생할 수 있습니다:error: unable to retrieve source image
. 이 오류는 이미지 인덱스에 이미지 레지스트리에 더 이상 존재하지 않는 이미지에 대한 참조가 포함된 경우 발생합니다. 이미지 인덱스에서는 이러한 이미지를 실행하는 사용자가 업그레이드 그래프의 최신 지점으로 업그레이드 경로를 실행할 수 있도록 이전 참조를 유지할 수 있습니다. 임시 해결 방법으로--skip-missing
옵션을 사용하여 오류를 무시하고 이미지 인덱스를 계속 다운로드할 수 있습니다. 자세한 내용은 Service Mesh Operator 미러링 실패 에서 참조하십시오.
oc adm catalog mirror
명령은 또한 Red Hat 제공 인덱스 이미지이든 자체 사용자 정의 빌드 인덱스 이미지이든 미러링 프로세스 중에 지정하는 인덱스 이미지를 대상 레지스트리에 자동으로 미러링합니다. 그러면 미러링된 인덱스 이미지를 사용하여 OLM(Operator Lifecycle Manager)이 OpenShift Container Platform 클러스터에 미러링된 카탈로그를 로드할 수 있는 카탈로그 소스를 생성할 수 있습니다.
3.6.7.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 클러스터에 사용할 Operator 카탈로그를 미러링하려면 다음과 같은 사전 요구 사항이 있습니다.
- 워크스테이션에서 무제한 네트워크 액세스가 가능합니다.
-
podman
버전이 1.9.3 이상입니다. 기존 카탈로그를 필터링하거나 정리 하고 연산자 하위 집합만 선택적으로 미러링하려면 다음 섹션을 참조하세요.
Red Hat 제공 카탈로그를 미러링하려면 무제한 네트워크 액세스 권한이 있는 워크스테이션에서 다음 명령을 실행하여
registry.redhat.io
로 인증합니다.podman login registry.redhat.io
$ podman login registry.redhat.io
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Docker v2-2 를 지원하는 미러 레지스트리에 액세스합니다.
-
미러 레지스트리에서 미러링된 Operator 콘텐츠를 저장하는 데 사용할 저장소 또는 네임스페이스를 결정합니다. 예를 들어,
olm-mirror
저장소를 만들 수 있습니다. - 미러 레지스트리가 인터넷에 액세스할 수 없는 경우 이동식 미디어를 무제한 네트워크 액세스 권한이 있는 워크스테이션에 연결합니다.
registry.redhat.io
를 포함하여 프라이빗 레지스트리로 작업하는 경우REG_CREDS
환경 변수를 이후 단계에서 사용할 레지스트리 자격 증명의 파일 경로로 설정합니다. 예를 들어podman
CLI의 경우:REG_CREDS=${XDG_RUNTIME_DIR}/containers/auth.json
$ REG_CREDS=${XDG_RUNTIME_DIR}/containers/auth.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6.7.2. 카탈로그 콘텐츠 추출 및 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc adm catalog mirror
명령은 인덱스 이미지의 콘텐츠를 추출하여 미러링에 필요한 매니페스트를 생성합니다. 명령의 기본 동작은 매니페스트를 생성한 다음 인덱스 이미지 자체뿐만 아니라 인덱스 이미지의 모든 이미지 콘텐츠를 미러 레지스트리에 자동으로 미러링합니다.
또는 미러 레지스트리가 완전히 연결이 끊긴 호스트 또는 에어갭(Airgap) 호스트에 있는 경우 먼저 콘텐츠를 이동식 미디어로 미러링하고 미디어를 연결이 끊긴 환경으로 이동한 다음 미디어에서 레지스트리로 해당 콘텐츠를 미러링할 수 있습니다.
3.6.7.2.1. 동일한 네트워크의 레지스트리에 카탈로그 콘텐츠 미러링 링크 복사링크가 클립보드에 복사되었습니다!
미러 레지스트리가 무제한 네트워크 액세스 권한이 있는 워크스테이션과 동일한 네트워크에 배치된 경우 워크스테이션에서 다음 작업을 수행합니다.
프로세스
미러 레지스트리에 인증이 필요한 경우 다음 명령을 실행하여 레지스트리에 로그인합니다.
podman login <mirror_registry>
$ podman login <mirror_registry>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 콘텐츠를 미러 레지스트리에 추출하고 미러링합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 미러링할 카탈로그의 인덱스 이미지를 지정합니다.
- 2
- 대상 레지스트리가 운영자 콘텐츠를 미러링할 정규화된 도메인 이름(FQDN)을 지정합니다. 미러 레지스트리
<저장소>
는 레지스트리에 있는 기존 저장소나 네임스페이스일 수 있습니다(예: 필수 구성 요소에 설명된 대로olm-mirror)
. 미러링 중에 기존 저장소가 발견되면 저장소 이름이 결과 이미지 이름에 추가됩니다. 이미지 이름에 리포지토리 이름을 포함하지 않으려면 이 행에서<repository>
값을 생략합니다. (예:<mirror_registry>:<port>
) - 3
- 선택 사항: 필요한 경우 레지스트리 자격 증명 파일의 위치를 지정합니다.
registry.redhat.io
에는{REG_CREDS}
가 필요합니다. - 4
- 선택 사항: 대상 레지스트리에 대한 트러스트를 구성하지 않으려면
--insecure
플래그를 추가합니다. - 5
- 선택 사항: 여러 변형이 있을 때 선택할 수 있는 인덱스 이미지의 플랫폼 및 아키텍처를 지정합니다. 이미지는
'<platform>/<arch>[/<variant>]’
로 전달됩니다. 이는 인덱스에서 참조하는 이미지에는 적용되지 않습니다. 유효한 값은linux/amd64
,linux/ppc64le
,linux/s390x
,linux/arm64
입니다. - 6
- 선택 사항: 이미지 콘텐츠를 실제로 레지스트리에 미러링하지 않고 미러링에 필요한 매니페스트만 생성합니다. 이 옵션은 미러링할 항목을 검토하는 데 유용할 수 있으며 패키지의 서브 세트만 필요한 경우 매핑 목록을 변경할 수 있습니다. 그런 다음
oc image mirror
명령과 함께mapping.txt
파일을 사용하여 이후 단계에서 수정된 이미지 목록을 미러링할 수 있습니다. 이 플래그는 카탈로그의 콘텐츠를 고급으로 선택적으로 미러링하는 용도로만 사용됩니다.
출력 예
src image has index label for database path: /database/index.db using database path mapping: /database/index.db:/tmp/153048078 wrote database to /tmp/153048078 ... wrote mirroring manifests to manifests-redhat-operator-index-1614211642
src image has index label for database path: /database/index.db using database path mapping: /database/index.db:/tmp/153048078 wrote database to /tmp/153048078
1 ... wrote mirroring manifests to manifests-redhat-operator-index-1614211642
2 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 명령으로 생성된 임시
index.db
데이터베이스용 디렉터리입니다. - 2
- 생성된 매니페스트 디렉터리 이름을 기록합니다. 이 디렉터리는 후속 절차에서 참조됩니다.참고
Red Hat Quay는 중첩된 저장소를 지원하지 않습니다. 결과적으로
oc adm catalog mirror
명령을 실행하면401
무단 오류와 함께 실패합니다. 이 문제를 해결하려면oc adm catalog mirror
명령을 실행하여 중첩된 리포지토리 생성을 비활성화할 때--max-components=2
옵션을 사용할 수 있습니다. 이 해결 방법에 대한 자세한 내용은 Quay 레지스트리 지식베이스 솔루션에서 catalog mirror 명령을 사용하는 동안 발생하는 무단 오류를 참조하십시오.
3.6.7.2.2. Airgapped 레지스트리에 카탈로그 콘텐츠 미러링 링크 복사링크가 클립보드에 복사되었습니다!
미러 레지스트리가 완전히 연결이 끊겼거나 에어그래시된 호스트에 있는 경우 다음 작업을 수행합니다.
프로세스
무제한 네트워크 액세스 권한이 있는 워크스테이션에서 다음 명령을 실행하여 콘텐츠를 로컬 파일에 미러링합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 미러링할 카탈로그의 인덱스 이미지를 지정합니다.
- 2
- 현재 디렉터리의 로컬 파일에 미러링할 내용을 지정합니다.
- 3
- 선택 사항: 필요한 경우 레지스트리 자격 증명 파일의 위치를 지정합니다.
- 4
- 선택 사항: 대상 레지스트리에 대한 트러스트를 구성하지 않으려면
--insecure
플래그를 추가합니다. - 5
- 선택 사항: 여러 변형이 있을 때 선택할 수 있는 인덱스 이미지의 플랫폼 및 아키텍처를 지정합니다. 이미지는
'<platform>/<arch>[/<variant>]'
로 지정됩니다. 이는 인덱스에서 참조하는 이미지에는 적용되지 않습니다. 유효한 값은linux/amd64
,linux/ppc64le
,linux/s390x
,linux/arm64
,.*
입니다.
출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 명령은 현재 디렉터리에
v2/
디렉터리를 생성합니다.-
v2/
디렉터리를 이동식 미디어에 복사합니다. - 물리적으로 미디어를 제거하고 연결이 끊긴 환경의 호스트에 연결하여 미러 레지스트리에 액세스할 수 있습니다.
미러 레지스트리에 인증이 필요한 경우 연결이 끊긴 환경의 호스트에서 다음 명령을 실행하여 레지스트리에 로그인합니다.
podman login <mirror_registry>
$ podman login <mirror_registry>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow v2/
디렉터리가 포함된 상위 디렉터리에서 다음 명령을 실행하여 로컬 파일에서 미러 레지스트리로 이미지를 업로드합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 이전 명령 출력의
file://
경로를 지정합니다. - 2
- 대상 레지스트리가 운영자 콘텐츠를 미러링할 정규화된 도메인 이름(FQDN)을 지정합니다. 미러 레지스트리
<저장소>
는 레지스트리에 있는 기존 저장소나 네임스페이스일 수 있습니다(예: 필수 구성 요소에 설명된 대로olm-mirror)
. 미러링 중에 기존 저장소가 발견되면 저장소 이름이 결과 이미지 이름에 추가됩니다. 이미지 이름에 리포지토리 이름을 포함하지 않으려면 이 행에서<repository>
값을 생략합니다. (예:<mirror_registry>:<port>
) - 3
- 선택 사항: 필요한 경우 레지스트리 자격 증명 파일의 위치를 지정합니다.
- 4
- 선택 사항: 대상 레지스트리에 대한 트러스트를 구성하지 않으려면
--insecure
플래그를 추가합니다. - 5
- 선택 사항: 여러 변형이 있을 때 선택할 수 있는 인덱스 이미지의 플랫폼 및 아키텍처를 지정합니다. 이미지는
'<platform>/<arch>[/<variant>]'
로 지정됩니다. 이는 인덱스에서 참조하는 이미지에는 적용되지 않습니다. 유효한 값은linux/amd64
,linux/ppc64le
,linux/s390x
,linux/arm64
,.*
입니다.
참고Red Hat Quay는 중첩된 저장소를 지원하지 않습니다. 결과적으로
oc adm catalog mirror
명령을 실행하면401
무단 오류와 함께 실패합니다. 이 문제를 해결하려면oc adm catalog mirror
명령을 실행하여 중첩된 리포지토리 생성을 비활성화할 때--max-components=2
옵션을 사용할 수 있습니다. 이 해결 방법에 대한 자세한 내용은 Quay 레지스트리 지식베이스 솔루션에서 catalog mirror 명령을 사용하는 동안 발생하는 무단 오류를 참조하십시오.oc adm catalog mirror
명령을 다시 실행합니다. 새로 미러링된 인덱스 이미지를 소스로 사용하고 이전 단계에서 사용한 것과 동일한 미러 레지스트리 대상을 사용합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 이 단계에서는 명령이 미러링된 모든 콘텐츠를 다시 복사하지 않도록
--manifests-only
플래그가 필요합니다.
중요이전 단계에서 생성된
imageContentSourcePolicy.yaml
파일의 이미지 매핑은 로컬 경로에서 유효한 미러 위치로 업데이트해야 하므로 이 단계가 필요합니다. 이렇게 하지 않으면 이후 단계에서ImageContentSourcePolicy
개체를 생성할 때 오류가 발생합니다.
카탈로그를 미러링한 후 나머지 클러스터 설치를 계속할 수 있습니다. 클러스터 설치가 성공적으로 완료되면 ImageContentSourcePolicy
및 CatalogSource
오브젝트를 생성하려면 이 절차의 매니페스트 디렉터리를 지정해야 합니다. 이러한 오브젝트는 OperatorHub에서 Operator를 설치하는 데 필요합니다.
3.6.7.3. 생성된 매니페스트 링크 복사링크가 클립보드에 복사되었습니다!
Operator 카탈로그 콘텐츠를 미러 레지스트리에 미러링하면 현재 디렉터리에 매니페스트 디렉터리가 생성됩니다.
동일한 네트워크의 레지스트리에 콘텐츠를 미러링한 경우 디렉터리 이름은 다음 패턴을 사용합니다.
manifests-<index_image_name>-<random_number>
manifests-<index_image_name>-<random_number>
이전 섹션에서 연결이 끊긴 호스트의 레지스트리에 콘텐츠를 미러링한 경우 디렉터리 이름은 다음 패턴을 사용합니다.
manifests-index/<repository>/<index_image_name>-<random_number>
manifests-index/<repository>/<index_image_name>-<random_number>
매니페스트 디렉터리 이름은 후속 절차에서 참조됩니다.
매니페스트 디렉터리에는 다음 파일이 포함되어 있으며, 이 중 일부는 추가 수정이 필요할 수 있습니다.
catalogSource.yaml
파일은 인덱스 이미지 태그 및 기타 관련 메타데이터로 미리 채워진CatalogSource
오브젝트에 대한 기본 정의입니다. 이 파일은 있는 그대로 사용하거나 카탈로그 소스를 클러스터에 추가하도록 수정할 수 있습니다.중요콘텐츠를 로컬 파일에 미러링한 경우
metadata.name
필드에서 .name 필드에서 백슬래시(/
) 문자를 제거하려면catalogSource.yaml
파일을 수정해야 합니다. 그러지 않으면 오브젝트 생성을 시도할 때 "잘못된 리소스 이름" 오류로 인해 실패합니다.imageContentSourcePolicy.yaml
파일은 Operator 매니페스트에 저장된 이미지 참조와 미러링된 레지스트리 간에 변환하도록 노드를 구성할 수 있는ImageContentSourcePolicy
오브젝트를 정의합니다.참고클러스터에서
ImageContentSourcePolicy
오브젝트를 사용하여 저장소 미러링을 구성하는 경우 미러링된 레지스트리에 대한 글로벌 풀 시크릿만 사용할 수 있습니다. 프로젝트에 풀 시크릿을 추가할 수 없습니다.mapping.txt
파일에는 모든 소스 이미지와 대상 레지스트리에서 매핑할 위치가 포함되어 있습니다. 이 파일은oc image mirror
명령과 호환되며 미러링 구성을 추가로 사용자 정의하는 데 사용할 수 있습니다.중요미러링 프로세스 중
--manifests-only
플래그를 사용한 후 미러링할 패키지의 서브 세트를 추가로 트리밍하려면mapping.txt
파일을 수정하고oc image mirror
명령으로 파일을 사용하는 데 대한 OpenShift Container Platform 4.7 설명서의 패키지 매니페스트 형식 카탈로그 이미지 미러링 절차에 있는 단계를 참조하십시오.
3.6.7.4. 설치 후 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
카탈로그를 미러링한 후 나머지 클러스터 설치를 계속할 수 있습니다. 클러스터 설치가 성공적으로 완료되면 ImageContentSourcePolicy
및 CatalogSource
오브젝트를 생성하려면 이 절차의 매니페스트 디렉터리를 지정해야 합니다. 이러한 오브젝트는 OperatorHub에서 Operator를 채우고 설치하는 데 필요합니다.
3.6.8. 다음 단계 링크 복사링크가 클립보드에 복사되었습니다!
- VMware vSphere , 베어 메탈 또는 Amazon Web Services 와 같이 제한된 네트워크에서 프로비저닝하는 인프라에 클러스터를 설치합니다.
4장. 연결이 끊긴 환경에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
요구 사항에 가장 적합한 설치 방법과 인프라를 선택하여 연결이 끊긴 환경에 OpenShift Container Platform 클러스터를 설치할 수 있습니다. 여기에는 온프레미스 하드웨어나 Amazon Web Services(AWS)와 같은 클라우드 호스팅 서비스에 OpenShift Container Platform을 설치하는 것이 포함됩니다.
다음 섹션에서는 연결이 끊긴 환경에 클러스터를 설치하는 데 지원되는 모든 방법을 간략하게 설명합니다.
특정 방법을 사용하여 클러스터를 설치하는 데 필요한 기타 요구 사항에 대해 알아보려면 해당 설명서의 해당 섹션에 있는 다른 내용을 검토하세요.
예를 들어, 설치 프로그램 제공 인프라를 사용하여 AWS에 클러스터를 설치하려는 경우 AWS 계정 구성 및 AWS에 클러스터 설치 준비를 참조하세요.
4.1. 에이전트 기반 설치 프로그램을 사용하여 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
에이전트 기반 설치 프로그램을 사용하여 연결이 끊긴 환경에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 페이지를 참조하세요.
4.2. Amazon Web Services에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 Amazon Web Services(AWS)에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
- 설치 프로그램 제공 인프라: 제한된 네트워크에서 AWS에 클러스터 설치
- 사용자 프로비저닝 인프라: 사용자 프로비저닝 인프라를 사용하여 제한된 네트워크에서 AWS에 클러스터 설치
4.3. Microsoft Azure에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 Microsoft Azure에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
- 설치 프로그램 제공 인프라: 제한된 네트워크에서 Azure에 클러스터 설치
- 사용자 프로비저닝 인프라: 사용자 프로비저닝 인프라를 사용하여 제한된 네트워크에서 Azure에 클러스터 설치
4.4. Google Cloud Platform에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 Google Cloud Platform(GCP)에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
- 설치 프로그램 제공 인프라: 제한된 네트워크에서 GCP에 클러스터 설치
- 사용자 제공 인프라: 사용자 제공 인프라를 사용하여 제한된 네트워크의 GCP에 클러스터 설치
4.5. IBM Cloud에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 IBM Cloud®에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
4.6. Nutanix에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 Nutanix에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
4.7. 베어 메탈 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에 베어 메탈 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
4.8. IBM Z(R) 또는 IBM(R) LinuxONE에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 IBM Z® 또는 IBM® LinuxONE에 클러스터를 설치하는 방법에 대해 자세히 알아보려면 다음 절차를 참조하세요.
4.9. IBM Power에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 IBM Power에 클러스터를 설치하는 방법에 대한 자세한 내용은 다음 절차를 참조하십시오.
4.10. OpenStack의 클러스터 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경의 RHOSP(Red Hat OpenStack Platform)에 클러스터를 설치하는 방법에 대한 자세한 내용은 다음 절차를 참조하십시오.
4.11. vSphere에 클러스터 설치 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 VMware vSphere에 클러스터를 설치하는 방법에 대한 자세한 내용은 다음 절차를 참조하십시오.
- 설치 관리자 프로비저닝 인프라: 제한된 네트워크의 vSphere에 클러스터 설치
- 사용자 프로비저닝 인프라: 사용자 프로비저닝 인프라가 있는 제한된 네트워크에서 vSphere에 클러스터 설치
5장. 연결이 끊긴 환경에서 Operator Lifecycle Manager 사용 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경의 OpenShift Container Platform 클러스터의 경우 OLM(Operator Lifecycle Manager)은 기본적으로 원격 레지스트리에서 호스팅되는 Red Hat 제공 OperatorHub 소스에 액세스할 수 없습니다. 이러한 원격 소스에는 완전한 인터넷 연결이 필요하기 때문입니다.
그러나 클러스터 관리자는 워크스테이션에 완전한 인터넷 액세스 권한이 있는 경우 연결이 끊긴 환경에서 OLM을 사용하도록 클러스터를 활성화할 수 있습니다. 원격 OperatorHub 콘텐츠를 가져오는 데 완전한 인터넷 액세스 권한이 필요한 워크스테이션은 원격 소스의 로컬 미러를 준비하고 콘텐츠를 미러 레지스트리로 내보내는 데 사용됩니다.
미러 레지스트리는 워크스테이션 및 연결이 끊긴 클러스터 모두에 연결해야 하는 베스천 호스트에 있거나 미러링된 콘텐츠를 연결이 끊긴 환경에 물리적으로 이동하기 위해 이동식 미디어가 필요한 완전히 연결이 끊긴 호스트 또는 에어갭(Airgap) 호스트에 있을 수 있습니다.
이 가이드에서는 연결이 끊긴 환경에서 OLM을 활성화하는 데 필요한 다음 프로세스를 설명합니다.
- OLM의 기본 원격 OperatorHub 소스를 비활성화합니다.
- 완전한 인터넷 액세스가 가능한 워크스테이션을 사용하여 OperatorHub 콘텐츠의 로컬 미러를 생성하고 미러 레지스트리로 내보냅니다.
- 기본 원격 소스가 아닌 미러 레지스트리의 로컬 소스에서 Operator를 설치하고 관리하도록 OLM을 구성합니다.
제한된 네트워크에서 OLM을 활성화한 후에는 제한되지 않은 워크스테이션을 계속 사용하여 최신 버전의 Operator가 출시될 때 로컬 OperatorHub 소스를 업데이트할 수 있습니다.
OLM은 로컬 소스에서 Operator를 관리할 수 있지만 지정된 Operator가 연결이 끊긴 환경에서 성공적으로 실행되는 기능은 다음 기준을 충족하는 Operator 자체에 따라 다릅니다.
-
Operator에서 기능을 수행하는 데 필요할 수 있는 관련 이미지 또는 기타 컨테이너 이미지를 CSV(
ClusterServiceVersion
) 오브젝트의relatedImages
매개변수에 나열합니다. - 태그가 아닌 다이제스트(SHA)를 통해 지정된 모든 이미지를 참조합니다.
Red Hat Ecosystem Catalog 에서 다음 항목을 필터링하여 연결이 끊긴 모드에서 실행을 지원하는 Red Hat Operator 목록을 검색할 수 있습니다.
유형 | 컨테이너화된 애플리케이션 |
배포 방법 | Operator |
인프라 기능 | 연결 끊김 |
5.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
-
cluster-admin
권한이 있는 사용자로 OpenShift Container Platform 클러스터에 로그인합니다. - IBM Z®의 연결이 끊긴 환경에서 OLM을 사용하는 경우 레지스트리를 배치하는 디렉터리에 12GB 이상을 할당해야 합니다.
5.2. 기본 OperatorHub 카탈로그 소스 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat 및 커뮤니티 프로젝트에서 제공하는 콘텐츠를 소싱하는 Operator 카탈로그는 OpenShift Container Platform을 설치하는 동안 기본적으로 OperatorHub용으로 구성됩니다. 제한된 네트워크 환경에서는 클러스터 관리자로서 기본 카탈로그를 비활성화해야 합니다. 그런 다음 로컬 카탈로그 소스를 사용하도록 OperatorHub를 구성할 수 있습니다.
프로세스
OperatorHub
오브젝트에disableAllDefaultSources: true
를 추가하여 기본 카탈로그의 소스를 비활성화합니다.oc patch OperatorHub cluster --type json \ -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": true}]'
$ oc patch OperatorHub cluster --type json \ -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": true}]'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
또는 웹 콘솔을 사용하여 카탈로그 소스를 관리할 수 있습니다. 관리 → 클러스터 설정 → 구성 → OperatorHub 페이지에서 소스 탭을 클릭하면 개별 소스를 생성, 업데이트, 삭제, 비활성화 및 활성화할 수 있습니다.
5.3. Operator 카탈로그 미러링 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 클러스터에서 사용할 Operator 카탈로그 미러링에 대한 지침은 연결이 끊긴 클러스터에서 사용할 Operator 카탈로그 미러링을 참조하세요.
OpenShift Container Platform 4.11부터 Red Hat에서 제공하는 기본 Operator 카탈로그는 파일 기반 카탈로그 형식으로 릴리스됩니다. OpenShift Container Platform 4.6~4.10에 대한 기본 Red Hat 제공 Operator 카탈로그는 더 이상 사용되지 않는 SQLite 데이터베이스 형식으로 출시되었습니다.
SQLite 데이터베이스 형식과 관련된 opm
하위 명령, 플래그 및 기능은 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 이 기능은 계속 지원되며 더 이상 사용되지 않는 SQLite 데이터베이스 형식을 사용하는 카탈로그에 사용해야 합니다.
opm index prune
와 같은 SQLite 데이터베이스 형식을 사용하기 위한 opm
하위 명령 및 플래그는 파일 기반 카탈로그 형식에서는 작동하지 않습니다. 파일 기반 카탈로그 작업에 대한 자세한 내용은 Operator Framework 패키징 형식 , 사용자 정의 카탈로그 관리 및 oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치에 대한 이미지 미러링을 참조하세요.
5.4. 클러스터에 카탈로그 소스 추가 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 클러스터에 카탈로그 소스를 추가하면 사용자를 위한 Operator를 검색하고 설치할 수 있습니다. 클러스터 관리자는 인덱스 이미지를 참조하는 CatalogSource
오브젝트를 생성할 수 있습니다. OperatorHub는 카탈로그 소스를 사용하여 사용자 인터페이스를 채웁니다.
또는 웹 콘솔을 사용하여 카탈로그 소스를 관리할 수 있습니다. 관리 → 클러스터 설정 → 구성 → OperatorHub 페이지에서 소스 탭을 클릭하면 개별 소스를 생성, 업데이트, 삭제, 비활성화 및 활성화할 수 있습니다.
사전 요구 사항
- 인덱스 이미지를 빌드하여 레지스트리에 푸시했습니다.
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
프로세스
인덱스 이미지를 참조하는
CatalogSource
오브젝트를 생성합니다.oc adm catalog mirror
명령을 사용하여 카탈로그를 대상 레지스트리에 미러링한 경우 매니페스트 디렉터리에서 생성된catalogSource.yaml
파일을 시작점으로 사용할 수 있습니다.다음을 사양에 맞게 수정하고
catalogsource.yaml
파일로 저장합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 레지스트리에 업로드하기 전에 콘텐츠를 로컬 파일에 미러링한 경우 오브젝트를 생성할 때 "잘못된 리소스 이름" 오류가 발생하지 않도록
metadata.name
필드에서 백슬래시(/
) 문자를 제거합니다. - 2
- 카탈로그 소스를 모든 네임스페이스의 사용자가 전역적으로 사용할 수 있도록 하려면
openshift-marketplace
네임스페이스를 지정합니다. 그러지 않으면 카탈로그의 범위가 지정되고 해당 네임스페이스에 대해서만 사용할 수 있도록 다른 네임스페이스를 지정할 수 있습니다. - 3
legacy
또는restricted
의 값을 지정합니다. 필드가 설정되지 않으면 기본값은legacy
입니다. 향후 OpenShift Container Platform 릴리스에서는 기본값이제한
될 예정입니다. 카탈로그를제한된
권한으로 실행할 수 없는 경우 이 필드를 수동으로레거시
로 설정하는 것이 좋습니다.- 4
- 인덱스 이미지를 지정합니다. 이미지 이름 뒤에 태그를 지정하면(예
: :v4.19)
, 카탈로그 소스 포드는Always
이미지 풀 정책을 사용합니다. 즉, 포드가 항상 컨테이너를 시작하기 전에 이미지를 풀링합니다. 예를 들어@sha256:<id>
와 같이 다이제스트를 지정하면 이미지 풀 정책은IfNotPresent 가
됩니다. 즉, 포드는 노드에 이미지가 아직 없는 경우에만 이미지를 풀합니다. - 5
- 카탈로그를 게시하는 이름 또는 조직 이름을 지정합니다.
- 6
- 카탈로그 소스는 새 버전을 자동으로 확인하여 최신 상태를 유지할 수 있습니다.
파일을 사용하여
CatalogSource
오브젝트를 생성합니다.oc apply -f catalogSource.yaml
$ oc apply -f catalogSource.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
다음 리소스가 성공적으로 생성되었는지 확인합니다.
Pod를 확인합니다.
oc get pods -n openshift-marketplace
$ oc get pods -n openshift-marketplace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME READY STATUS RESTARTS AGE my-operator-catalog-6njx6 1/1 Running 0 28s marketplace-operator-d9f549946-96sgr 1/1 Running 0 26h
NAME READY STATUS RESTARTS AGE my-operator-catalog-6njx6 1/1 Running 0 28s marketplace-operator-d9f549946-96sgr 1/1 Running 0 26h
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 카탈로그 소스를 확인합니다.
oc get catalogsource -n openshift-marketplace
$ oc get catalogsource -n openshift-marketplace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME DISPLAY TYPE PUBLISHER AGE my-operator-catalog My Operator Catalog grpc 5s
NAME DISPLAY TYPE PUBLISHER AGE my-operator-catalog My Operator Catalog grpc 5s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 패키지 매니페스트 확인합니다.
oc get packagemanifest -n openshift-marketplace
$ oc get packagemanifest -n openshift-marketplace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME CATALOG AGE jaeger-product My Operator Catalog 93s
NAME CATALOG AGE jaeger-product My Operator Catalog 93s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
이제 OpenShift Container Platform 웹 콘솔의 OperatorHub 페이지에서 Operator를 설치할 수 있습니다.
5.5. 다음 단계 링크 복사링크가 클립보드에 복사되었습니다!
6장. 연결이 끊긴 환경에서 클러스터 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
6.1. 연결이 끊긴 환경의 클러스터 업데이트 정보 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경은 클러스터 노드가 인터넷에 액세스할 수 없거나 정책이나 성능 목적으로 업데이트 권장 사항을 관리하고 이미지를 로컬로 릴리스하려는 환경입니다. 이 섹션에서는 OpenShift Container Platform 이미지 미러링, OpenShift 업데이트 서비스 관리, 연결이 끊긴 환경에서 클러스터 업데이트 수행에 대한 내용을 다룹니다.
6.1.1. OpenShift 컨테이너 플랫폼 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 클러스터를 업데이트하려면 클러스터 환경이 대상 업데이트에 필요한 이미지와 리소스가 있는 미러 레지스트리에 액세스할 수 있어야 합니다. 단일 컨테이너 이미지 레지스트리는 연결이 끊긴 네트워크에서 여러 클러스터의 미러링된 이미지를 호스팅하는 데 충분합니다. 다음 페이지에는 연결이 끊긴 클러스터의 저장소에 이미지를 미러링하는 방법에 대한 지침이 있습니다.
6.1.2. 연결이 끊긴 환경에서 클러스터 업데이트 수행 링크 복사링크가 클립보드에 복사되었습니다!
다음 절차 중 하나를 사용하여 연결이 끊긴 OpenShift Container Platform 클러스터를 업데이트할 수 있습니다.
6.1.3. 클러스터에서 OpenShift 업데이트 서비스 제거 링크 복사링크가 클립보드에 복사되었습니다!
다음 절차를 사용하여 클러스터에서 OpenShift Update Service(OSUS)의 로컬 복사본을 제거할 수 있습니다.
6.2. OpenShift 컨테이너 플랫폼 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
연결이 끊긴 환경에서 클러스터를 업데이트하려면 먼저 컨테이너 이미지를 미러 레지스트리에 미러링해야 합니다. 연결된 환경에서도 이 절차를 사용하면 클러스터가 외부 콘텐츠에 대한 조직적 통제를 충족하는 승인된 컨테이너 이미지만 실행하도록 할 수 있습니다.
클러스터가 실행되는 동안에는 미러 레지스트리가 항상 실행되어야 합니다.
다음 단계에서는 미러 레지스트리에 이미지를 미러링하는 방법에 대한 개략적인 워크플로를 설명합니다.
-
릴리스 이미지를 검색하고 푸시하는 데 사용되는 모든 장치에 OpenShift CLI(
oc
)를 설치합니다. - 레지스트리 풀 시크릿을 다운로드하여 클러스터에 추가합니다.
oc-mirror OpenShift CLI(
oc
) 플러그인을 사용하는 경우:- 이미지를 검색하고 푸시 릴리스하는 데 사용되는 모든 장치에 oc-mirror 플러그인을 설치합니다.
- 플러그인이 미러링할 릴리스 이미지를 결정할 때 사용할 이미지 세트 구성 파일을 만듭니다. 나중에 이 구성 파일을 편집하여 플러그인이 미러링하는 릴리스 이미지를 변경할 수 있습니다.
- 대상 릴리스 이미지를 미러 레지스트리에 직접 미러링하거나 이동식 미디어에 미러링한 다음 미러 레지스트리에 미러링합니다.
- oc-mirror 플러그인에서 생성된 리소스를 사용하도록 클러스터를 구성합니다.
- 필요에 따라 이 단계를 반복하여 미러 레지스트리를 업데이트합니다.
oc adm release mirror
명령을 사용하는 경우:- 사용자 환경과 미러링하려는 릴리스 이미지에 맞는 환경 변수를 설정합니다.
- 대상 릴리스 이미지를 미러 레지스트리에 직접 미러링하거나 이동식 미디어에 미러링한 다음 미러 레지스트리에 미러링합니다.
- 필요에 따라 이 단계를 반복하여 미러 레지스트리를 업데이트합니다.
oc adm release mirror
명령을 사용하는 것과 비교했을 때, oc-mirror 플러그인은 다음과 같은 장점이 있습니다.
- 컨테이너 이미지 이외의 콘텐츠를 미러링할 수 있습니다.
- 처음으로 이미지를 미러링한 후에는 레지스트리에서 이미지를 업데이트하는 것이 더 쉽습니다.
- oc-mirror 플러그인은 Quay에서 릴리스 페이로드를 자동으로 미러링하는 방법을 제공하고, 연결이 끊긴 환경에서 실행되는 OpenShift 업데이트 서비스에 대한 최신 그래프 데이터 이미지를 빌드합니다.
6.2.1. oc-mirror 플러그인을 사용하여 리소스 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc-mirror OpenShift CLI( oc
) 플러그인을 사용하면 완전히 또는 부분적으로 연결이 끊긴 환경에서 미러 레지스트리로 이미지를 미러링할 수 있습니다. 공식 Red Hat 레지스트리에서 필요한 이미지를 다운로드하려면 인터넷에 연결된 시스템에서 oc-mirror를 실행해야 합니다.
자세한 내용은 oc-mirror 플러그인 v2를 사용하여 연결이 끊긴 설치에 대한 이미지 미러링을 참조하세요.
6.2.2. oc adm release mirror 명령을 사용하여 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
oc adm release mirror
명령을 사용하면 이미지를 미러 레지스트리로 미러링할 수 있습니다.
6.2.2.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat Quay와 같이 OpenShift Container Platform 클러스터를 호스팅할 위치에 Docker v2-2를 지원하는 컨테이너 이미지 레지스트리가 있어야 합니다.
참고Red Hat Quay를 사용하는 경우 oc-mirror 플러그인과 함께 버전 3.6 이상을 사용해야 합니다. Red Hat Quay에 대한 권한이 있는 경우 개념 증명 목적으로 Red Hat Quay를 배포하거나 Quay Operator를 사용하는 방법 에 대한 설명서를 참조하세요. 레지스트리를 선택 및 설치하는 데 추가 지원이 필요한 경우 영업 담당자 또는 Red Hat 지원팀에 문의하십시오.
컨테이너 이미지 레지스트리에 대한 기존 솔루션이 없는 경우 Red Hat OpenShift용 미러 레지스트리가 OpenShift Container Platform 구독에 포함되어 있습니다. Red Hat OpenShift용 미러 레지스트리는 연결이 끊긴 설치 및 업데이트에서 OpenShift Container Platform 컨테이너 이미지를 미러링하는 데 사용할 수 있는 소규모 컨테이너 레지스트리입니다.
6.2.2.2. 미러 호스트 준비 링크 복사링크가 클립보드에 복사되었습니다!
미러 단계를 수행하기 전에 호스트는 콘텐츠를 검색하고 원격 위치로 푸시할 준비가 되어 있어야 합니다.
6.2.2.2.1. OpenShift CLI 설치 링크 복사링크가 클립보드에 복사되었습니다!
명령줄 인터페이스를 사용하여 OpenShift Container Platform과 상호 작용하기 위해 OpenShift CLI(oc
)를 설치할 수 있습니다. Linux, Windows 또는 macOS에 oc
를 설치할 수 있습니다.
이전 버전의 oc
를 설치한 경우 OpenShift Container Platform 4.19에서 모든 명령을 완료하는 데 사용할 수 없습니다. 새 버전의 oc
를 다운로드하여 설치합니다. 연결이 끊긴 환경에서 클러스터를 업데이트하는 경우 업데이트할 oc
버전을 설치하세요.
Linux에서 OpenShift CLI 설치
다음 절차를 사용하여 Linux에서 OpenShift CLI(oc
) 바이너리를 설치할 수 있습니다.
프로세스
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 제품 변형 드롭다운 목록에서 아키텍처를 선택합니다.
- 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
- OpenShift v4.19 Linux 클라이언트 항목 옆에 있는 '지금 다운로드'를 클릭하고 파일을 저장합니다.
아카이브의 압축을 풉니다.
tar xvf <file>
$ tar xvf <file>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc
바이너리를PATH
에 있는 디렉터리에 배치합니다.PATH
를 확인하려면 다음 명령을 실행합니다.echo $PATH
$ echo $PATH
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
OpenShift CLI를 설치한 후
oc
명령을 사용할 수 있습니다.oc <command>
$ oc <command>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Windows에서 OpenSfhit CLI 설치
다음 절차에 따라 Windows에 OpenShift CLI(oc
) 바이너리를 설치할 수 있습니다.
프로세스
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
- OpenShift v4.19 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
- ZIP 프로그램으로 아카이브의 압축을 풉니다.
oc
바이너리를PATH
에 있는 디렉터리로 이동합니다.PATH
를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.path
C:\> path
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
OpenShift CLI를 설치한 후
oc
명령을 사용할 수 있습니다.oc <command>
C:\> oc <command>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
macOS에 OpenShift CLI 설치
다음 절차에 따라 macOS에서 OpenShift CLI(oc
) 바이너리를 설치할 수 있습니다.
프로세스
- Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
- 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
OpenShift v4.19 macOS 클라이언트 항목 옆에 있는 '지금 다운로드'를 클릭하고 파일을 저장합니다.
참고macOS arm64의 경우 OpenShift v4.19 macOS arm64 클라이언트 항목을 선택합니다.
- 아카이브의 압축을 해제하고 압축을 풉니다.
oc
바이너리 PATH의 디렉터리로 이동합니다.PATH
를 확인하려면 터미널을 열고 다음 명령을 실행합니다.echo $PATH
$ echo $PATH
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
oc
명령을 사용하여 설치를 확인하세요.oc <command>
$ oc <command>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.2.2.2. 이미지를 미러링할 수 있는 인증 정보 설정 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat에서 미러로 이미지를 미러링할 수 있는 컨테이너 이미지 레지스트리 자격 증명 파일을 만듭니다.
클러스터를 설치할 때 이 이미지 레지스트리 인증 정보 파일을 풀 시크릿(pull secret)으로 사용하지 마십시오. 클러스터를 설치할 때 이 파일을 지정하면 클러스터의 모든 시스템에 미러 레지스트리에 대한 쓰기 권한이 부여됩니다.
사전 요구 사항
- 연결이 끊긴 환경에서 사용할 미러 레지스트리를 구성했습니다.
- 미러 레지스트리에서 이미지를 미러링할 이미지 저장소 위치를 확인했습니다.
- 이미지를 해당 이미지 저장소에 업로드할 수 있는 미러 레지스트리 계정을 제공하고 있습니다.
- 미러 레지스트리에 대한 쓰기 권한이 있습니다.
프로세스
설치 호스트에서 다음 단계를 수행합니다.
-
Red Hat OpenShift Cluster Manager에서
registry.redhat.io
풀 시크릿을 다운로드합니다. 다음 명령을 실행하여 JSON 형식으로 풀 시크릿의 사본을 만듭니다.
cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
$ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 풀 시크릿을 저장할 폴더의 경로와 생성한 JSON 파일의 이름을 지정합니다.
pull secret의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 선택 사항: oc-mirror 플러그인을 사용하는 경우 파일을
~/.docker/config.json
또는$XDG_RUNTIME_DIR/containers/auth.json
으로 저장합니다..docker
또는$XDG_RUNTIME_DIR/containers
디렉터리가 없는 경우 다음 명령을 입력하여 만듭니다.mkdir -p <directory_name>
$ mkdir -p <directory_name>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 여기서
<directory_name>
은~/.docker
또는$XDG_RUNTIME_DIR/containers
입니다.다음 명령을 입력하여 풀 시크릿을 적절한 디렉터리에 복사합니다.
cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>
$ cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 여기서
<directory_name>
은~/.docker
또는$XDG_RUNTIME_DIR/containers
이며<auth_file>
은config.json
또는auth.json
입니다.
다음 명령을 실행하여 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름과 비밀번호 또는 토큰을 생성합니다.
echo -n '<user_name>:<password>' | base64 -w0
$ echo -n '<user_name>:<password>' | base64 -w0
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
<user_name>
및<password>
의 경우 레지스트리에 설정한 사용자 이름 및 암호를 지정합니다.
출력 예
BGVtbYk3ZHAtqXs=
BGVtbYk3ZHAtqXs=
Copy to Clipboard Copied! Toggle word wrap Toggle overflow JSON 파일을 편집하고 레지스트리를 설명하는 섹션을 추가합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 수정된 풀 시크릿 예시
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.2.2.3. 미러 레지스트리에 이미지 미러링 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift 업데이트 서비스 애플리케이션에서 과도한 메모리 사용을 방지하려면 다음 절차에 설명된 대로 릴리스 이미지를 별도의 저장소로 미러링해야 합니다.
사전 요구 사항
- 연결이 끊긴 환경에서 사용할 미러 레지스트리를 구성했으며 구성한 인증서와 자격 증명에 액세스할 수 있습니다.
- Red Hat OpenShift Cluster Manager에서 풀 시크릿을 다운로드하고 미러 저장소에 대한 인증을 포함하도록 수정했습니다.
- 자체 서명된 인증서를 사용하는 경우 인증서에 주체 대체 이름을 지정했습니다.
프로세스
- Red Hat OpenShift Container Platform 업데이트 그래프 시각화 도구와 업데이트 플래너를 사용하여 한 버전에서 다른 버전으로의 업데이트를 계획합니다. OpenShift 업데이트 그래프는 채널 그래프를 제공하고 현재 클러스터 버전과 의도된 클러스터 버전 사이에 업데이트 경로가 있는지 확인하는 방법을 제공합니다.
필요한 환경 변수를 설정합니다.
릴리스 버전을 내보냅니다.
export OCP_RELEASE=<release_version>
$ export OCP_RELEASE=<release_version>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <release_version>
에 대해 업데이트할 OpenShift Container Platform 버전에 해당하는 태그를 지정합니다 (예:4.5.4
).로컬 레지스트리 이름 및 호스트 포트를 내보냅니다.
LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'
$ LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <local_registry_host_name>
의 경우 미러 저장소의 레지스트리 도메인 이름을 지정하고<local_registry_host_port>
의 경우 콘텐츠를 제공하는데 사용되는 포트를 지정합니다.로컬 저장소 이름을 내보냅니다.
LOCAL_REPOSITORY='<local_repository_name>'
$ LOCAL_REPOSITORY='<local_repository_name>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <local_repository_name>
의 경우 레지스트리에 작성할 저장소 이름 (예:ocp4/openshift4
)을 지정합니다.OpenShift 업데이트 서비스를 사용하는 경우 릴리스 이미지를 포함할 추가 로컬 저장소 이름을 내보냅니다.
LOCAL_RELEASE_IMAGES_REPOSITORY='<local_release_images_repository_name>'
$ LOCAL_RELEASE_IMAGES_REPOSITORY='<local_release_images_repository_name>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <local_release_images_repository_name>
의 경우 레지스트리에 작성할 저장소 이름 (예:ocp4/openshift4-release-images
)을 지정합니다.미러링할 저장소 이름을 내보냅니다.
PRODUCT_REPO='openshift-release-dev'
$ PRODUCT_REPO='openshift-release-dev'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 프로덕션 환경의 릴리스의 경우
openshift-release-dev
를 지정해야 합니다.레지스트리 풀 시크릿의 경로를 내보냅니다.
LOCAL_SECRET_JSON='<path_to_pull_secret>'
$ LOCAL_SECRET_JSON='<path_to_pull_secret>'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 생성한 미러 레지스트리에 대한 풀 시크릿의 절대 경로 및 파일 이름을
<path_to_pull_secret>
에 지정합니다.참고클러스터에서
ImageContentSourcePolicy
오브젝트를 사용하여 저장소 미러링을 구성하는 경우 미러링된 레지스트리에 대한 글로벌 풀 시크릿만 사용할 수 있습니다. 프로젝트에 풀 시크릿을 추가할 수 없습니다.릴리스 미러를 내보냅니다.
RELEASE_NAME="ocp-release"
$ RELEASE_NAME="ocp-release"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 프로덕션 환경의 릴리스의 경우
ocp-release
를 지정해야 합니다.클러스터의 아키텍처 유형을 내보냅니다.
ARCHITECTURE=<cluster_architecture>
$ ARCHITECTURE=<cluster_architecture>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
x86_64
,aarch64
,s390x
또는ppc64le
과 같은 클러스터의 아키텍처를 지정합니다.
미러링된 이미지를 호스트할 디렉터리의 경로를 내보냅니다.
REMOVABLE_MEDIA_PATH=<path>
$ REMOVABLE_MEDIA_PATH=<path>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 초기 슬래시 (/) 문자를 포함하여 전체 경로를 지정합니다.
미러링할 이미지 및 설정 매니페스트를 확인합니다.
oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} --dry-run
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} --dry-run
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 버전 이미지를 미러 레지스트리로 미러링합니다.
미러 호스트가 인터넷에 액세스할 수 없는 경우 다음 작업을 수행합니다.
- 이동식 미디어를 인터넷에 연결된 시스템에 연결합니다.
이미지 및 설정 매니페스트를 이동식 미디어의 디렉토리에 미러링합니다.
oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고이 명령은 또한 미러링된 릴리스 이미지 서명 구성 맵을 생성하여 이동식 미디어에 저장합니다.
미디어를 연결이 끊긴 환경으로 가져가서 이미지를 로컬 컨테이너 레지스트리에 업로드합니다.
oc image mirror -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}
$ oc image mirror -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
REMOVABLE_MEDIA_PATH
의 경우 이미지를 미러링 할 때 지정한 것과 동일한 경로를 사용해야 합니다.
-
oc
명령줄 인터페이스(CLI)를 사용하여 업데이트하려는 클러스터에 로그인합니다. 미러링된 릴리스 이미지 서명 config map을 연결된 클러스터에 적용합니다.
oc apply -f ${REMOVABLE_MEDIA_PATH}/mirror/config/<image_signature_file>
$ oc apply -f ${REMOVABLE_MEDIA_PATH}/mirror/config/<image_signature_file>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
<image_signature_file>
의 경우 파일의 경로와 이름을 지정합니다(예:signature-sha256-81154f5c03294534.yaml
).
OpenShift 업데이트 서비스를 사용하는 경우 릴리스 이미지를 별도의 저장소로 미러링합니다.
oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
$ oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
로컬 컨테이너 레지스트리와 클러스터가 미러 호스트에 연결된 경우 다음 작업을 수행하세요.
다음 명령을 사용하여 릴리스 이미지를 로컬 레지스트리에 직접 푸시하고 클러스터에 구성 맵을 적용합니다.
oc adm release mirror -a ${LOCAL_SECRET_JSON} --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} --apply-release-image-signature
$ oc adm release mirror -a ${LOCAL_SECRET_JSON} --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \ --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} --apply-release-image-signature
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고--apply-release-image-signature
옵션이 포함된 경우 이미지 서명 확인을 위해 config map을 작성하지 않습니다.OpenShift 업데이트 서비스를 사용하는 경우 릴리스 이미지를 별도의 저장소로 미러링합니다.
oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
$ oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.3. OpenShift Update Service를 사용하여 연결이 끊긴 환경에서 클러스터 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
연결된 클러스터와 유사한 업데이트 환경을 얻으려면 다음 절차를 사용하여 연결이 끊긴 환경에서 OpenShift 업데이트 서비스(OSUS)를 설치하고 구성하세요.
다음 단계에서는 OSUS를 사용하여 연결이 끊긴 환경에서 클러스터를 업데이트하는 방법에 대한 개략적인 워크플로를 설명합니다.
- 보안 레지스트리에 대한 액세스를 구성합니다.
- 미러 레지스트리에 액세스하려면 글로벌 클러스터 풀 시크릿을 업데이트하세요.
- OSUS Operator를 설치합니다.
- OpenShift 업데이트 서비스에 대한 그래프 데이터 컨테이너 이미지를 만듭니다.
- OSUS 애플리케이션을 설치하고 사용자 환경에서 OpenShift 업데이트 서비스를 사용하도록 클러스터를 구성합니다.
- 연결된 클러스터에서와 마찬가지로 설명서에서 지원되는 업데이트 절차를 수행합니다.
6.3.1. 연결이 끊긴 환경에서 OpenShift 업데이트 서비스 사용 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Update Service(OSUS)는 OpenShift Container Platform 클러스터에 대한 업데이트 권장 사항을 제공합니다. Red Hat은 OpenShift 업데이트 서비스를 공개적으로 호스팅하며, 연결된 환경의 클러스터는 공개 API를 통해 서비스에 연결하여 업데이트 권장 사항을 검색할 수 있습니다.
그러나 연결이 끊긴 환경의 클러스터는 이러한 공용 API에 액세스하여 업데이트 정보를 검색할 수 없습니다. 연결이 끊긴 환경에서도 비슷한 업데이트 환경을 제공하려면 OpenShift 업데이트 서비스를 설치하고 구성하여 연결이 끊긴 환경에서도 사용할 수 있도록 하면 됩니다.
단일 OSUS 인스턴스는 수천 개의 클러스터에 권장 사항을 제공할 수 있습니다. OSUS는 복제본 값을 변경하여 더 많은 클러스터를 수용하도록 수평적으로 확장될 수 있습니다. 따라서 대부분의 연결되지 않은 사용 사례에서는 OSUS 인스턴스 하나만 있으면 충분합니다. 예를 들어, Red Hat은 연결된 클러스터 전체에 대해 단 하나의 OSUS 인스턴스만 호스팅합니다.
서로 다른 환경에서 업데이트 권장 사항을 별도로 유지하려면 각 환경에 대해 하나의 OSUS 인스턴스를 실행하면 됩니다. 예를 들어, 테스트 및 스테이지 환경이 분리된 경우, 테스트 환경에서 아직 테스트되지 않은 버전 A에 대한 업데이트 권장 사항을 스테이지 환경의 클러스터가 받지 않도록 할 수 있습니다.
다음 섹션에서는 OSUS 인스턴스를 설치하고 클러스터에 업데이트 권장 사항을 제공하도록 구성하는 방법을 설명합니다.
6.3.2. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
-
oc
명령 줄 인터페이스 (CLI) 툴이 설치되어 있어야합니다. - OpenShift 컨테이너 플랫폼 이미지 미러링 에 설명된 대로 업데이트를 위한 컨테이너 이미지로 환경에 컨테이너 이미지 레지스트리를 프로비저닝해야 합니다.
6.3.3. OpenShift 업데이트 서비스에 대한 보안 레지스트리에 대한 액세스 구성 링크 복사링크가 클립보드에 복사되었습니다!
릴리스 이미지가 사용자 지정 인증 기관에서 서명한 HTTPS X.509 인증서가 있는 레지스트리에 포함되어 있는 경우, 업데이트 서비스에 대한 다음 변경 사항과 함께 이미지 레지스트리 액세스를 위한 추가 신뢰 저장소 구성 의 단계를 완료합니다.
OpenShift Update Service Operator는 레지스트리 CA 인증서에 구성 맵 키 이름 updateservice-registry
가 필요합니다.
업데이트 서비스에 대한 이미지 레지스트리 CA 구성 맵의 예
6.3.4. 글로벌 클러스터 풀 시크릿 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
현재 풀 시크릿을 교체하거나 새 풀 시크릿을 추가하여 클러스터의 글로벌 풀 시크릿을 업데이트할 수 있습니다.
이 절차는 사용자가 설치 중 사용된 레지스트리보다 이미지를 저장하기 위해 별도의 레지스트리를 사용하는 경우 필요합니다.
사전 요구 사항
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
프로세스
선택 사항: 기존 풀 시크릿에 새 풀 시크릿을 추가하려면 다음 단계를 완료합니다.
다음 명령을 입력하여 풀 시크릿을 다운로드합니다.
oc get secret/pull-secret -n openshift-config \ --template='{{index .data ".dockerconfigjson" | base64decode}}' \ ><pull_secret_location>
$ oc get secret/pull-secret -n openshift-config \ --template='{{index .data ".dockerconfigjson" | base64decode}}' \ ><pull_secret_location>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 풀 시크릿 파일에 경로를 제공합니다.
다음 명령을 입력하여 새 풀 시크릿을 추가합니다.
oc registry login --registry="<registry>" \ --auth-basic="<username>:<password>" \ --to=<pull_secret_location>
$ oc registry login --registry="<registry>" \
1 --auth-basic="<username>:<password>" \
2 --to=<pull_secret_location>
3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow 또는 가져오기 시크릿 파일에 대한 수동 업데이트를 수행할 수 있습니다.
다음 명령을 입력하여 클러스터의 글로벌 풀 시크릿을 업데이트합니다.
oc set data secret/pull-secret -n openshift-config \ --from-file=.dockerconfigjson=<pull_secret_location>
$ oc set data secret/pull-secret -n openshift-config \ --from-file=.dockerconfigjson=<pull_secret_location>
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 새 풀 시크릿 파일의 경로를 제공합니다.
이 업데이트는 모든 노드로 롤아웃되며 클러스터 크기에 따라 작업에 약간의 시간이 걸릴 수 있습니다.
참고OpenShift Container Platform 4.7.4부터 글로벌 풀 시크릿을 변경해도 더 이상 노드 드레이닝 또는 재부팅이 트리거되지 않습니다.
6.3.5. OpenShift Update Service Operator 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Update Service를 설치하려면 먼저 OpenShift Container Platform 웹 콘솔 또는 CLI를 사용하여 OpenShift Update Service Operator를 설치해야 합니다.
연결이 끊긴 환경에 설치된 클러스터(연결이 끊긴 클러스터라고도 함)의 경우, Operator Lifecycle Manager는 기본적으로 원격 레지스트리에 호스팅된 Red Hat 제공 OperatorHub 소스에 액세스할 수 없습니다. 해당 원격 소스에 전체 인터넷 연결이 필요하기 때문입니다. 자세한 내용은 연결이 끊긴 환경에서 Operator Lifecycle Manager 사용을 참조하세요.
6.3.5.1. 웹 콘솔을 사용하여 OpenShift Update Service Operator 설치 링크 복사링크가 클립보드에 복사되었습니다!
웹 콘솔을 사용하여 OpenShift Update Service Operator를 설치할 수 있습니다.
프로세스
웹 콘솔에서 Operator → OperatorHub를 클릭합니다.
참고Update Service
를 키워드로 필터링… 필드에 입력하여 Operator를 더 빠르게 찾습니다.사용 가능한 Operator 목록에서 OpenShift Update Service를 선택한 다음 설치를 클릭합니다.
- 업데이트 채널을 선택합니다.
- 버전을 선택하세요.
- 설치 모드에서 클러스터의 특정 네임스페이스를 선택합니다.
-
설치된 네임스페이스의 네임스페이스를 선택하거나 권장 네임스페이스
openshift-update-service
를 수락합니다. 업데이트 승인 전략을 선택하세요.
- 자동 전략을 사용하면 Operator 새 버전이 준비될 때 OLM(Operator Lifecycle Manager)이 자동으로 Operator를 업데이트할 수 있습니다.
- 수동 전략을 사용하려면 클러스터 관리자가 Operator 업데이트를 승인해야 합니다.
- 설치를 클릭합니다.
- 운영자 → 설치된 운영자 로 이동하여 OpenShift 업데이트 서비스 운영자가 설치되었는지 확인합니다.
- OpenShift Update Service 가 올바른 네임스페이스에 성공 상태로 나열되어 있는지 확인합니다.
6.3.5.2. CLI를 사용하여 OpenShift Update Service Operator 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift CLI(oc
)를 사용하여 OpenShift Update Service Operator를 설치할 수 있습니다.
프로세스
OpenShift OpenShift Update Service Operator의 네임스페이스를 생성합니다.
OpenShift Update Service Operator에 대해
Namespace
오브젝트 YAML 파일 (예:update-service-namespace.yaml
)을 만듭니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 이 네임스페이스에서 Operator가 권장하는 클러스터 모니터링을 사용하도록 하려면
openshift.io/cluster-monitoring
레이블을 설정합니다.
네임스페이스를 생성합니다.
oc create -f <filename>.yaml
$ oc create -f <filename>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예를 들면 다음과 같습니다.
oc create -f update-service-namespace.yaml
$ oc create -f update-service-namespace.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
다음 오브젝트를 생성하여 OpenShift Update Service Operator를 설치합니다.
OperatorGroup
오브젝트 YAML 파일을 만듭니다 (예:update-service-operator-group.yaml
).Copy to Clipboard Copied! Toggle word wrap Toggle overflow OperatorGroup
오브젝트를 생성합니다.oc -n openshift-update-service create -f <filename>.yaml
$ oc -n openshift-update-service create -f <filename>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예를 들면 다음과 같습니다.
oc -n openshift-update-service create -f update-service-operator-group.yaml
$ oc -n openshift-update-service create -f update-service-operator-group.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Subscription
오브젝트 YAML 파일(예:update-service-subscription.yaml
)을 생성합니다.서브스크립션의 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- Operator를 제공하는 카탈로그 소스의 이름을 지정합니다. 사용자 정의 OLM(Operator Lifecycle Manager)을 사용하지 않는 클러스터의 경우
redhat-operators
를 지정합니다. OpenShift Container Platform 클러스터가 연결이 끊긴 환경에 설치된 경우 Operator Lifecycle Manager(OLM)를 구성할 때 생성된CatalogSource
개체의 이름을 지정합니다.
Subscription
오브젝트를 생성합니다.oc create -f <filename>.yaml
$ oc create -f <filename>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 예를 들면 다음과 같습니다.
oc -n openshift-update-service create -f update-service-subscription.yaml
$ oc -n openshift-update-service create -f update-service-subscription.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service Operator는
openshift-update-service
네임스페이스에 설치되고openshift-update-service
네임스페이스를 대상으로 합니다.
Operator 설치를 확인합니다.
oc -n openshift-update-service get clusterserviceversions
$ oc -n openshift-update-service get clusterserviceversions
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME DISPLAY VERSION REPLACES PHASE update-service-operator.v4.6.0 OpenShift Update Service 4.6.0 Succeeded ...
NAME DISPLAY VERSION REPLACES PHASE update-service-operator.v4.6.0 OpenShift Update Service 4.6.0 Succeeded ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service Operator가 나열된 경우 설치에 성공한 것입니다. 버전 번호가 표시된 것과 다를 수 있습니다.
6.3.6. OpenShift Update Service 그래프 데이터 컨테이너 이미지 생성 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift 업데이트 서비스에는 그래프 데이터 컨테이너 이미지가 필요하며, OpenShift 업데이트 서비스는 이를 통해 채널 멤버십 및 차단된 업데이트 에지에 대한 정보를 검색합니다. 그래프 데이터는 일반적으로 업데이트 그래프 데이터 저장소에서 직접 가져옵니다. 인터넷 연결이 불가능한 환경에서 init 컨테이너에서 이 정보를 로드하는 것도 OpenShift 업데이트 서비스에서 그래프 데이터를 사용할 수 있도록 하는 또 다른 방법입니다. init 컨테이너의 역할은 그래프 데이터의 로컬 사본을 제공하는 것이며 pod 초기화 중에 init 컨테이너가 서비스에서 액세스할 수 있는 볼륨에 데이터를 복사하는 것입니다.
oc-mirror OpenShift CLI( oc
) 플러그인은 릴리스 이미지를 미러링하는 것 외에도 이 그래프 데이터 컨테이너 이미지를 생성합니다. oc-mirror 플러그인을 사용하여 릴리스 이미지를 미러링한 경우 이 절차를 건너뛸 수 있습니다.
프로세스
다음을 포함하는 Dockerfile(예:
./Dockerfile
)을 생성합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 위 단계에서 생성한 docker 파일을 사용하여 그래프 데이터 컨테이너 이미지를 빌드합니다(예:
registry.example.com/openshift/graph-data:latest
):podman build -f ./Dockerfile -t registry.example.com/openshift/graph-data:latest
$ podman build -f ./Dockerfile -t registry.example.com/openshift/graph-data:latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이전 단계에서 만든 그래프 데이터 컨테이너 이미지를 OpenShift 업데이트 서비스에서 액세스할 수 있는 저장소(예:
registry.example.com/openshift/graph-data:latest
)로 푸시합니다.podman push registry.example.com/openshift/graph-data:latest
$ podman push registry.example.com/openshift/graph-data:latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고연결이 끊긴 환경에서 레지스트리에 그래프 데이터 이미지를 푸시하려면 이전 단계에서 만든 그래프 데이터 컨테이너 이미지를 OpenShift 업데이트 서비스에서 액세스할 수 있는 저장소에 복사합니다. 사용 가능한 옵션을 보려면
oc image mirror --help를
실행하세요.
6.3.7. OpenShift Update Service 애플리케이션 생성 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔 또는 CLI를 사용하여 OpenShift Update Service 애플리케이션을 생성할 수 있습니다.
6.3.7.1. 웹 콘솔을 사용하여 OpenShift Update Service 애플리케이션 생성 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔을 사용하여 OpenShift Update Service Operator를 사용하여 OpenShift Update Service 애플리케이션을 생성할 수 있습니다.
사전 요구 사항
- OpenShift Update Service Operator가 설치되었습니다.
- OpenShift 업데이트 서비스 그래프 데이터 컨테이너 이미지가 생성되어 OpenShift 업데이트 서비스에서 액세스할 수 있는 저장소에 푸시되었습니다.
- 현재 릴리스와 업데이트 대상 릴리스는 연결이 끊긴 환경의 레지스트리에 미러링되었습니다.
프로세스
- 웹 콘솔에서 Operator → Installed Operator를 클릭합니다.
- 설치된 Operator 목록에서 OpenShift Update Service를 선택합니다.
- Update Service 탭을 클릭합니다.
- Create UpdateService를 클릭합니다.
-
Name 필드에 이름을 입력합니다. (예:
service
) -
"OpenShift 업데이트 서비스 그래프 데이터 컨테이너 이미지 만들기"에서 생성한 그래프 데이터 컨테이너 이미지(예:
registry.example.com/openshift/graph-data:latest
)에 로컬 풀스펙을 그래프 데이터 이미지 필드에 입력합니다. -
릴리스 필드에 "OpenShift Container Platform 이미지 리포지토리 미러링"의 릴리스 이미지를 포함하도록 생성된 레지스트리 및 리포지토리를 입력합니다(예:
registry.example.com/ocp4/openshift4-release-images
). -
Replicas 필드에
2
를 입력합니다. - Create를 클릭하여 OpenShift Update Service 애플리케이션을 생성합니다.
OpenShift Update Service 애플리케이션 확인
- Update Service 탭의 UpdateServices 목록에서 방금 만든 업데이트 서비스 애플리케이션을 클릭합니다.
- Resources 탭을 클릭합니다.
- 각 애플리케이션 리소스의 상태가 Created인지 확인합니다.
6.3.7.2. CLI를 사용하여 OpenShift Update Service 애플리케이션 생성 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift CLI(oc
)를 사용하여 OpenShift Update Service 애플리케이션을 생성할 수 있습니다.
사전 요구 사항
- OpenShift Update Service Operator가 설치되었습니다.
- OpenShift 업데이트 서비스 그래프 데이터 컨테이너 이미지가 생성되어 OpenShift 업데이트 서비스에서 액세스할 수 있는 저장소에 푸시되었습니다.
- 현재 릴리스와 업데이트 대상 릴리스는 연결이 끊긴 환경의 레지스트리에 미러링되었습니다.
프로세스
OpenShift Update Service 대상 네임스페이스를 구성합니다(예:
openshift-update-service
).NAMESPACE=openshift-update-service
$ NAMESPACE=openshift-update-service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 네임스페이스는 Operator 그룹의
targetNamespaces
값과 일치해야 합니다.OpenShift Update Service 애플리케이션의 이름을 구성합니다(예:
service
).NAME=service
$ NAME=service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow "OpenShift 컨테이너 플랫폼 이미지 저장소 미러링"에서 구성한 대로 릴리스 이미지에 대한 레지스트리와 저장소를 구성합니다(예:
registry.example.com/ocp4/openshift4-release-images
):RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images
$ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 그래프 데이터 이미지에 대한 로컬 풀스펙을 "OpenShift 업데이트 서비스 그래프 데이터 컨테이너 이미지 만들기"에서 생성한 그래프 데이터 컨테이너 이미지(예:
registry.example.com/openshift/graph-data:latest
)로 설정합니다.GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest
$ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service 애플리케이션 오브젝트를 생성합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service 애플리케이션 확인
다음 명령을 사용하여 정책 엔진 경로를 가져옵니다.
while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done
$ while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 명령이 성공할 때까지 폴링해야 할 수도 있습니다.
정책 엔진에서 그래프를 검색합니다.
channel
에 유효한 버전을 지정해야 합니다. 예를 들어 OpenShift Container Platform 4.19에서 실행하는 경우stable-4.19를
사용합니다.while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done
$ while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 경우 그래프 요청이 성공할 때까지 폴링되지만 미러링된 릴리스 이미지에 따라 결과 그래프가 비어 있을 수 있습니다.
정책 엔진 경로 이름은 RFC-1123을 기반으로 63자 이하여야 합니다. host must conform to DNS 1123 naming convention and must be no more than 63 characters
로 인해 CreateRouteFailed
이유와 함께 ReconcileCompleted
상태가 false
인 경우 더 짧은 이름으로 업데이트 서비스를 생성하십시오.
6.3.8. Cluster Version Operator (CVO) 구성 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift 업데이트 서비스 운영자가 설치되고 OpenShift 업데이트 서비스 애플리케이션이 생성된 후, 클러스터 버전 운영자(CVO)를 업데이트하여 사용자 환경에 설치된 OpenShift 업데이트 서비스에서 그래프 데이터를 가져올 수 있습니다.
사전 요구 사항
- OpenShift Update Service Operator가 설치되었습니다.
- OpenShift 업데이트 서비스 그래프 데이터 컨테이너 이미지가 생성되어 OpenShift 업데이트 서비스에서 액세스할 수 있는 저장소에 푸시되었습니다.
- 현재 릴리스와 업데이트 대상 릴리스는 연결이 끊긴 환경의 레지스트리에 미러링되었습니다.
- OpenShift Update Service 애플리케이션이 생성되었습니다.
프로세스
OpenShift Update Service 대상 네임스페이스를 설정합니다(예:
openshift-update-service
).NAMESPACE=openshift-update-service
$ NAMESPACE=openshift-update-service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service 애플리케이션의 이름을 설정합니다(예:
service
).NAME=service
$ NAME=service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 정책 엔진 경로를 가져옵니다.
POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"
$ POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 풀 그래프 데이터의 패치를 설정합니다.
PATCH="{\"spec\":{\"upstream\":\"${POLICY_ENGINE_GRAPH_URI}\"}}"
$ PATCH="{\"spec\":{\"upstream\":\"${POLICY_ENGINE_GRAPH_URI}\"}}"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 사용자 환경에서 OpenShift 업데이트 서비스를 사용하려면 CVO에 패치를 적용하세요.
oc patch clusterversion version -p $PATCH --type merge
$ oc patch clusterversion version -p $PATCH --type merge
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
CA가 업데이트 서버를 신뢰하도록 구성하려면 클러스터 전체 프록시 구성을 참조하세요.
6.3.9. 다음 단계 링크 복사링크가 클립보드에 복사되었습니다!
클러스터를 업데이트하기 전에 다음 조건이 충족되는지 확인하세요.
- 클러스터 버전 운영자(CVO)는 설치된 OpenShift 업데이트 서비스 애플리케이션을 사용하도록 구성되었습니다.
새 릴리스에 대한 릴리스 이미지 서명 구성 맵이 클러스터에 적용됩니다.
참고클러스터 버전 운영자(CVO)는 릴리스 이미지 서명을 사용하여 릴리스 이미지가 수정되지 않았는지 확인하고 릴리스 이미지 서명이 예상 결과와 일치하는지 확인합니다.
- 현재 릴리스 및 업데이트 대상 릴리스 이미지는 연결이 끊긴 환경의 레지스트리에 미러링됩니다.
- 최근 그래프 데이터 컨테이너 이미지가 레지스트리에 미러링되었습니다.
OpenShift Update Service Operator의 최신 버전이 설치되었습니다.
참고최근에 OpenShift Update Service Operator를 설치하거나 업데이트하지 않은 경우 최신 버전을 사용할 수 있습니다. 연결이 끊긴 환경에서 OLM 카탈로그를 업데이트하는 방법에 대한 자세한 내용은 연결이 끊긴 환경에서 Operator Lifecycle Manager 사용을 참조하세요.
설치된 OpenShift 업데이트 서비스와 로컬 미러 레지스트리를 사용하도록 클러스터를 구성한 후에는 다음 업데이트 방법을 사용할 수 있습니다.
6.4. OpenShift Update Service 없이 연결이 끊긴 환경에서 클러스터 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift 업데이트 서비스에 액세스할 수 없는 연결이 끊긴 환경에서 클러스터를 업데이트하려면 다음 절차를 사용하세요.
6.4.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
-
oc
명령 줄 인터페이스 (CLI) 툴이 설치되어 있어야합니다. - OpenShift 컨테이너 플랫폼 이미지 미러링 에 설명된 대로 업데이트에 대한 컨테이너 이미지로 로컬 컨테이너 이미지 레지스트리를 프로비저닝해야 합니다.
-
관리자
권한이 있는 사용자로 클러스터에 액세스할 수 있어야 합니다. RBAC를 사용하여 권한 정의 및 적용을 참조하세요. - 업데이트가 실패하고 클러스터를 이전 상태로 복원 해야 하는 경우를 대비해 최신 etcd 백업이 있어야 합니다.
- 이전에 Operator Lifecycle Manager(OLM)를 통해 설치한 모든 Operator를 대상 릴리스와 호환되는 버전으로 업데이트했습니다. Operator를 업데이트하면 클러스터 업데이트 중에 기본 OperatorHub 카탈로그가 현재 마이너 버전에서 다음 마이너 버전으로 전환될 때 유효한 업데이트 경로가 있는지 확인할 수 있습니다. 호환성을 확인하는 방법과 필요한 경우 설치된 Operator를 업데이트하는 방법에 대한 자세한 내용은 설치된 Operator 업데이트를 참조하세요.
- 모든 머신 구성 풀(MCP)이 실행 중이고 일시 중지되지 않았는지 확인해야 합니다. 업데이트 프로세스 중에 일시 중지된 MCP와 연결된 노드를 건너뜁니다. 카나리아 롤아웃 업데이트 전략을 수행하는 경우 MCP를 일시 중지할 수 있습니다.
- 클러스터에서 수동으로 유지 관리되는 인증 정보를 사용하는 경우 새 릴리스의 클라우드 공급자 리소스를 업데이트합니다. 클러스터에 대한 요구 사항인지 확인하는 방법을 포함한 자세한 내용은 수동으로 유지 관리되는 자격 증명으로 클러스터 업데이트 준비를 참조하세요.
-
Operator를 실행하거나 Pod 중단 예산으로 애플리케이션을 구성한 경우 업데이트 프로세스 중에 중단이 발생할 수 있습니다.
PodDisruptionBudget
에서minAvailable이
1로 설정된 경우 보류 중인 머신 구성을 적용하기 위해 노드가 비워지며 이로 인해 퇴거 프로세스가 차단될 수 있습니다. 여러 노드가 재부팅되면 모든 포드가 하나의 노드에서만 실행될 수 있으며,PodDisruptionBudget
필드가 노드 비움을 방지할 수 있습니다.
Operator를 실행하거나 Pod 중단 예산으로 애플리케이션을 구성한 경우 업데이트 프로세스 중에 중단이 발생할 수 있습니다. PodDisruptionBudget
에서 minAvailable이
1로 설정된 경우 보류 중인 머신 구성을 적용하기 위해 노드가 비워지며 이로 인해 퇴거 프로세스가 차단될 수 있습니다. 여러 노드가 재부팅되면 모든 포드가 하나의 노드에서만 실행될 수 있으며, PodDisruptionBudget
필드가 노드 비움을 방지할 수 있습니다.
6.4.2. MachineHealthCheck 리소스 일시 중지 링크 복사링크가 클립보드에 복사되었습니다!
업데이트 프로세스 중에 클러스터의 노드를 일시적으로 사용할 수 없게 될 수 있습니다. 워커 노드의 경우, MachineHealthCheck
리소스는 해당 노드를 비정상으로 식별하고 재부팅할 수 있습니다. 이러한 노드를 재부팅하지 않으려면 클러스터를 업데이트하기 전에 모든 MachineHealthCheck
리소스를 일시 중지합니다.
일부 MachineHealthCheck
리소스는 일시 중지할 필요가 없을 수도 있습니다. MachineHealthCheck
리소스가 복구할 수 없는 조건에 의존하는 경우 해당 MHC를 일시 중지할 필요가 없습니다.
사전 요구 사항
-
OpenShift CLI(
oc
)를 설치합니다.
프로세스
일시 중지하려는 사용 가능한
MachineHealthCheck
리소스를 모두 나열하려면 다음 명령을 실행합니다.oc get machinehealthcheck -n openshift-machine-api
$ oc get machinehealthcheck -n openshift-machine-api
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 머신 상태 점검을 일시 중지하려면
cluster.x-k8s.io/paused=""
주석을MachineHealthCheck
리소스에 추가합니다. 다음 명령을 실행합니다.oc -n openshift-machine-api annotate mhc <mhc-name> cluster.x-k8s.io/paused=""
$ oc -n openshift-machine-api annotate mhc <mhc-name> cluster.x-k8s.io/paused=""
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 주석이 지정된
MachineHealthCheck
리소스는 다음 YAML 파일과 유사합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요클러스터를 업데이트한 후 머신 상태 점검을 다시 시작합니다. 검사를 다시 시작하려면 다음 명령을 실행하여
MachineHealthCheck
리소스에서 일시 중지 주석을 제거합니다.oc -n openshift-machine-api annotate mhc <mhc-name> cluster.x-k8s.io/paused-
$ oc -n openshift-machine-api annotate mhc <mhc-name> cluster.x-k8s.io/paused-
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.4.3. 릴리스 이미지 다이제스트 검색 링크 복사링크가 클립보드에 복사되었습니다!
--to-image
옵션과 함께 oc adm upgrade
명령을 사용하여 연결이 끊긴 환경에서 클러스터를 업데이트하려면 대상 릴리스 이미지에 해당하는 sha256 다이제스트를 참조해야 합니다.
프로세스
인터넷에 연결된 장치에서 다음 명령을 실행하세요.
oc adm release info -o 'jsonpath={.digest}{"\n"}' quay.io/openshift-release-dev/ocp-release:${OCP_RELEASE_VERSION}-${ARCHITECTURE}
$ oc adm release info -o 'jsonpath={.digest}{"\n"}' quay.io/openshift-release-dev/ocp-release:${OCP_RELEASE_VERSION}-${ARCHITECTURE}
Copy to Clipboard Copied! Toggle word wrap Toggle overflow {OCP_RELEASE_VERSION}
에 업데이트하려는 OpenShift Container Platform 버전(예:4.10.16)
을 지정합니다.{ARCHITECTURE}
의 경우x86_64
,aarch64
,s390x
또는ppc64le
과 같은 클러스터 아키텍처를 지정합니다.출력 예
sha256:a8bfba3b6dddd1a2fbbead7dac65fe4fb8335089e4e7cae327f3bad334add31d
sha256:a8bfba3b6dddd1a2fbbead7dac65fe4fb8335089e4e7cae327f3bad334add31d
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 클러스터를 업데이트할 때 사용할 sha256 다이제스트를 복사합니다.
6.4.4. 연결이 끊긴 클러스터 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
릴리스 이미지를 다운로드한 OpenShift Container Platform 버전으로 연결이 끊긴 클러스터를 업데이트합니다.
로컬 OpenShift Update Service가 있는 경우 이 절차 대신 연결된 웹 콘솔 또는 CLI 지침을 사용하여 업데이트할 수 있습니다.
사전 요구 사항
- 새 릴리스의 이미지를 레지스트리에 미러링하고 있습니다.
새 릴리스의 릴리스 이미지 서명 ConfigMap을 클러스터에 적용하고 있습니다.
참고릴리스 이미지 서명 구성 맵을 사용하면 클러스터 버전 운영자(CVO)가 실제 이미지 서명이 예상 서명과 일치하는지 확인하여 릴리스 이미지의 무결성을 보장할 수 있습니다.
- 대상 릴리스 이미지에 대한 sha256 다이제스트를 가져옵니다.
-
OpenShift CLI(
oc
)를 설치합니다. -
모든
MachineHealthCheck
리소스를 일시 중지했습니다.
프로세스
클러스터를 업데이트합니다.
oc adm upgrade --allow-explicit-upgrade --to-image <defined_registry>/<defined_repository>@<digest>
$ oc adm upgrade --allow-explicit-upgrade --to-image <defined_registry>/<defined_repository>@<digest>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
<defined_registry>
- 이미지를 미러링한 미러 레지스트리의 이름을 지정합니다.
<defined_repository>
- 미러 레지스트리에서 사용할 이미지 저장소의 이름을 지정합니다.
<digest>
-
대상 릴리스 이미지에 대한 sha256 다이제스트를 지정합니다(예:
sha256:81154f5c03294534e1eaf0319bef7a601134f891689ccede5d705ef659aa8c92)
.
참고- 미러 레지스트리와 저장소 이름이 어떻게 정의되어 있는지 검토하려면 "OpenShift Container Platform 이미지 미러링"을 참조하세요.
-
ImageContentSourcePolicy
또는ImageDigestMirrorSet을
사용한 경우 정의한 이름 대신 정식 레지스트리 및 저장소 이름을 사용할 수 있습니다. 정식 레지스트리 이름은quay.io
이고 표준 리포지토리 이름은openshift-release-dev/ocp-release
입니다. -
ImageContentSourcePolicy
,ImageDigestMirrorSet
또는ImageTagMirrorSet
오브젝트가 있는 클러스터에 대한 글로벌 풀 시크릿만 구성할 수 있습니다. 프로젝트에 풀 시크릿을 추가할 수 없습니다.
6.4.5. 이미지 레지스트리 저장소 미러링 이해 링크 복사링크가 클립보드에 복사되었습니다!
컨테이너 레지스트리 저장소 미러링을 설정하면 다음 작업을 수행할 수 있습니다.
- 소스 이미지 레지스트리의 저장소에서 이미지를 가져오기 위해 요청을 리디렉션하고 미러링된 이미지 레지스트리의 저장소에서 이를 해석하도록 OpenShift Container Platform 클러스터를 설정합니다.
- 하나의 미러가 다운된 경우 다른 미러를 사용할 수 있도록 각 대상 저장소에 대해 여러 미러링된 저장소를 확인합니다.
OpenShift Container Platform의 저장소 미러링에는 다음 속성이 포함되어 있습니다.
- 이미지 풀은 레지스트리 다운타임에 탄력적으로 대처할 수 있습니다.
- 연결이 끊긴 환경의 클러스터는 중요한 위치(예: quay.io)에서 이미지를 가져오고 회사 방화벽 뒤의 레지스트리에서 요청된 이미지를 제공하도록 할 수 있습니다.
- 이미지 가져오기 요청이 있으면 특정한 레지스트리 순서로 가져오기를 시도하며 일반적으로 영구 레지스트리는 마지막으로 시도합니다.
-
입력한 미러링 정보는 OpenShift Container Platform 클러스터의 모든 노드에서
/etc/containers/registries.conf
파일에 추가됩니다. - 노드가 소스 저장소에서 이미지를 요청하면 요청된 컨텐츠를 찾을 때 까지 미러링된 각 저장소를 차례로 시도합니다. 모든 미러가 실패하면 클러스터는 소스 저장소를 시도합니다. 성공하면 이미지를 노드로 가져올 수 있습니다.
저장소 미러링은 다음과 같은 방법으로 설정할 수 있습니다.
OpenShift Container Platform 설치 시
OpenShift Container Platform에 필요한 컨테이너 이미지를 가져온 다음 해당 이미지를 회사 방화벽 뒤에 배치하면 연결이 끊긴 환경에 있는 데이터 센터에 OpenShift Container Platform을 설치할 수 있습니다.
OpenShift Container Platform 설치 후
OpenShift Container Platform 설치 중에 미러링을 구성하지 않은 경우 다음 사용자 정의 리소스(CR) 개체를 사용하여 설치 후에 미러링을 구성할 수 있습니다.
-
ImageDigestMirrorSet
(IDMS). 이 객체를 사용하면 다이제스트 사양을 사용하여 미러링된 레지스트리에서 이미지를 가져올 수 있습니다. IDMS CR을 사용하면 이미지 풀링이 실패할 경우 소스 레지스트리에서 계속해서 풀링을 시도하는 것을 허용하거나 중지하는 대체 정책을 설정할 수 있습니다. -
ImageTagMirrorSet
(ITMS). 이 객체를 사용하면 이미지 태그를 사용하여 미러링된 레지스트리에서 이미지를 가져올 수 있습니다. ITMS CR을 사용하면 이미지 풀링이 실패할 경우 소스 레지스트리에서 계속해서 풀링을 시도하는 것을 허용하거나 중지하는 대체 정책을 설정할 수 있습니다. -
이미지 콘텐츠 소스
정책(ICSP). 이 객체를 사용하면 다이제스트 사양을 사용하여 미러링된 레지스트리에서 이미지를 가져올 수 있습니다. 미러가 작동하지 않으면 ICSP CR은 항상 소스 레지스트리로 돌아갑니다.
중요ICSP(
ImageContentSourcePolicy
) 오브젝트를 사용하여 저장소 미러링을 구성하는 것은 더 이상 사용되지 않는 기능입니다. 더 이상 사용되지 않는 기능은 여전히 OpenShift Container Platform에 포함되어 있으며 계속 지원됩니다. 그러나 이 기능은 향후 릴리스에서 제거될 예정이므로 새로운 배포에는 사용하지 않는 것이 좋습니다.ImageContentSourcePolicy
개체를 생성하는 데 사용한 기존 YAML 파일이 있는 경우oc adm migrate icsp
명령을 사용하여 해당 파일을ImageDigestMirrorSet
YAML 파일로 변환할 수 있습니다. 자세한 내용은 다음 섹션의 "이미지 레지스트리 저장소 미러링에 대한 ImageContentSourcePolicy (ICSP) 파일 변환"을 참조하십시오.-
이러한 각 사용자 정의 리소스 개체는 다음 정보를 식별합니다.
- 미러링하려는 컨테이너 이미지 저장소의 소스
- 소스 저장소에서 요청된 컨텐츠를 제공하는 각 미러 저장소에 대한 개별 항목
새 클러스터의 경우 원하는 대로 IDMS, ITMS 및 ICSP CR 객체를 사용할 수 있습니다. 하지만 IDMS와 ITMS를 사용하는 것이 좋습니다.
클러스터를 업그레이드한 경우 기존 ICSP 개체는 안정적으로 유지되며 IDMS 및 ICSP 개체가 모두 지원됩니다. ICSP 객체를 사용하는 작업 부하는 예상대로 계속 작동합니다. 그러나 IDMS CR에 도입된 대체 정책을 활용하려면 다음 이미지 레지스트리 저장소 미러링 섹션에 대해 ICSP(Conversioning ImageContentSourcePolicy) 파일에 표시된 대로 oc adm migrate icsp
명령을 사용하여 현재 워크로드를 IDMS 오브젝트로 마이그레이션할 수 있습니다. IDMS 개체로 마이그레이션하는 데 클러스터를 재부팅할 필요가 없습니다.
클러스터에서 ImageDigestMirrorSet
,ImageTagMirrorSet
또는 ImageContentSourcePolicy
개체를 사용하여 저장소 미러링을 구성하는 경우 미러링된 레지스트리에 대해 글로벌 풀 시크릿만 사용할 수 있습니다. 프로젝트에 풀 시크릿을 추가할 수 없습니다.
6.4.5.1. 이미지 레지스트리 저장소 미러링 설정 링크 복사링크가 클립보드에 복사되었습니다!
소스 이미지 레지스트리에서 미러 이미지 레지스트리로 이미지 풀 요청을 리디렉션하기 위해 사후 설치 미러 구성 사용자 정의 리소스(CR)를 만들 수 있습니다.
사전 요구 사항
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
프로세스
미러링된 저장소를 설정합니다.
- Red Hat Quay 저장소 미러링에 설명된 대로 Red Hat Quay 로 미러링된 저장소를 설정합니다. Red Hat Quay를 사용하면 한 저장소에서 다른 저장소로 이미지를 복사할 수 있고, 시간이 지남에 따라 해당 저장소를 자동으로 반복적으로 동기화할 수도 있습니다.
Skopeo
와 같은 도구를 사용하여 소스 저장소에서 미러링된 저장소로 이미지를 수동으로 복사합니다.예를 들어, Red Hat Enterprise Linux(RHEL) 7 또는 RHEL 8 시스템에 skopeo RPM 패키지를 설치한 후 다음 예와 같이
skopeo
명령을 사용합니다.skopeo copy --all \ docker://registry.access.redhat.com/ubi9/ubi-minimal:latest@sha256:5cf... \ docker://example.io/example/ubi-minimal
$ skopeo copy --all \ docker://registry.access.redhat.com/ubi9/ubi-minimal:latest@sha256:5cf... \ docker://example.io/example/ubi-minimal
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 예제에는
example.io
라는 컨테이너 이미지 레지스트리가 있으며,registry.access.redhat.com
에서ubi9/ubi-minimal
이미지를 복사할example
이라는 이미지 저장소가 있습니다. 미러링된 레지스트리를 만든 후에는 OpenShift Container Platform 클러스터를 구성하여 소스 저장소에 대한 요청을 미러링된 저장소로 리디렉션할 수 있습니다.
다음 예제 중 하나를 사용하여 설치 후 미러 구성 CR을 만듭니다.
필요에 따라
ImageDigestMirrorSet
또는ImageTagMirrorSet
CR을 생성하여 소스 및 미러를 자체 레지스트리 및 저장소 쌍과 이미지로 교체합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 이 CR과 함께 사용할 API를 나타냅니다.
config.openshift.io/v1
이어야 합니다. - 2
- 풀 유형에 따라 오브젝트의 종류를 나타냅니다.
-
ImageDigestMirrorSet
: 다이제스트 참조 이미지를 가져옵니다. -
ImageTagMirrorSet
: 태그 참조 이미지를 가져옵니다.
-
- 3
- 이미지 가져오기 방법 유형을 나타냅니다.
-
imageDigestMirrors
:ImageDigestMirrorSet
CR에 사용합니다. -
imageTagMirrors
:ImageTagMirrorSet
CR에 사용합니다.
-
- 4
- 미러링된 이미지 레지스트리 및 저장소의 이름을 나타냅니다.
- 5
- 선택 사항: 각 대상 저장소에 대한 보조 미러 저장소를 나타냅니다. 하나의 미러가 다운되면 대상 저장소는 보조 미러를 사용할 수 있습니다.
- 6
- 레지스트리와 저장소 소스를 나타냅니다. 즉, 이미지 풀 사양에서 참조되는 저장소입니다.
- 7
- 선택 사항: 이미지 가져오기에 실패하는 경우 대체 정책을 표시합니다.
-
AllowContactingSource
: 소스 저장소에서 이미지를 계속 가져올 수 있습니다. 이는 기본값입니다. -
NeverContactSource
: 소스 저장소에서 이미지를 가져 오는 지속적인 시도를 방지합니다.
-
- 8
- 선택 사항: 레지스트리 내부의 네임스페이스를 나타내며, 이를 통해 해당 네임스페이스의 이미지를 사용할 수 있습니다. 레지스트리 도메인을 소스로 사용하는 경우 오브젝트는 레지스트리의 모든 리포지토리에 적용됩니다.
- 9
- 선택 사항: 레지스트리를 나타내며, 레지스트리의 이미지를 사용할 수 있습니다. 레지스트리 이름을 지정하면 오브젝트가 소스 레지스트리의 모든 리포지토리에 적용됩니다.
- 10
- 미러
mirror.example.net/image@sha256:..
에서registry.example.com/example/myimage@sha256:…
이미지를 가져옵니다. - 11
- 미러
mirror.example.net/image@sha256:…
에서 소스 레지스트리 네임스페이스에서registry.example.com/example/image@sha256:…
이미지를 가져옵니다. - 12
- 미러 레지스트리
example.net/registry-example-com/myimage@sha256:…
에서registry.example.com/myimage@sha256
이미지를 가져옵니다.
소스와 미러를 사용자 정의 레지스트리 및 저장소 쌍과 이미지로 대체하여
ImageContentSourcePolicy
사용자 정의 리소스를 만듭니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
새 오브젝트를 생성합니다.
oc create -f registryrepomirror.yaml
$ oc create -f registryrepomirror.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 객체가 생성된 후, MCO(Machine Config Operator)는
ImageTagMirrorSet
객체에 대한 노드만 비웁니다. MCO는ImageDigestMirrorSet
및ImageContentSourcePolicy
개체의 노드를 비우지 않습니다.미러링된 구성 설정이 적용되었는지 확인하려면 노드 중 하나에서 다음을 수행하십시오.
노드를 나열합니다.
oc get node
$ oc get node
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 디버깅 프로세스를 시작하고 노드에 액세스합니다.
oc debug node/ip-10-0-147-35.ec2.internal
$ oc debug node/ip-10-0-147-35.ec2.internal
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Starting pod/ip-10-0-147-35ec2internal-debug ... To use host binaries, run `chroot /host`
Starting pod/ip-10-0-147-35ec2internal-debug ... To use host binaries, run `chroot /host`
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 루트 디렉토리를
/host
로 변경합니다.chroot /host
sh-4.2# chroot /host
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /etc/containers/registries.conf
파일을 체크하여 변경 사항이 적용되었는지 확인합니다.cat /etc/containers/registries.conf
sh-4.2# cat /etc/containers/registries.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 출력은 설치 후 미러 구성 CR이 적용된
registries.conf
파일을 나타냅니다. 마지막 두 항목은 각각digest-only
및tag-only
로 표시됩니다.출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 소스에서 이미지를 노드로 가져와 미러링에 의해 해결되는지 확인합니다.
podman pull --log-level=debug registry.access.redhat.com/ubi9/ubi-minimal@sha256:5cf...
sh-4.2# podman pull --log-level=debug registry.access.redhat.com/ubi9/ubi-minimal@sha256:5cf...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
저장소 미러링 문제 해결
저장소 미러링 절차가 설명대로 작동하지 않는 경우 저장소 미러링 작동 방법에 대한 다음 정보를 사용하여 문제를 해결하십시오.
- 가져온 이미지는 첫 번째 작동 미러를 사용하여 공급합니다.
- 주요 레지스트리는 다른 미러가 작동하지 않는 경우에만 사용됩니다.
-
시스템 컨텍스트에서
Insecure
플래그가 폴백으로 사용됩니다. -
/etc/containers/registries.conf
파일 형식이 최근에 변경되었습니다. 현재 버전은 TOML 형식의 버전 2입니다.
6.4.5.2. 이미지 레지스트리 저장소 미러링을 위한 ICP( ImageContentSourcePolicy) 파일 변환 링크 복사링크가 클립보드에 복사되었습니다!
ICSP( ImageContentSourcePolicy
) 오브젝트를 사용하여 저장소 미러링을 구성하는 것은 더 이상 사용되지 않는 기능입니다. 이 기능은 여전히 OpenShift Container Platform에 포함되어 있으며 계속 지원됩니다. 그러나 이 기능은 향후 릴리스에서 제거될 예정이므로 새로운 배포에는 사용하지 않는 것이 좋습니다.
ICSP 오브젝트는 저장소 미러링을 구성하기 위해 ImageDigestMirrorSet
및 ImageTagMirrorSet
개체로 교체됩니다. ImageContentSourcePolicy
개체를 생성하는 데 사용한 기존 YAML 파일이 있는 경우 oc adm migrate icsp
명령을 사용하여 해당 파일을 ImageDigestMirrorSet
YAML 파일로 변환할 수 있습니다. 명령은 현재 버전으로 API를 업데이트하고, kind
값을 ImageDigestMirrorSet
로 변경하고, spec.repositoryDigestMirrors
를 spec.imageDigestMirrors
로 변경합니다. 파일의 나머지 부분은 변경되지 않습니다.
마이그레이션으로 인해 registries.conf
파일이 변경되지 않으므로 클러스터를 재부팅할 필요가 없습니다.
ImageDigestMirrorSet
또는 ImageTagMirrorSet
오브젝트에 대한 자세한 내용은 이전 섹션의 "이미지 레지스트리 저장소 미러링 설정"을 참조하십시오.
사전 요구 사항
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다. -
클러스터에
ImageContentSourcePolicy
개체가 있는지 확인합니다.
프로세스
다음 명령을 사용하여 하나 이상의
ImageContentSourcePolicy
YAML 파일을ImageDigestMirrorSet
YAML 파일로 변환합니다.oc adm migrate icsp <file_name>.yaml <file_name>.yaml <file_name>.yaml --dest-dir <path_to_the_directory>
$ oc adm migrate icsp <file_name>.yaml <file_name>.yaml <file_name>.yaml --dest-dir <path_to_the_directory>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
<file_name>
-
소스
ImageContentSourcePolicy
YAML의 이름을 지정합니다. 여러 파일 이름을 나열할 수 있습니다. --dest-dir
-
선택 사항: 출력
ImageDigestMirrorSet
YAML의 디렉터리를 지정합니다. 설정되지 않으면 파일이 현재 디렉터리에 기록됩니다.
예를 들어 다음 명령은
icsp.yaml
및icsp-2.yaml
파일을 변환하고 새 YAML 파일을idms-files
디렉터리에 저장합니다.oc adm migrate icsp icsp.yaml icsp-2.yaml --dest-dir idms-files
$ oc adm migrate icsp icsp.yaml icsp-2.yaml --dest-dir idms-files
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
wrote ImageDigestMirrorSet to idms-files/imagedigestmirrorset_ubi8repo.5911620242173376087.yaml wrote ImageDigestMirrorSet to idms-files/imagedigestmirrorset_ubi9repo.6456931852378115011.yaml
wrote ImageDigestMirrorSet to idms-files/imagedigestmirrorset_ubi8repo.5911620242173376087.yaml wrote ImageDigestMirrorSet to idms-files/imagedigestmirrorset_ubi9repo.6456931852378115011.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 CR 오브젝트를 생성합니다.
oc create -f <path_to_the_directory>/<file-name>.yaml
$ oc create -f <path_to_the_directory>/<file-name>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
<path_to_the_directory>
-
--dest-dir
플래그를 사용한 경우 디렉터리의 경로를 지정합니다. <file_name>
-
ImageDigestMirrorSet
YAML의 이름을 지정합니다.
- IDMS 개체가 롤아웃된 후 ICSP 개체를 제거합니다.
6.4.6. 클러스터 노드 재부팅 빈도를 줄이기 위해 미러 이미지 카탈로그의 범위 확장 링크 복사링크가 클립보드에 복사되었습니다!
미러링된 이미지 카탈로그의 범위를 저장소 수준 또는 더 넓은 레지스트리 수준에서 지정할 수 있습니다. 광범위한 ImageContentSourcePolicy
리소스는 리소스 변경에 따라 노드를 재부팅해야 하는 횟수를 줄입니다.
ImageContentSourcePolicy
리소스에서 미러 이미지 카탈로그의 범위를 확장하려면 다음 절차를 수행합니다.
사전 요구 사항
-
OpenShift Container Platform CLI
oc
를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - 연결이 끊긴 클러스터에서 사용할 미러링된 이미지 카탈로그를 구성합니다.
프로세스
<local_registry>
,<pull_spec>
, 및<pull_secret_file>
에 대한 값을 지정하여 다음 명령을 실행합니다.oc adm catalog mirror <local_registry>/<pull_spec> <local_registry> -a <pull_secret_file> --icsp-scope=registry
$ oc adm catalog mirror <local_registry>/<pull_spec> <local_registry> -a <pull_secret_file> --icsp-scope=registry
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음과 같습니다.
- <local_registry>
-
연결이 끊긴 클러스터에 대해 구성한 로컬 레지스트리입니다 (예:
local.registry:5000
). - <pull_spec>
-
연결이 끊긴 레지스트리에 구성된 풀 사양은 다음과 같습니다. 예:
redhat/redhat-operator-index:v4.19
- <pull_secret_file>
-
registry.redhat.io
풀 시크릿은.json
파일 형식입니다. Red Hat OpenShift Cluster Manager에서 풀 시크릿을 다운로드할 수 있습니다.
oc adm catalog mirror
명령은/redhat-operator-index-manifests
디렉터리를 생성하고imageContentSourcePolicy.yaml
,catalogSource.yaml
및mapping.txt
파일을 생성합니다.새
ImageContentSourcePolicy
리소스를 클러스터에 적용합니다.oc apply -f imageContentSourcePolicy.yaml
$ oc apply -f imageContentSourcePolicy.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
검증
oc apply
가ImageContentSourcePolicy
에 변경 사항을 성공적으로 적용했는지 확인합니다.oc get ImageContentSourcePolicy -o yaml
$ oc get ImageContentSourcePolicy -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
ImageContentSourcePolicy
리소스를 업데이트한 후 OpenShift Container Platform은 새 설정을 각 노드에 배포하고 클러스터는 소스 저장소에 대한 요청에 미러링된 저장소를 사용하기 시작합니다.
6.5. 클러스터에서 OpenShift 업데이트 서비스 제거 링크 복사링크가 클립보드에 복사되었습니다!
클러스터에서 OSUS(OpenShift Update Service)의 로컬 복사본을 제거하려면 먼저 OSUS 애플리케이션을 삭제한 다음 OSUS Operator를 제거해야 합니다.
6.5.1. OpenShift Update Service 애플리케이션 삭제 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔 또는 CLI를 사용하여 OpenShift Update Service 애플리케이션을 삭제할 수 있습니다.
6.5.1.1. 웹 콘솔을 사용하여 OpenShift Update Service 애플리케이션 삭제 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔을 사용하여 OpenShift Update Service Operator로 OpenShift Update Service 애플리케이션을 삭제할 수 있습니다.
사전 요구 사항
- OpenShift Update Service Operator가 설치되었습니다.
프로세스
- 웹 콘솔에서 Operator → Installed Operator를 클릭합니다.
- 설치된 Operator 목록에서 OpenShift Update Service를 선택합니다.
- Update Service 탭을 클릭합니다.
- 설치된 OpenShift Update Service 애플리케이션 목록에서 삭제할 애플리케이션을 선택한 다음Delete UpdateService를 클릭합니다.
- Delete UpdateService? 확인 프롬프트에서 Delete를 클릭하여 삭제를 확인합니다.
6.5.1.2. CLI를 사용하여 OpenShift Update Service 애플리케이션 삭제 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift CLI(oc
)를 사용하여 OpenShift Update Service 애플리케이션을 삭제할 수 있습니다.
프로세스
OpenShift Update Service 애플리케이션이 생성된 네임스페이스(예:
openshift-update-service
)를 사용하여 OpenShift Update Service 애플리케이션 이름을 가져옵니다.oc get updateservice -n openshift-update-service
$ oc get updateservice -n openshift-update-service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME AGE service 6s
NAME AGE service 6s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이전 단계의
NAME
값과 OpenShift Update Service 애플리케이션이 생성된 네임스페이스(예:openshift-update-service
)를 사용하여 OpenShift Update Service 애플리케이션을 삭제합니다.oc delete updateservice service -n openshift-update-service
$ oc delete updateservice service -n openshift-update-service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
updateservice.updateservice.operator.openshift.io "service" deleted
updateservice.updateservice.operator.openshift.io "service" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.5.2. OpenShift Update Service Operator 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔이나 CLI를 사용하여 OpenShift Update Service Operator를 제거할 수 있습니다.
6.5.2.1. 웹 콘솔을 사용하여 OpenShift Update Service Operator 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform 웹 콘솔을 사용하여 OpenShift Update Service Operator를 설치 제거할 수 있습니다.
사전 요구 사항
- 모든 OpenShift Update Service 애플리케이션이 삭제되어 있어야 합니다.
프로세스
- 웹 콘솔에서 Operator → Installed Operator를 클릭합니다.
- 설치된 Operator 목록에서 OpenShift Update Service을 선택하고 Uninstall Operator를 클릭합니다.
- Uninstall Operator? 확인 대화 상자에서 Uninstall를 클릭하고 제거를 확인합니다.
6.5.2.2. CLI를 사용하여 OpenShift Update Service Operator 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift CLI(oc
)를 사용하여 OpenShift Update Service Operator를 제거할 수 있습니다.
사전 요구 사항
- 모든 OpenShift Update Service 애플리케이션이 삭제되어 있어야 합니다.
프로세스
OpenShift Update Service Operator가 포함된 프로젝트로 변경합니다(예:
openshift-update-service
).oc project openshift-update-service
$ oc project openshift-update-service
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Now using project "openshift-update-service" on server "https://example.com:6443".
Now using project "openshift-update-service" on server "https://example.com:6443".
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service Operator Operator 그룹의 이름을 가져옵니다.
oc get operatorgroup
$ oc get operatorgroup
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME AGE openshift-update-service-fprx2 4m41s
NAME AGE openshift-update-service-fprx2 4m41s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow operator 그룹을 삭제합니다(예:
openshift-update-service-fprx2
).oc delete operatorgroup openshift-update-service-fprx2
$ oc delete operatorgroup openshift-update-service-fprx2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
operatorgroup.operators.coreos.com "openshift-update-service-fprx2" deleted
operatorgroup.operators.coreos.com "openshift-update-service-fprx2" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow OpenShift Update Service Operator 서브스크립션의 이름을 가져옵니다.
oc get subscription
$ oc get subscription
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME PACKAGE SOURCE CHANNEL update-service-operator update-service-operator updateservice-index-catalog v1
NAME PACKAGE SOURCE CHANNEL update-service-operator update-service-operator updateservice-index-catalog v1
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이전 단계의
Name
값을 사용하여currentCSV
필드에서 구독한 OpenShift Update Service Operator의 현재 버전을 확인합니다.oc get subscription update-service-operator -o yaml | grep " currentCSV"
$ oc get subscription update-service-operator -o yaml | grep " currentCSV"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
currentCSV: update-service-operator.v0.0.1
currentCSV: update-service-operator.v0.0.1
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 서브스크립션을 삭제합니다(예:
update-service-operator
).oc delete subscription update-service-operator
$ oc delete subscription update-service-operator
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
subscription.operators.coreos.com "update-service-operator" deleted
subscription.operators.coreos.com "update-service-operator" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이전 단계의
currentCSV
값을 사용하여 OpenShift Update Service Operator의 CSV를 삭제합니다.oc delete clusterserviceversion update-service-operator.v0.0.1
$ oc delete clusterserviceversion update-service-operator.v0.0.1
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
clusterserviceversion.operators.coreos.com "update-service-operator.v0.0.1" deleted
clusterserviceversion.operators.coreos.com "update-service-operator.v0.0.1" deleted
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Legal Notice
링크 복사링크가 클립보드에 복사되었습니다!
Copyright © 2025 Red Hat
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.