Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

5.7. 미러링을 위해 선택한 이미지 확인

oc-mirror 플러그인 v2를 사용하면 실제로 이미지를 미러링하지 않는 테스트 실행(드라이 런)을 수행할 수 있습니다. 이를 통해 미러링될 이미지 목록을 검토할 수 있습니다. 또한, 드라이런을 사용하여 이미지 세트 구성의 오류를 일찍 포착할 수도 있습니다. 디스크 미러링 워크플로우에서 드라이런을 실행할 때, oc-mirror 플러그인 v2는 이미지 세트 내의 모든 이미지가 캐시에 있는지 확인합니다. 누락된 이미지는 missing.txt 파일에 나열되어 있습니다. 미러링 전에 드라이런을 수행하면 missing.txt 파일과 mapping.txt 파일에 모두 동일한 이미지 목록이 포함됩니다.

5.7.1. oc-mirror 플러그인 v2의 예행 실행 수행
링크 복사

이미지를 미러링하지 않고 테스트 실행을 수행하여 이미지 세트 구성을 확인합니다. 이렇게 하면 설정이 올바른지 확인하고 의도치 않은 변경을 방지할 수 있습니다.

프로세스

  • 테스트 실행을 수행하려면 oc mirror 명령을 실행하고 명령에 --dry-run 인수를 추가하세요. 

    $ oc mirror -c <image_set_config_yaml> file://<oc_mirror_workspace_path> --dry-run --v2
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <image_set_config_yaml>
    생성한 이미지 세트 구성 파일을 지정합니다.
    <oc_mirror_workspace_path>
    작업 공간 경로의 주소를 삽입합니다.
    <mirror_registry_url>

    이미지를 미러링하거나 삭제할 원격 컨테이너 레지스트리의 URL이나 주소를 삽입하세요.

    출력 예

    [INFO]   : :wave: Hello, welcome to oc-mirror
[INFO]   : :gear:  setting up the environment for you...
[INFO]   : :twisted_rightwards_arrows: workflow mode: mirrorToDisk
[INFO]   : :sleuth_or_spy:  going to discover the necessary images...
[INFO]   : :mag: collecting release images...
[INFO]   : :mag: collecting operator images...
[INFO]   : :mag: collecting additional images...
[WARN]   : :warning:  54/54 images necessary for mirroring are not available in the cache.
[WARN]   : List of missing images in : CLID-19/working-dir/dry-run/missing.txt.
please re-run the mirror to disk process
[INFO]   : :page_facing_up: list of all images for mirroring in : CLID-19/working-dir/dry-run/mapping.txt
[INFO]   : mirror time     : 9.641091076s
[INFO]   : :wave: Goodbye, thank you for using oc-mirror
    Copy to Clipboard Toggle word wrap

검증

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

    $ cd <oc_mirror_workspace_path>
    Copy to Clipboard Toggle word wrap
  2. 생성된 mapping.txt 및 missing.txt 파일을 검토합니다. 이러한 파일에는 미러링될 모든 이미지 목록이 포함되어 있습니다.

5.7.2. oc-mirror 플러그인 v2 오류 문제 해결
링크 복사

oc-mirror 플러그인 v2는 이제 모든 이미지 미러링 오류를 별도의 파일에 기록하여 오류를 추적하고 진단하기가 더 쉬워졌습니다.

중요

릴리스 또는 릴리스 구성 요소 이미지를 미러링하는 동안 오류가 발생하면 이는 매우 중요합니다. 이렇게 하면 미러링 프로세스가 즉시 중지됩니다.

미러링 운영자, 운영자 관련 이미지 또는 추가 이미지에 오류가 발생해도 미러링 프로세스는 중단되지 않습니다. 미러링은 계속되고, oc-mirror 플러그인 v2는 어느 Operator가 미러링에 실패했는지 설명하는 파일을 working-dir/logs 디렉토리에 저장합니다.

이미지 미러링에 실패하고 해당 이미지가 하나 이상의 Operator 번들의 일부로 미러링되는 경우, oc-mirror 플러그인 v2는 어떤 Operator가 불완전한지 사용자에게 알려서 오류의 영향을 받는 Operator 번들에 대한 명확성을 제공합니다.

프로세스

  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
    Copy to Clipboard Toggle word wrap

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

  2. 운영자의 불완전한 미러링을 확인하세요.

    오류 예시

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

    1. 콘솔이나 로그 파일에서 어떤 연산자가 불완전한지 나타내는 경고를 확인하세요.

      운영자가 불완전하다고 표시된 경우 해당 운영자와 관련된 이미지가 미러링되지 않았을 가능성이 높습니다.

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

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

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

이러한 단계를 따르면 문제를 더 정확하게 진단하고 더 원활하게 미러링을 보장할 수 있습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat