연결 해제된 설치 미러링

프로세스

1. OpenShift 콘솔 다운로드 페이지에 있는 Red Hat OpenShift의 미러 레지스트리 최신 버전의 mirror-registry.tar.gz 패키지를 다운로드합니다.

2. mirror-registry 툴을 사용하여 현재 사용자 계정으로 로컬 호스트에 Red Hat OpenShift 의 미러 레지스트리를 설치합니다. 사용 가능한 플래그의 전체 목록은 "Red Hat OpenShift 플래그의 미러 레지스트리"를 참조하십시오.

   $ ./mirror-registry install \
     --quayHostname <host_example_com> \
     --quayRoot <example_directory_name>

   Copy to Clipboard Toggle word wrap

3. 설치 중에 생성된 사용자 이름과 암호를 사용하여 다음 명령을 실행하여 레지스트리에 로그인합니다.

   $ podman login -u init \
     -p <password> \
     <host_example_com>:8443> \
     --tls-verify=false 

   1

   Copy to Clipboard Toggle word wrap

   1

   생성된 rootCA 인증서를 신뢰하도록 시스템을 구성하여 --tls-verify=false 실행을 방지할 수 있습니다. 자세한 내용은 "Red Hat Quay 확인" 및 "인증 기관을 신뢰하도록 시스템 구성"을 참조하십시오.

   참고

   설치 후 https://<host.example.com>:8443 에서 UI에 액세스하여 로그인할 수도 있습니다.

4. 로그인 후 OpenShift Container Platform 이미지를 미러링할 수 있습니다. 필요에 따라 이 문서의 "OpenShift Container Platform 이미지 리포지토리 미러링" 또는 "연결이 끊긴 클러스터에 사용할 Operator 카탈로그 미러링" 섹션을 참조하십시오.

   참고

   스토리지 계층 문제로 인해 Red Hat OpenShift의 미러 레지스트리에 저장된 이미지에 문제가 있는 경우 OpenShift Container Platform 이미지를 다시 미러링하거나 더 안정적인 스토리지에 미러 레지스트리를 다시 설치할 수 있습니다.

검증

1. 다음 명령을 실행하여 Red Hat OpenShift의 미러 레지스트리 가 업데이트되었는지 확인합니다.

   $ podman ps

   Copy to Clipboard Toggle word wrap

   출력 예

   registry.redhat.io/quay/quay-rhel8:v3.12.10

   Copy to Clipboard Toggle word wrap

프로세스

1. OpenShift 콘솔 다운로드 페이지에 있는 Red Hat OpenShift의 미러 레지스트리 최신 버전의 mirror-registry.tar.gz 패키지를 다운로드합니다.

2. mirror-registry 툴을 사용하여 현재 사용자 계정으로 로컬 호스트에 Red Hat OpenShift 의 미러 레지스트리를 설치합니다. 사용 가능한 플래그의 전체 목록은 "Red Hat OpenShift 플래그의 미러 레지스트리"를 참조하십시오.

   $ ./mirror-registry install -v \
     --targetHostname <host_example_com> \
     --targetUsername <example_user> \
     -k ~/.ssh/my_ssh_key \
     --quayHostname <host_example_com> \
     --quayRoot <example_directory_name>

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 설치 중에 생성된 사용자 이름과 암호를 사용하여 미러 레지스트리에 로그인합니다.

   $ podman login -u init \
     -p <password> \
     <host_example_com>:8443> \
     --tls-verify=false 

   1

   Copy to Clipboard Toggle word wrap

   1

   생성된 rootCA 인증서를 신뢰하도록 시스템을 구성하여 --tls-verify=false 실행을 방지할 수 있습니다. 자세한 내용은 "SSL을 사용하여 Red Hat Quay에 대한 연결 보호" 및 "인증 기관을 신뢰하도록 시스템 구성"을 참조하십시오.

   참고

   설치 후 https://<host.example.com>:8443 에서 UI에 액세스하여 로그인할 수도 있습니다.

4. 로그인 후 OpenShift Container Platform 이미지를 미러링할 수 있습니다. 필요에 따라 이 문서의 "OpenShift Container Platform 이미지 리포지토리 미러링" 또는 "연결이 끊긴 클러스터에 사용할 Operator 카탈로그 미러링" 섹션을 참조하십시오.

   참고

   스토리지 계층 문제로 인해 Red Hat OpenShift의 미러 레지스트리에 저장된 이미지에 문제가 있는 경우 OpenShift Container Platform 이미지를 다시 미러링하거나 더 안정적인 스토리지에 미러 레지스트리를 다시 설치할 수 있습니다.

검증

1. 다음 명령을 실행하여 Red Hat OpenShift의 미러 레지스트리 가 업데이트되었는지 확인합니다.

   $ podman ps

   Copy to Clipboard Toggle word wrap

   출력 예

   registry.redhat.io/quay/quay-rhel8:v3.12.10

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 명령을 입력하여 Red Hat OpenShift의 미러 레지스트리를 설치합니다.

   $ ./mirror-registry install \
   --quayHostname <host_example_com> \
   --quayRoot <example_directory_name>

   Copy to Clipboard Toggle word wrap

   이렇게 하면 Red Hat OpenShift의 미러 레지스트리 가 $HOME/quay-install 디렉터리에 설치됩니다.

2. 새 CA(인증 기관) 번들을 준비하고 새 ssl.key 및 ssl.crt 키 파일을 생성합니다. 자세한 내용은 Red Hat Quay용 SSL 및 TLS 구성 을 참조하십시오.

3. 다음 명령을 입력하여 /$HOME/quay-install 환경 변수(예: QUAY )를 할당합니다.

   $ export QUAY=/$HOME/quay-install

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 입력하여 새 ssl.crt 파일을 /$HOME/quay-install 디렉터리에 복사합니다.

   $ cp ~/ssl.crt $QUAY/quay-config

   Copy to Clipboard Toggle word wrap

5. 다음 명령을 입력하여 새 ssl.key 파일을 /$HOME/quay-install 디렉터리에 복사합니다.

   $ cp ~/ssl.key $QUAY/quay-config

   Copy to Clipboard Toggle word wrap

6. 다음 명령을 입력하여 quay-app 애플리케이션 포드를 다시 시작합니다.

   $ systemctl --user restart quay-app

   Copy to Clipboard Toggle word wrap

1. Red Hat OpenShift Cluster Manager에서 registry.redhat.io 풀 시크릿을 다운로드합니다.

2. 풀 시크릿을 JSON 형식으로 복사합니다.

   $ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json> 

   1

   Copy to Clipboard Toggle word wrap

   1

   풀 시크릿을 저장할 폴더의 경로와 생성한 JSON 파일의 이름을 지정합니다.

   파일의 내용은 다음 예와 유사합니다.

   {
     "auths": {
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

   Copy to Clipboard Toggle word wrap

3. 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름 및 암호 또는 토큰을 생성합니다.

   $ echo -n '<user_name>:<password>' | base64 -w0 

   1

   
   BGVtbYk3ZHAtqXs=

   Copy to Clipboard Toggle word wrap

   1

   <user_name> 및 <password>의 경우 레지스트리에 설정한 사용자 이름 및 암호를 지정합니다.

4. JSON 파일을 편집하고 레지스트리를 설명하는 섹션을 추가합니다.

     "auths": {
       "<mirror_registry>": { 

   1

   
         "auth": "<credentials>", 

   2

   
         "email": "you@example.com"
       }
     },

   Copy to Clipboard Toggle word wrap

   1

   <mirror_registry>의 경우 미러 레지스트리가 콘텐츠를 제공하는데 사용하는 레지스트리 도메인 이름 및 포트 (선택 사항)를 지정합니다. 예: registry.example.com 또는 registry.example.com:8443

   2

   <credentials>의 경우 미러 레지스트리에 대해 base64로 인코딩된 사용자 이름 및 암호를 지정합니다.

   파일은 다음 예제와 유사합니다.

   {
     "auths": {
       "registry.example.com": {
         "auth": "BGVtbYk3ZHAtqXs=",
         "email": "you@example.com"
       },
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

   Copy to Clipboard Toggle word wrap

1. OpenShift Container Platform 다운로드 페이지를 확인하여 설치할 OpenShift Container Platform 버전을 확인하고 Repository Tags 페이지에서 해당 태그를 지정합니다.

2. 필요한 환경 변수를 설정합니다.

   1. 릴리스 버전을 내보냅니다.

      $ OCP_RELEASE=<release_version>

      Copy to Clipboard Toggle word wrap

      <release_version>에 대해 설치할 OpenShift Container Platform 버전에 해당하는 태그를 지정합니다 (예: 4.5.4).

   2. 로컬 레지스트리 이름 및 호스트 포트를 내보냅니다.

      $ LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>'

      Copy to Clipboard Toggle word wrap

      <local_registry_host_name>의 경우 미러 저장소의 레지스트리 도메인 이름을 지정하고 <local_registry_host_port>의 경우 콘텐츠를 제공하는데 사용되는 포트를 지정합니다.

   3. 로컬 저장소 이름을 내보냅니다.

      $ LOCAL_REPOSITORY='<local_repository_name>'

      Copy to Clipboard Toggle word wrap

      <local_repository_name>의 경우 레지스트리에 작성할 저장소 이름 (예: ocp4/openshift4)을 지정합니다.

   4. 미러링할 저장소 이름을 내보냅니다.

      $ PRODUCT_REPO='openshift-release-dev'

      Copy to Clipboard Toggle word wrap

      프로덕션 환경의 릴리스의 경우 openshift-release-dev를 지정해야 합니다.

   5. 레지스트리 풀 시크릿의 경로를 내보냅니다.

      $ LOCAL_SECRET_JSON='<path_to_pull_secret>'

      Copy to Clipboard Toggle word wrap

      생성한 미러 레지스트리에 대한 풀 시크릿의 절대 경로 및 파일 이름을 <path_to_pull_secret>에 지정합니다.

   6. 릴리스 미러를 내보냅니다.

      $ RELEASE_NAME="ocp-release"

      Copy to Clipboard Toggle word wrap

      프로덕션 환경의 릴리스의 경우 ocp-release를 지정해야 합니다.

   7. 클러스터의 아키텍처 유형을 내보냅니다.

      $ ARCHITECTURE=<cluster_architecture> 

      1

      Copy to Clipboard Toggle word wrap

      1

      x86_64,aarch64,s390x 또는 ppc64le 과 같은 클러스터의 아키텍처를 지정합니다.

   8. 미러링된 이미지를 호스트할 디렉터리의 경로를 내보냅니다.

      $ REMOVABLE_MEDIA_PATH=<path> 

      1

      Copy to Clipboard Toggle word wrap

      1

      초기 슬래시 (/) 문자를 포함하여 전체 경로를 지정합니다.

3. 미러 레지스트리에 버전 이미지를 미러링합니다.

   • 미러 호스트가 인터넷에 액세스할 수 없는 경우 다음 작업을 수행합니다.

     1. 이동식 미디어를 인터넷에 연결된 시스템에 연결합니다.

     2. 미러링할 이미지 및 설정 매니페스트를 확인합니다.

        $ 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 Toggle word wrap
     3. 이전 명령의 출력에서 전체 imageContentSources 섹션을 기록합니다. 미러에 대한 정보는 미러링된 저장소에 고유하며 설치 중에 imageContentSources 섹션을 install-config.yaml 파일에 추가해야 합니다.

     4. 이동식 미디어의 디렉터리에 이미지를 미러링합니다.

        $ 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 Toggle word wrap

     5. 미디어를 네트워크가 제한된 환경으로 가져와서 이미지를 로컬 컨테이너 레지스트리에 업로드합니다.

        $ 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 Toggle word wrap

        1

        REMOVABLE_MEDIA_PATH의 경우 이미지를 미러링 할 때 지정한 것과 동일한 경로를 사용해야 합니다.

        중요

        oc image mirror 를 실행하면 다음과 같은 오류가 발생할 수 있습니다. error: unable to retrieve source image. 이 오류는 이미지 인덱스에 이미지 레지스트리에 더 이상 존재하지 않는 이미지에 대한 참조가 포함된 경우 발생합니다. 이미지 인덱스에서는 이러한 이미지를 실행하는 사용자가 업그레이드 그래프의 최신 지점으로 업그레이드 경로를 실행할 수 있도록 이전 참조를 유지할 수 있습니다. 임시 해결 방법으로 --skip-missing 옵션을 사용하여 오류를 무시하고 이미지 인덱스를 계속 다운로드할 수 있습니다. 자세한 내용은 Service Mesh Operator 미러링 실패 에서 참조하십시오.

   • 로컬 컨테이너 레지스트리가 미러 호스트에 연결된 경우 다음 작업을 수행합니다.

     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}

        Copy to Clipboard Toggle word wrap

        이 명령은 요약된 릴리스 정보를 가져오며, 명령 출력에는 클러스터를 설치할 때 필요한 imageContentSources 데이터가 포함됩니다.

     2. 이전 명령의 출력에서 전체 imageContentSources 섹션을 기록합니다. 미러에 대한 정보는 미러링된 저장소에 고유하며 설치 중에 imageContentSources 섹션을 install-config.yaml 파일에 추가해야 합니다.

        참고

        미러링 프로세스 중에 이미지 이름이 Quay.io에 패치되고 podman 이미지는 부트스트랩 가상 머신의 레지스트리에 Quay.io를 표시합니다.

4. 미러링된 콘텐츠를 기반으로 설치 프로그램을 생성하려면 콘텐츠를 추출하여 릴리스 배포에 고정합니다.

   • 미러 호스트가 인터넷에 액세스할 수 없는 경우 다음 명령을 실행합니다.

     $ 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 Toggle word wrap

     1

     선택 사항: 대상 레지스트리에 대한 신뢰를 구성하지 않으려면 --insecure=true 플래그를 추가합니다.

   • 로컬 컨테이너 레지스트리가 미러 호스트에 연결된 경우 다음 명령을 실행합니다.

     $ oc adm release extract -a ${LOCAL_SECRET_JSON} --command=openshift-install "${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}"

     Copy to Clipboard Toggle word wrap
     중요

     선택한 OpenShift Container Platform 버전에 올바른 이미지를 사용하려면 미러링된 콘텐츠에서 설치 프로그램을 배포해야 합니다.

     인터넷이 연결된 컴퓨터에서 이 단계를 수행해야 합니다.

5. 설치 프로그램에서 제공하는 인프라를 사용하는 클러스터의 경우 다음 명령을 실행합니다.

   $ openshift-install

   Copy to Clipboard Toggle word wrap

프로세스

1. oc mirror init 명령을 사용하여 이미지 세트 구성에 대한 템플릿을 생성하고 imageset-config.yaml 이라는 파일에 저장합니다.

   $ oc mirror init --registry example.com/mirror/oc-mirror-metadata > imageset-config.yaml 

   1

   Copy to Clipboard Toggle word wrap

   1

   example.com/mirror/oc-mirror-metadata 를 스토리지 백엔드의 레지스트리 위치로 바꿉니다.

2. 파일을 편집하고 필요에 따라 설정을 조정합니다.

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   archiveSize: 4                                                      

   1

   
   storageConfig:                                                      

   2

   
     registry:
       imageURL: example.com/mirror/oc-mirror-metadata                 

   3

   
       skipTLS: false
   mirror:
     platform:
       channels:
       - name: stable-4.15                                             

   4

   
         type: ocp
       graph: true                                                     

   5

   
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.15  

   6

   
       packages:
       - name: serverless-operator                                     

   7

   
         channels:
         - name: stable                                                

   8

   
     additionalImages:
     - name: registry.redhat.io/ubi9/ubi:latest                        

   9

   
     helm: {}

   Copy to Clipboard Toggle word wrap

   1

   archiveSize 를 추가하여 이미지 세트 내에서 각 파일의 최대 크기를 GiB 단위로 설정합니다.

   2

   이미지 세트 메타데이터를 저장할 백엔드 위치를 설정합니다. 이 위치는 레지스트리 또는 로컬 디렉터리일 수 있습니다. storageConfig 값을 지정해야 합니다.

   3

   스토리지 백엔드의 레지스트리 URL을 설정합니다.

   4

   채널을 설정하여 OpenShift Container Platform 이미지를 검색합니다.

   5

   graph: true 를 추가하여 graph-data 이미지를 빌드 및 미러 레지스트리로 내보냅니다. OSUS(OpenShift Update Service)를 생성하려면 graph-data 이미지가 필요합니다. graph: 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

   이미지 세트에 포함할 추가 이미지를 지정합니다.

   참고

   graph: true 필드도 다른 미러링된 이미지와 함께 ubi-micro 이미지를 미러링합니다.

   OpenShift Container Platform EUS (Extended Update Support) 버전을 업그레이드할 때 현재 버전과 대상 버전 간에 중간 버전이 필요할 수 있습니다. 예를 들어 현재 버전이 4.14 이고 대상 버전이 4.16 인 경우 oc-mirror 플러그인 v1을 사용할 때 ImageSetConfiguration 에 4.15.8 과 같은 버전을 포함해야 할 수 있습니다.

   oc-mirror 플러그인 v1이 항상 자동으로 감지되지 않을 수 있으므로 필요한 중간 버전을 확인하고 구성에 수동으로 추가하려면 Cincinnati 그래프 웹 페이지를 확인하십시오.

   다양한 미러링 사용 사례는 전체 매개변수 및 이미지 세트 구성 예제는 이미지 세트 구성 매개변수를 참조하십시오.

3. 업데이트된 파일을 저장합니다.

   이 이미지 세트 구성 파일은 컨텐츠를 미러링할 때 oc mirror 명령에 필요합니다.

프로세스

1. cluster-admin 역할의 사용자로 OpenShift CLI에 로그인합니다.

2. 다음 명령을 실행하여 결과 디렉터리의 YAML 파일을 클러스터에 적용합니다.

   $ oc apply -f ./oc-mirror-workspace/results-1639608409/

   Copy to Clipboard Toggle word wrap

3. 미러링된 릴리스 이미지가 있는 경우 다음 명령을 실행하여 릴리스 이미지 서명을 클러스터에 적용합니다.

   $ oc apply -f ./oc-mirror-workspace/results-1639608409/release-signatures/

   Copy to Clipboard Toggle word wrap
   참고

   클러스터 대신 Operator를 미러링하는 경우 $ oc apply -f ./oc-mirror-workspace/results-1639608409/release-signatures/ 를 실행할 필요가 없습니다. 적용할 릴리스 이미지 서명이 없으므로 해당 명령을 실행하면 오류가 반환됩니다.

검증

1. 다음 명령을 실행하여 ImageContentSourcePolicy 리소스가 성공적으로 설치되었는지 확인합니다.

   $ oc get imagecontentsourcepolicy

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 CatalogSource 리소스가 성공적으로 설치되었는지 확인합니다.

   $ oc get catalogsource -n openshift-marketplace

   Copy to Clipboard Toggle word wrap

프로세스

1. --dry-run 플래그와 함께 oc mirror 명령을 실행하여 예행 실행을 수행합니다.

   $ oc mirror --config=./imageset-config.yaml \

   1

   
     docker://registry.example:5000            \

   2

   
     --dry-run                                  

   3

   Copy to Clipboard Toggle word wrap

   1

   생성된 이미지 세트 구성 파일을 전달합니다. 이 절차에서는 imageset-config.yaml 이라는 이름을 가정합니다.

   2

   미러 레지스트리를 지정합니다. --dry-run 플래그를 사용하는 한 이 레지스트리에 미러링된 것은 없습니다.

   3

   --dry-run 플래그를 사용하여 실제 이미지 세트 파일이 아닌 시험 실행 아티팩트를 생성합니다.

   출력 예

   Checking push permissions for registry.example:5000
   Creating directory: oc-mirror-workspace/src/publish
   Creating directory: oc-mirror-workspace/src/v2
   Creating directory: oc-mirror-workspace/src/charts
   Creating directory: oc-mirror-workspace/src/release-signatures
   No metadata detected, creating new workspace
   wrote mirroring manifests to oc-mirror-workspace/operators.1658342351/manifests-redhat-operator-index
   
   ...
   
   info: Planning completed in 31.48s
   info: Dry run complete
   Writing image mapping to oc-mirror-workspace/mapping.txt

   Copy to Clipboard Toggle word wrap

2. 생성된 작업 공간 디렉터리로 이동합니다.

   $ cd oc-mirror-workspace/

   Copy to Clipboard Toggle word wrap

3. 생성된 mapping.txt 파일을 검토합니다.

   이 파일에는 미러링된 모든 이미지 목록이 포함되어 있습니다.

4. 생성된 prune-plan.json 파일을 검토합니다.

   이 파일에는 이미지 세트가 게시될 때 미러 레지스트리에서 정리할 모든 이미지 목록이 포함되어 있습니다.

   참고

   cleanup -plan.json 파일은 oc-mirror 명령이 미러 레지스트리를 가리키며 정리할 이미지가 있는 경우에만 생성됩니다.

프로세스

1. 이미지 세트 구성 파일을 생성하고 필요에 따라 설정을 조정합니다.

   다음 예제 이미지 세트 구성은 OpenShift Container Platform 릴리스 및 registry.redhat.io 의 UBI 이미지와 함께 디스크에서 OCI 카탈로그를 미러링합니다.

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   storageConfig:
     local:
       path: /home/user/metadata                                                

   1

   
   mirror:
     platform:
       channels:
       - name: stable-4.15                                                      

   2

   
         type: ocp
       graph: false
     operators:
     - catalog: oci:///home/user/oc-mirror/my-oci-catalog                       

   3

   
       targetCatalog: my-namespace/redhat-operator-index                        

   4

   
       packages:
       - name: aws-load-balancer-operator
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.15           

   5

   
       packages:
       - name: rhacs-operator
     additionalImages:
     - name: registry.redhat.io/ubi9/ubi:latest                                 

   6

   Copy to Clipboard Toggle word wrap

   1

   이미지 세트 메타데이터를 저장할 백엔드 위치를 설정합니다. 이 위치는 레지스트리 또는 로컬 디렉터리일 수 있습니다. storageConfig 값을 지정해야 합니다.

   2

   선택적으로 registry.redhat.io 에서 미러링할 OpenShift Container Platform 릴리스를 포함합니다.

   3

   디스크의 OCI 카탈로그 위치에 대한 절대 경로를 지정합니다. OCI 기능을 사용하는 경우 경로는 oci:// 로 시작해야 합니다.

   4

   필요한 경우 카탈로그를 미러링할 대체 네임스페이스와 이름을 지정합니다.

   5

   필요한 경우 레지스트리에서 가져올 추가 Operator 카탈로그를 지정합니다.

   6

   선택적으로 레지스트리에서 가져올 추가 이미지를 지정합니다.

2. oc mirror 명령을 실행하여 OCI 카탈로그를 대상 미러 레지스트리에 미러링합니다.

   $ oc mirror --config=./imageset-config.yaml \ 

   1

   
     docker://registry.example:5000              

   2

   Copy to Clipboard Toggle word wrap

   1

   이미지 세트 구성 파일을 전달합니다. 이 절차에서는 imageset-config.yaml 이라는 이름을 가정합니다.

   2

   콘텐츠를 미러링할 레지스트리를 지정합니다. 레지스트리는 docker:// 로 시작해야 합니다. 미러 레지스트리에 최상위 네임스페이스를 지정하는 경우 후속 실행 시 동일한 네임스페이스를 사용해야 합니다.

   선택적으로 다른 플래그를 지정하여 OCI 기능의 동작을 조정할 수 있습니다.

   --oci-insecure-signature-policy

   서명을 대상 미러 레지스트리로 내보내지 마십시오.

   --oci-registries-config

   TOML 형식의 registries.conf 파일의 경로를 지정합니다. 이미지 세트 구성 파일을 변경하지 않고도 테스트를 위한 사전 프로덕션 위치와 같은 다른 레지스트리에서 미러링할 수 있습니다. 이 플래그는 다른 미러링된 콘텐츠가 아닌 로컬 OCI 카탈로그에만 영향을 미칩니다.

   registries.conf 파일 예

   [[registry]]
    location = "registry.redhat.io:5000"
    insecure = false
    blocked = false
    mirror-by-digest-only = true
    prefix = ""
    [[registry.mirror]]
       location = "preprod-registry.example.com"
       insecure = false

   Copy to Clipboard Toggle word wrap