This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.3.7. OpenShift Container Platform 이미지 저장소 미러링
클러스터 설치 또는 업그레이드 중에 사용할 OpenShift Container Platform 이미지 저장소를 레지스트리에 미러링합니다.
사전 요구 사항
- 미러 호스트가 인터넷에 액세스할 수 있습니다.
- 네트워크가 제한된 환경에서 사용할 미러 레지스트리를 설정하고 설정한 인증서 및 인증 정보에 액세스할 수 있습니다.
- Red Hat OpenShift Cluster Manager에서 풀 시크릿 을 다운로드하여 미러 저장소에 대한 인증을 포함하도록 수정했습니다.
- Subject Alternative Name을 설정하지 않는 자체 서명된 인증서를 사용하는 경우 이 절차의 - oc명령 앞에- GODEBUG=x509ignoreCN=0을 지정해야 합니다. 이 변수를 설정하지 않으면- oc명령이 다음 오류로 인해 실패합니다.- x509: certificate relies on legacy Common Name field, use SANs or temporarily enable Common Name matching with GODEBUG=x509ignoreCN=0 - x509: certificate relies on legacy Common Name field, use SANs or temporarily enable Common Name matching with GODEBUG=x509ignoreCN=0- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
프로세스
미러 호스트에서 다음 단계를 완료합니다.
- 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를 지정해야 합니다.
- 서버의 아키텍처 유형 (예: - x86_64)을 내보냅니다.- ARCHITECTURE=<server_architecture> - $ ARCHITECTURE=<server_architecture>- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 미러링된 이미지를 호스트할 디렉터리의 경로를 내보냅니다. - 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 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} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}"- $ oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}"- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 로컬 컨테이너 레지스트리가 미러 호스트에 연결된 경우 다음 명령을 실행합니다. - 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 버전에 올바른 이미지를 사용하려면 미러링된 콘텐츠에서 설치 프로그램을 배포해야 합니다. - 인터넷이 연결된 컴퓨터에서 이 단계를 수행해야 합니다. - 연결이 끊긴 환경에 있는 경우 - --image플래그를 must-gather의 일부로 사용하여 페이로드 이미지를 가리킵니다.
 
- 설치 프로그램에서 제공하는 인프라를 사용하는 클러스터의 경우 다음 명령을 실행합니다. - openshift-install - $ openshift-install- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow