13.2. OpenShift Container Platform 이미지 저장소 미러링

프로세스

1. Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
2. Product Variant 드롭다운 목록에서 아키텍처를 선택합니다.
3. 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
4. OpenShift v4.12 Linux Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.

5. 아카이브의 압축을 풉니다.

   $ tar xvf <file>

6. oc 바이너리를 PATH에 있는 디렉터리에 배치합니다.

   PATH를 확인하려면 다음 명령을 실행합니다.

   $ echo $PATH

프로세스

1. Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
2. 버전 드롭다운 목록에서 적절한 버전을 선택합니다.
3. OpenShift v4.12 Windows Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.
4. ZIP 프로그램으로 아카이브의 압축을 풉니다.

5. oc 바이너리를 PATH에 있는 디렉터리로 이동합니다.

   PATH를 확인하려면 명령 프롬프트를 열고 다음 명령을 실행합니다.

   C:\> path

프로세스

1. Red Hat 고객 포털에서 OpenShift Container Platform 다운로드 페이지로 이동합니다.
2. 버전 드롭다운 목록에서 적절한 버전을 선택합니다.

3. OpenShift v4.12 macOS Client 항목 옆에 있는 지금 다운로드를 클릭하고 파일을 저장합니다.

   참고

   macOS ARM64의 경우 OpenShift v4.12 macOS ARM64 Client 항목을 선택합니다.

4. 아카이브의 압축을 해제하고 압축을 풉니다.

5. oc 바이너리 PATH의 디렉터리로 이동합니다.

   PATH를 확인하려면 터미널을 열고 다음 명령을 실행합니다.

   $ echo $PATH

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

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

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

   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"
       }
     }
   }

3. 선택 사항: oc-mirror 플러그인을 사용하는 경우 파일을 ~/.docker/config.json 또는 $XDG_RUNTIME_DIR/containers/auth.json 로 저장합니다.

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

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

   1

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

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

     "auths": {
       "<mirror_registry>": { 1
         "auth": "<credentials>", 2
         "email": "you@example.com"
       }
     },

   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"
       }
     }
   }

프로세스

1. oc-mirror CLI 플러그인을 다운로드합니다.

   1. OpenShift Cluster Manager 하이브리드 클라우드 콘솔 의 다운로드 페이지로 이동합니다.
   2. OpenShift 연결 설치 툴 섹션에서 OpenShift Client(oc) 미러 플러그인 다운로드를 클릭하고 파일을 저장합니다.

2. 아카이브를 추출합니다.

   $ tar xvzf oc-mirror.tar.gz

3. 필요한 경우 플러그인 파일을 실행 가능하게 업데이트합니다.

   $ chmod +x oc-mirror

   참고

   oc-mirror 파일의 이름을 바꾸지 마십시오.

4. 파일을 PATH 에 배치하여 oc-mirror CLI 플러그인을 설치합니다(예: /usr/local/bin ).

   $ sudo mv oc-mirror /usr/local/bin/.

프로세스

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

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

   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.12                                             4
         type: ocp
       graph: true                                                     5
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.12  6
       packages:
       - name: serverless-operator                                     7
         channels:
         - name: stable                                                8
     additionalImages:
     - name: registry.redhat.io/ubi8/ubi:latest                        9
     helm: {}

   1

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

   2

   이미지 세트 메타데이터를 저장할 백엔드 위치를 설정합니다. 이 위치는 레지스트리 또는 로컬 디렉터리일 수 있습니다. 기술 프리뷰 OCI 기능을 사용하지 않는 한 storageConfig 값을 지정해야 합니다.

   3

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

   4

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

   5

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

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

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

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

프로세스

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

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

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

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

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

   참고

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

검증

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

   $ oc get imagecontentsourcepolicy

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

   $ oc get catalogsource -n openshift-marketplace

프로세스

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

   $ oc mirror --config=./imageset-config.yaml \1
     docker://registry.example:5000            \2
     --dry-run                                  3

   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

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

   $ cd oc-mirror-workspace/

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

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

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

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

   참고

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

프로세스

1. 선택 사항: 필요한 카탈로그 및 이미지를 확인하고 디스크에 저장합니다. 디스크의 OCI 형식으로 카탈로그 이미지가 이미 있는 경우 이 단계를 건너뛸 수 있습니다.

   1. 이미지 세트 구성 파일을 생성합니다.

      디스크에 복사하기 위한 이미지 세트 구성 파일의 예

      kind: ImageSetConfiguration
      apiVersion: mirror.openshift.io/v1alpha2
      mirror:
       operators:
       - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.12
         packages:
         - name: aws-load-balancer-operator

      참고

      OCI 기능을 사용하는 경우 mirror.operators.catalog 설정만 사용할 수 있습니다.

      storageConfig 설정은 oc mirror 명령에 전달된 위치 대신 무시됩니다.

   2. oc mirror 명령을 실행하여 지정된 이미지 세트 구성의 이미지를 디스크로 미러링합니다.

      $ oc mirror --config=./imageset-config.yaml \ 1
        --use-oci-feature \                         2
        --oci-feature-action=copy \                 3
        oci://my-oci-catalog                        4

      1

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

      2

      --use-oci-feature 플래그를 사용하여 OCI 기능을 활성화합니다.

      3

      카탈로그를 디스크에 복사하려면 --oci-feature-action 플래그를 copy 로 설정합니다.

      4

      카탈로그를 출력할 디스크의 디렉터리를 지정합니다. 이 절차에서는 이름이 my-oci-catalog 라고 가정합니다. 경로는 oci:// 로 시작해야 합니다. 지정된 디렉터리가 전체 경로가 아닌 경우 oc mirror 명령이 실행되는 현재 작업 디렉터리에 디렉터리가 생성됩니다.

      참고

      선택 옵션으로 --oci-registries-config 플래그를 사용하여 TOML 형식의 registries.conf 파일의 경로를 지정할 수 있습니다. 이를 사용하여 이미지 세트 구성 파일을 변경하지 않고도 테스트를 위한 사전 프로덕션 위치와 같은 다른 레지스트리에서 미러링할 수 있습니다.

      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

      registry.mirror 섹션의 location 필드를 이미지를 가져올 대체 레지스트리 위치로 설정합니다. 레지스트리 섹션의 location 필드는 이미지 세트 구성 파일에서 지정한 레지스트리 위치와 동일해야 합니다.

   3. 디렉터리 내용을 나열하고 다음 디렉터리가 생성되었는지 확인합니다.

      $ ls -l

      출력 예

      my-oci-catalog      1
      oc-mirror-workspace 2
      olm_artifacts       3

      1

      OCI 카탈로그가 포함된 디렉터리입니다. 이 절차에서는 이름이 my-oci-catalog 라고 가정합니다.

      2

      카탈로그의 각 이미지가 원래 형식으로 포함된 디렉터리입니다.

      3

      이 카탈로그에서 참조하는 Operator 번들을 설명하는 파일이 포함된 디렉터리입니다.

2. 이미지 세트 구성 파일을 업데이트하여 대상 미러 레지스트리에 미러링할 디스크의 카탈로그 위치를 지정합니다.

   미러링을 미러링하기 위한 이미지 세트 구성 파일의 예

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   mirror:
    operators:
    - catalog: oci:///home/user/oc-mirror/my-oci-catalog/redhat-operator-index 1
      packages:
      - name: aws-load-balancer-operator

   1

   디스크에서 OCI 카탈로그 위치의 절대 경로를 지정합니다. 이 절차에서는 my-oci-catalog 를 디렉터리로 사용하고 redhat-operator-index 카탈로그를 미러링했다고 가정합니다. 경로는 oci:// 로 시작해야 합니다.

3. oc mirror 명령을 실행하여 디스크에서 이미지 세트 파일을 처리하고 콘텐츠를 대상 미러 레지스트리에 미러링합니다.

   $ oc mirror --config=./imageset-config.yaml \ 1
     --use-oci-feature \                         2
     --oci-feature-action=mirror \               3
     docker://registry.example:5000              4

   1

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

   2

   --use-oci-feature 플래그를 사용하여 OCI 기능을 활성화합니다.

   3

   카탈로그를 대상 미러 레지스트리에 미러링하려면 --oci-feature-action 플래그를 mirror 로 설정합니다.

   4

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

   참고

   선택적으로 --oci-insecure-signature-policy 플래그를 사용하여 대상 미러 레지스트리로 서명을 푸시하지 않을 수 있습니다.