연결이 끊긴 환경

프로세스

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

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

   $ tar xvf <file>

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

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

   $ echo $PATH

프로세스

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

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

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

   C:\> path

프로세스

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

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

   참고

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

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

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

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

   $ echo $PATH

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

2. 다음 방법 중 하나를 사용하여 대상 미러 레지스트리에 설정된 이미지를 미러링합니다.

   • 대상 미러 레지스트리에 직접 설정된 이미지를 미러링합니다.
   • 이미지를 디스크에 미러링하고 대상 환경으로 설정된 이미지를 전송한 다음 대상 미러 레지스트리에 설정된 이미지를 업로드합니다.
3. oc-mirror 플러그인에서 생성한 리소스를 사용하도록 클러스터를 구성합니다.
4. 필요에 따라 대상 미러 레지스트리를 업데이트하려면 다음 단계를 반복합니다.

프로세스

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

   1. Red Hat Hybrid Cloud Console의 다운로드 페이지로 이동합니다.
   2. OpenShift 연결 설치 툴 섹션의 드롭다운 메뉴에서 OpenShift Client(oc) 미러 플러그인 의 OS 유형 및 아키텍처 유형을 선택합니다.
   3. 다운로드를 클릭하여 파일을 저장합니다.

2. 다음 명령을 실행하여 아카이브의 압축을 풉니다.

   $ tar xvzf oc-mirror.tar.gz

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

   $ chmod +x oc-mirror

   참고

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

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

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

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

2. 다음 명령을 실행하여 풀 시크릿을 JSON 형식으로 복사합니다.

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

   1

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

   pull secret의 예

   {
     "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. 파일을 ~/.docker/config.json 또는 $XDG_RUNTIME_DIR/containers/auth.json 으로 저장합니다.

   1. .docker 또는 $XDG_RUNTIME_DIR/containers 디렉터리가 없는 경우 다음 명령을 입력하여 만듭니다.

      $ mkdir -p <directory_name>

      여기서 <directory_name>은 ~/.docker 또는 $XDG_RUNTIME_DIR/containers 입니다.

   2. 다음 명령을 입력하여 풀 시크릿을 적절한 디렉터리에 복사합니다.

      $ cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>

      여기서 <directory_name>은 ~/.docker 또는 $XDG_RUNTIME_DIR/containers 이며 <auth_file>은 config.json 또는 auth.json 입니다.

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

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

   1

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

   출력 예

   BGVtbYk3ZHAtqXs=

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

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

   1

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

   2

   미러 레지스트리에 대해 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. 이미지 세트 구성 파일을 생성합니다.

2. 다음 워크플로우 중 하나를 사용하여 대상 미러 레지스트리에 설정된 이미지를 미러링합니다.

   • 대상 미러 레지스트리(mirror to mirror)에 직접 설정된 이미지를 미러링합니다.
   • 이미지 세트를 디스크로 미러링하고, tar 파일을 대상 환경으로 전송한 다음, 대상 미러 레지스트리로 설정된 이미지를 미러링합니다(디스크를 미러링할 디스크).
3. oc-mirror 플러그인 v2에서 생성한 리소스를 사용하도록 클러스터를 구성합니다.
4. 필요에 따라 대상 미러 레지스트리를 업데이트하려면 다음 단계를 반복합니다.

프로세스

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

   1. Red Hat Hybrid Cloud Console의 다운로드 페이지로 이동합니다.
   2. OpenShift 연결 설치 툴 섹션의 드롭다운 메뉴에서 OpenShift Client(oc) 미러 플러그인 의 OS 유형 및 아키텍처 유형을 선택합니다.
   3. 다운로드를 클릭하여 파일을 저장합니다.

2. 다음 명령을 실행하여 아카이브의 압축을 풉니다.

   $ tar xvzf oc-mirror.tar.gz

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

   $ chmod +x oc-mirror

   참고

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

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

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

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

2. 다음 명령을 실행하여 풀 시크릿을 JSON 형식으로 복사합니다.

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

   1

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

   pull secret의 예

   {
     "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. $XDG_RUNTIME_DIR/containers 디렉터리가 없는 경우 다음 명령을 입력하여 만듭니다.

   $ mkdir -p $XDG_RUNTIME_DIR/containers

4. 풀 시크릿 파일을 $XDG_RUNTIME_DIR/containers/auth.json 로 저장합니다.

5. 다음 명령을 실행하여 미러 레지스트리에 대한 base64로 인코딩된 사용자 이름 및 암호 또는 토큰을 생성합니다.

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

   1

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

   출력 예

   BGVtbYk3ZHAtqXs=

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

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

   1

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

   2

   미러 레지스트리에 대해 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. < file_path> 디렉터리에 생성된 working-dir/cluster-resources 디렉터리로 이동합니다.
2. ImageDigestMirrorSet,ImageTagMirrorSet, CatalogSource 리소스에 YAML 파일이 있는지 확인합니다.

1. mirror to disk: 이미지 세트를 아카이브로 미러링합니다.
2. 디스크 전송: 압축 파일을 연결이 끊긴 미러 레지스트리의 네트워크로 수동으로 전송합니다.
3. Disk to mirror: 아카이브에서 대상 연결이 끊긴 레지스트리로 이미지 세트를 미러링합니다.

프로세스

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

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

   $ oc apply -f <path_to_oc_mirror_workspace>/working-dir/cluster-resources

검증

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

   $ oc get imagedigestmirrorset

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

   $ oc get imagetagmirrorset

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

   $ oc get catalogsource -n openshift-marketplace

프로세스

1. delete-image-set-config.yaml 파일을 생성하고 다음 콘텐츠를 포함합니다.

   DeleteImageSetConfiguration 파일

   apiVersion: mirror.openshift.io/v2alpha1
   kind: DeleteImageSetConfiguration
   delete:
     platform:
       channels:
         - name: <channel_name> 1
           minVersion: <channel_min_version> 2
           maxVersion: <channel_max_version> 3
     operators:
       - catalog: <operator_catalog_name> 4
         packages:
         - name: <operator_name> 5
            minVersion: <operator_max_version> 6
            maxVersion: <operator_min_version> 7
     additionalImages:
       - name: <additional_images> 8

   1 1

   삭제할 OpenShift Container Platform 채널의 이름을 지정합니다(예: stable-4.15 ).

   2 3

   채널 내에서 삭제할 이미지의 버전 범위를 지정합니다(예: 최소 버전의 경우 4.15.0, 최대 버전의 경우 4.1 5.1). 하나의 버전 이미지만 삭제하려면 minVersion 및 maxVersion 필드 모두에 해당 버전 번호를 사용합니다.

   4

   삭제할 Operator 카탈로그 이미지를 지정합니다(예: registry.redhat.io/redhat/redhat-operator-index:v4.14 ). 카탈로그 이미지를 삭제하려면 delete.operators.packages 매개변수를 사용하여 개별 Operator를 지정할 수 없습니다.

   5

   삭제할 특정 Operator 번들을 지정합니다(예: aws-load-balancer-operator ). 개별 Operator를 지정하면 Operator 카탈로그 이미지가 삭제되지 않습니다.

   6 7

   Operator에 대해 삭제할 이미지의 버전 범위를 지정합니다(예: 최소 버전의 경우 0.0. 1, 최대 버전의 경우 0 . 0.2)입니다. 하나의 버전 이미지만 삭제하려면 minVersion 및 maxVersion 필드 모두에 해당 버전 번호를 사용합니다.

   8

   삭제할 추가 이미지를 지정합니다(예: registry.redhat.io/ubi9/ubi-init:latest ).

2. 다음 명령을 실행하여 delete-images.yaml 파일을 생성합니다.

   $ oc mirror delete --config delete-image-set-config.yaml --workspace file://<previously_mirrored_work_folder> --v2 --generate docker://<remote_registry>

   다음과 같습니다.

   <previously_mirrored_work_folder>

   미러링 프로세스 중에 이미지가 이전에 미러링되었거나 저장된 디렉터리를 지정합니다.

   <remote_registry>

   이미지를 삭제할 원격 컨테이너 레지스트리의 URL 또는 주소를 지정합니다.

3. 생성된 &lt ;previously_mirrored_work_folder>/delete 디렉터리로 이동합니다.
4. delete-images.yaml 파일이 생성되었는지 확인합니다.
5. 파일에 나열된 각 이미지가 더 이상 클러스터에 필요하지 않으며 레지스트리에서 안전하게 제거할 수 있는지 수동으로 확인합니다.

6. delete-images YAML 파일을 생성한 후 다음 명령을 실행하여 원격 레지스트리에서 이미지를 삭제합니다.

   $ oc mirror delete --v2 --delete-yaml-file <previously_mirrored_work_folder>/working-dir/delete/delete-images.yaml docker://<remote_registry>

   다음과 같습니다.

   <previously_mirrored_work_folder>

   미러링 프로세스 중에 이미지가 이전에 미러링되었거나 저장된 디렉터리를 지정합니다.

   <remote_registry>

   이미지를 삭제할 원격 컨테이너 레지스트리의 URL 또는 주소를 지정합니다.

   중요

   mirror-to-mirror 방법을 사용하여 이미지를 미러링할 때 이미지가 로컬에 캐시되지 않으므로 로컬 캐시에서 이미지를 삭제할 수 없습니다.

검증

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

   $ cd <oc_mirror_workspace_path>

2. 생성된 mapping.txt 및 missing.txt 파일을 검토합니다. 이러한 파일에는 미러링된 모든 이미지 목록이 포함되어 있습니다.

프로세스

1. 서버 관련 문제를 확인합니다.

   오류 예

   [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

   1. oc-mirror 플러그인 v2 출력 디렉터리에 있는 working-dir/logs 폴더에서 mirroring_error_date_time.log 파일을 엽니다.
   2. HTTP 500 오류, 만료된 토큰 또는 타임아웃과 같이 일반적으로 서버 측 문제를 나타내는 오류 메시지를 찾습니다.
   3. 문제가 지속되면 미러링 프로세스 다시 시도하거나 지원에 문의합니다.

2. Operator의 불완전한 미러링을 확인합니다.

   오류 예

   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

   1. 콘솔 또는 로그 파일에서 불완전한 Operator를 나타내는 경고를 확인합니다.

      Operator가 불완전한 것으로 표시되는 경우 해당 Operator와 관련된 이미지를 미러링하지 못할 수 있습니다.

   2. 누락된 이미지를 수동으로 미러링하거나 미러링 프로세스를 다시 시도합니다.

3. 생성된 클러스터 리소스와 관련된 오류가 있는지 확인합니다. 일부 이미지가 미러링되지 않더라도 oc-mirror v2는 성공적으로 미러링된 이미지에 대한 IDMS.yaml 및 ITMS.yaml 파일과 같은 클러스터 리소스를 계속 생성합니다.

   1. 생성된 파일의 출력 디렉터리를 확인합니다.
   2. 이러한 파일이 특정 이미지에 대해 누락된 경우 미러링 프로세스 중에 해당 이미지에 대한 중요한 오류가 발생하지 않았는지 확인합니다.

1. 사용자는 oc-mirror 플러그인 v2를 실행하여 온라인 레지스트리의 콘텐츠를 로컬 디스크 디렉터리로 미러링합니다.
2. 미러링된 콘텐츠는 오프라인 환경으로 전송하기 위해 디스크에 저장됩니다.

프로세스

1. 연결이 끊긴 환경에서 oc-mirror 플러그인 v2를 실행하기 전에 registries.conf 파일을 생성합니다. 파일의 TOML 형식은 이 사양에 설명되어 있습니다.

   참고

   $HOME/.config/containers/registries.conf 또는 /etc/containers/registries.conf 아래에 파일을 저장하는 것이 좋습니다.

   registries.conf예

   [[registry]]
   location="registry.redhat.io"
   [[registry.mirror]]
   location="<enterprise-registry.in>"
   
   [[registry]]
   location="quay.io"
   [[registry.mirror]]
   location="<enterprise-registry.in>"

2. 미러 아카이브를 생성합니다.

   1. 모든 OpenShift Container Platform 콘텐츠를 < file_path>/enterprise-content 아래의 아카이브로 수집하려면 다음 명령을 실행합니다.

      $ oc mirror --v2 -c isc.yaml file://<file_path>/enterprise-content

      isc.yaml의 예

      apiVersion: mirror.openshift.io/v2alpha1
      kind: ImageSetConfiguration
      mirror:
        platform:
          architectures:
            - "amd64"
          channels:
            - name: stable-4.15
              minVersion: 4.15.0
              maxVersion: 4.15.3

      아카이브가 생성되면 연결이 끊긴 환경으로 전송됩니다. 전송 메커니즘은 oc-mirror 플러그인 v2의 일부가 아닙니다. 엔터프라이즈 네트워크 관리자는 전송 전략을 결정합니다.

      경우에 따라 디스크가 물리적으로 한 위치에서 연결 해제되고 연결이 끊긴 환경의 다른 컴퓨터에 연결되어 있음을 전송이 수동으로 수행됩니다. 다른 경우에는 FTP(Secure File Transfer Protocol) 또는 기타 프로토콜이 사용됩니다.

3. 아카이브 전송이 완료되면 다음 예에 설명된 대로 관련 아카이브 콘텐츠를 레지스트리(예의entrerpise_registry.in )에 미러링하기 위해 oc-mirror 플러그인 v2를 다시 실행할 수 있습니다.

   $ oc mirror --v2 -c isc.yaml --from file://<disconnected_environment_file_path>/enterprise-content docker://<enterprise_registry.in>/

   다음과 같습니다.

   • --from 은 아카이브가 포함된 폴더를 가리킵니다. file:// 로 시작합니다.
   • docker:// 는 미러링의 대상이 최종 인수입니다. 이는 docker 레지스트리이기 때문입니다.
   • -c (--config)는 필수 인수입니다. oc-mirror 플러그인 v2가 결국 아카이브의 하위 부분만 레지스트리에 미러링할 수 있습니다. 하나의 아카이브에는 여러 OpenShift Container Platform 릴리스가 포함될 수 있지만 연결이 끊긴 환경 또는 enclave는 몇 개만 미러링할 수 있습니다.

4. enclave에 미러링할 콘텐츠를 설명하는 imageSetConfig YAML 파일을 준비합니다.

   isc-enclave.yaml의 예

   apiVersion: mirror.openshift.io/v2alpha1
   kind: ImageSetConfiguration
   mirror:
     platform:
       architectures:
         - "amd64"
       channels:
         - name: stable-4.15
           minVersion: 4.15.2
           maxVersion: 4.15.2

   연결이 끊긴 레지스트리에 액세스할 수 있는 머신에서 oc-mirror 플러그인 v2를 실행해야 합니다. 이전 예에서 연결이 끊긴 환경 enterprise-registry.in 에 액세스할 수 있습니다.

5. 그래프 URL 업데이트

   graph:true 를 사용하는 경우 oc-mirror 플러그인 v2는 cincinnati API 끝점에 도달하려고 시도합니다. 이 환경의 연결이 끊어지면 UPDATE_URL_OVERRIDE 환경 변수 OSUS(OpenShift Update Service)의 URL을 참조하도록 환경 변수 UPDATE_URL_OVERRIDE를 내보내야 합니다.

   $ export UPDATE_URL_OVERRIDE=https://<osus.enterprise.in>/graph

   OpenShift 클러스터에서 OSUS를 설정하는 방법에 대한 자세한 내용은 "OpenShift Update Service를 사용하여 연결이 끊긴 환경에서 클러스터 업그레이드"를 참조하십시오.

   참고

   OpenShift Container Platform EUS (Extended Update Support) 버전 간에 업데이트할 때 현재 버전과 대상 버전 간의 중간 마이너 버전에 대한 이미지도 포함해야 합니다. oc-mirror 플러그인 v2가 항상 이 요구 사항을 자동으로 감지하지는 않을 수 있으므로 Red Hat OpenShift Container Platform Update Graph 페이지를 확인하여 필요한 중간 버전을 확인합니다.

   Update Graph 페이지를 사용하여 애플리케이션에서 제안된 중간 마이너 버전을 찾고 oc-mirror 플러그인 v2를 사용할 때 ImageSetConfiguration 파일에 이러한 버전을 포함합니다.

6. enclave의 엔터프라이즈 레지스트리에서 미러 아카이브를 생성합니다.

   enclave1 용 아카이브를 준비하기 위해 사용자는 해당 enclave에 특정한 imageSetConfiguration 을 사용하여 엔터프라이즈 연결이 끊긴 환경에서 oc-mirror 플러그인 v2를 실행합니다. 이렇게 하면 enclave에 필요한 이미지만 미러링됩니다.

   $ oc mirror --v2 -c isc-enclave.yaml
   file:///disk-enc1/

   이 작업은 모든 OpenShift Container Platform 콘텐츠를 아카이브로 수집하고 디스크에 아카이브를 생성합니다.

7. 아카이브가 생성되면 enclave1 네트워크로 전송됩니다. 전송 메커니즘은 oc-mirror 플러그인 v2의 책임이 아닙니다.

8. enclave 레지스트리에 콘텐츠를 미러링

   아카이브 전송이 완료되면 사용자는 관련 아카이브 콘텐츠를 레지스트리에 미러링하기 위해 oc-mirror 플러그인 v2를 다시 실행할 수 있습니다.

   $ oc mirror --v2 -c isc-enclave.yaml --from file://local-disk docker://registry.enc1.in

   enclave1 의 OpenShift Container Platform 클러스터 관리자는 이제 해당 클러스터를 설치하거나 업그레이드할 준비가 되었습니다.

프로세스

1. Red Hat OpenShift Container Platform Update Graph 시각화 프로그램 및 업데이트 플래너 를 사용하여 한 버전에서 다른 버전으로 업데이트를 계획합니다. OpenShift Update Graph는 채널 그래프와 현재 클러스터 버전과 의도한 클러스터 버전 간에 업데이트 경로가 있는지 확인하는 방법을 제공합니다.

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

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

      $ export OCP_RELEASE=<release_version>

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

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

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

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

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

      $ LOCAL_REPOSITORY='<local_repository_name>'

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

   4. OpenShift Update Service를 사용하는 경우 릴리스 이미지를 포함하도록 추가 로컬 리포지토리 이름을 내보냅니다.

      $ LOCAL_RELEASE_IMAGES_REPOSITORY='<local_release_images_repository_name>'

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

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

      $ PRODUCT_REPO='openshift-release-dev'

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

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

      $ LOCAL_SECRET_JSON='<path_to_pull_secret>'

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

      참고

      클러스터에서 ImageContentSourcePolicy 오브젝트를 사용하여 저장소 미러링을 구성하는 경우 미러링된 레지스트리에 대한 글로벌 풀 시크릿만 사용할 수 있습니다. 프로젝트에 풀 시크릿을 추가할 수 없습니다.

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

      $ RELEASE_NAME="ocp-release"

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

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

      $ ARCHITECTURE=<cluster_architecture> 1

      1

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

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

      $ REMOVABLE_MEDIA_PATH=<path> 1

      1

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

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

   $ 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

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

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

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

     2. 이미지 및 설정 매니페스트를 이동식 미디어의 디렉토리에 미러링합니다.

        $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}

        참고

        이 명령은 미러링된 릴리스 이미지 서명 구성 맵을 생성하고 이동식 미디어에 저장합니다.

     3. 미디어를 연결이 끊긴 환경으로 가져와서 이미지를 로컬 컨테이너 레지스트리에 업로드합니다.

        $ oc image mirror  -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} 1

        1

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

     4. oc CLI(명령줄 인터페이스)를 사용하여 업데이트 중인 클러스터에 로그인합니다.

     5. 미러링된 릴리스 이미지 서명 config map을 연결된 클러스터에 적용합니다.

        $ oc apply -f ${REMOVABLE_MEDIA_PATH}/mirror/config/<image_signature_file> 1

        1

        < image_signature_file >의 경우 파일의 경로와 이름을 지정합니다(예: signature-sha256-81154f5c03294534.yaml ).

     6. OpenShift Update Service를 사용하는 경우 릴리스 이미지를 별도의 저장소에 미러링합니다.

        $ oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}

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

     1. 릴리스 이미지를 로컬 레지스트리로 직접 푸시하고 다음 명령을 사용하여 구성 맵을 클러스터에 적용합니다.

        $ 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

        참고

        --apply-release-image-signature 옵션이 포함된 경우 이미지 서명 확인을 위해 config map을 작성하지 않습니다.

     2. OpenShift Update Service를 사용하는 경우 릴리스 이미지를 별도의 저장소에 미러링합니다.

        $ oc image mirror -a ${LOCAL_SECRET_JSON} ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE} ${LOCAL_REGISTRY}/${LOCAL_RELEASE_IMAGES_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}

프로세스

1. 웹 콘솔에서 Operator → OperatorHub를 클릭합니다.

   참고

   Update Service를 키워드로 필터링…​ 필드에 입력하여 Operator를 더 빠르게 찾습니다.

2. 사용 가능한 Operator 목록에서 OpenShift Update Service를 선택한 다음 설치를 클릭합니다.

   1. 업데이트 채널을 선택합니다.
   2. 버전을 선택합니다.
   3. 설치 모드에서 클러스터의 특정 네임스페이스를 선택합니다.
   4. 설치된 네임스페이스의 네임스페이스를 선택하거나 권장 네임스페이스 openshift-update-service를 수락합니다.

   5. 업데이트 승인 전략을 선택합니다.

      • 자동 전략을 사용하면 Operator 새 버전이 준비될 때 OLM(Operator Lifecycle Manager)이 자동으로 Operator를 업데이트할 수 있습니다.
      • 수동 전략을 사용하려면 클러스터 관리자가 Operator 업데이트를 승인해야 합니다.
   6. 설치를 클릭합니다.
3. Operator → 설치된 Operator 로 이동하여 OpenShift Update Service Operator가 설치되었는지 확인합니다.
4. OpenShift Update Service 가 올바른 네임스페이스에 성공 상태로 나열되어 있는지 확인합니다.

프로세스

1. OpenShift OpenShift Update Service Operator의 네임스페이스를 생성합니다.

   1. OpenShift Update Service Operator에 대해 Namespace 오브젝트 YAML 파일 (예: update-service-namespace.yaml)을 만듭니다.

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-update-service
        annotations:
          openshift.io/node-selector: ""
        labels:
          openshift.io/cluster-monitoring: "true" 1

      1

      이 네임스페이스에서 Operator가 권장하는 클러스터 모니터링을 사용하도록 하려면 openshift.io/cluster-monitoring 레이블을 설정합니다.

   2. 네임스페이스를 생성합니다.

      $ oc create -f <filename>.yaml

      예를 들면 다음과 같습니다.

      $ oc create -f update-service-namespace.yaml

2. 다음 오브젝트를 생성하여 OpenShift Update Service Operator를 설치합니다.

   1. OperatorGroup 오브젝트 YAML 파일을 만듭니다 (예: update-service-operator-group.yaml).

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: update-service-operator-group
        namespace: openshift-update-service
      spec:
        targetNamespaces:
        - openshift-update-service

   2. OperatorGroup 오브젝트를 생성합니다.

      $ oc -n openshift-update-service create -f <filename>.yaml

      예를 들면 다음과 같습니다.

      $ oc -n openshift-update-service create -f update-service-operator-group.yaml

   3. Subscription 오브젝트 YAML 파일(예: update-service-subscription.yaml)을 생성합니다.

      서브스크립션의 예

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: update-service-subscription
        namespace: openshift-update-service
      spec:
        channel: v1
        installPlanApproval: "Automatic"
        source: "redhat-operators" 1
        sourceNamespace: "openshift-marketplace"
        name: "cincinnati-operator"

      1

      Operator를 제공하는 카탈로그 소스의 이름을 지정합니다. 사용자 정의 OLM(Operator Lifecycle Manager)을 사용하지 않는 클러스터의 경우 redhat-operators를 지정합니다. OpenShift Container Platform 클러스터가 연결이 끊긴 환경에 설치된 경우 OLM(Operator Lifecycle Manager)을 구성할 때 생성된 CatalogSource 오브젝트의 이름을 지정합니다.

   4. Subscription 오브젝트를 생성합니다.

      $ oc create -f <filename>.yaml

      예를 들면 다음과 같습니다.

      $ oc -n openshift-update-service create -f update-service-subscription.yaml

      OpenShift Update Service Operator는 openshift-update-service 네임스페이스에 설치되고 openshift-update-service 네임스페이스를 대상으로 합니다.

3. Operator 설치를 확인합니다.

   $ oc -n openshift-update-service get clusterserviceversions

   출력 예

   NAME                             DISPLAY                    VERSION   REPLACES   PHASE
   update-service-operator.v4.6.0   OpenShift Update Service   4.6.0                Succeeded
   ...

   OpenShift Update Service Operator가 나열된 경우 설치에 성공한 것입니다. 버전 번호가 표시된 것과 다를 수 있습니다.

프로세스

1. 웹 콘솔에서 Operator → Installed Operator를 클릭합니다.
2. 설치된 Operator 목록에서 OpenShift Update Service를 선택합니다.
3. Update Service 탭을 클릭합니다.
4. Create UpdateService를 클릭합니다.
5. Name 필드에 이름을 입력합니다. (예: service)
6. 그래프 데이터 이미지 필드에 "OpenShift Update Service 그래프 데이터 컨테이너 이미지 생성"에서 생성된 그래프 데이터 컨테이너 이미지에 로컬 pullspec을 입력합니다(예: registry.example.com/openshift/graph-data:latest ).
7. 릴리스 필드에 "OpenShift Container Platform 이미지 리포지토리 미러링"의 릴리스 이미지를 포함하도록 생성된 레지스트리 및 리포지토리를 입력합니다(예: registry.example.com/ocp4/openshift4-release-images ).
8. Replicas 필드에 2를 입력합니다.
9. Create를 클릭하여 OpenShift Update Service 애플리케이션을 생성합니다.

10. OpenShift Update Service 애플리케이션 확인

    • Update Service 탭의 UpdateServices 목록에서 방금 만든 업데이트 서비스 애플리케이션을 클릭합니다.
    • Resources 탭을 클릭합니다.
    • 각 애플리케이션 리소스의 상태가 Created인지 확인합니다.

프로세스

1. OpenShift Update Service 대상 네임스페이스를 구성합니다(예: openshift-update-service ).

   $ NAMESPACE=openshift-update-service

   네임스페이스는 Operator 그룹의 targetNamespaces 값과 일치해야 합니다.

2. OpenShift Update Service 애플리케이션의 이름을 구성합니다(예: service ).

   $ NAME=service

3. "OpenShift Container Platform 이미지 리포지토리 미러링"에 구성된 릴리스 이미지의 레지스트리 및 리포지토리를 구성합니다(예: registry.example.com/ocp4/openshift4-release-images ).

   $ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images

4. 그래프 데이터 이미지의 로컬 pullspec을 "OpenShift Update Service 그래프 데이터 컨테이너 이미지 생성"에서 생성된 그래프 데이터 컨테이너 이미지로 설정합니다(예: registry.example.com/openshift/graph-data:latest ).

   $ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest

5. OpenShift Update Service 애플리케이션 오브젝트를 생성합니다.

   $ oc -n "${NAMESPACE}" create -f - <<EOF
   apiVersion: updateservice.operator.openshift.io/v1
   kind: UpdateService
   metadata:
     name: ${NAME}
   spec:
     replicas: 2
     releases: ${RELEASE_IMAGES}
     graphDataImage: ${GRAPH_DATA_IMAGE}
   EOF

6. OpenShift Update Service 애플리케이션 확인

   1. 다음 명령을 사용하여 정책 엔진 경로를 가져옵니다.

      $ 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

      명령이 성공할 때까지 폴링해야 할 수도 있습니다.

   2. 정책 엔진에서 그래프를 검색합니다. channel에 유효한 버전을 지정해야 합니다. 예를 들어 OpenShift Container Platform 4.17에서 실행하는 경우 stable-4.17 을 사용합니다.

      $ 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

      이 경우 그래프 요청이 성공할 때까지 폴링되지만 미러링된 릴리스 이미지에 따라 결과 그래프가 비어 있을 수 있습니다.