5.13. oc-mirror 플러그인 v2에 대한 명령 참조


다음 표에서는 oc-mirror 플러그인 v2의 oc mirror 하위 명령 및 플래그를 설명합니다.

Expand
표 5.5. oc-mirror 플러그인 v2의 하위 명령 및 플래그
하위 명령설명

help

모든 하위 명령에 대한 도움말 표시

version

oc-mirror 버전을 출력합니다.

삭제

원격 레지스트리 및 로컬 캐시의 이미지를 삭제합니다.

Expand
표 5.6. oc mirror 플래그
플래그설명

--authfile

인증 파일의 문자열 경로를 표시합니다. 기본값은 ${XDG_RUNTIME_DIR}/containers/auth.json 입니다.

-c, --config <string>

이미지 세트 구성 파일의 경로를 지정합니다.

--cache-dir <string>

이 플래그를 사용하여 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 Blob 및 매니페스트의 영구 캐시를 저장하는 디렉터리를 지정합니다. oc-mirror 플러그인은 disk-to-mirrormirror-to-disk 워크플로의 캐시를 사용하지만 mirror-to-mirror 워크플로우에서 캐시를 사용하지 않습니다. 플러그인은 캐시를 사용하여 증분 미러링을 수행하고 변경되지 않은 이미지를 다시 미러링하지 않으므로 시간을 절약하고 네트워크 대역폭 사용량을 줄입니다. 기본 캐시 디렉터리는 $HOME 입니다. 자세한 내용은 "-cache-dir 및 --workspace 플래그 수락"을 참조하십시오.

--dest-tls-verify

HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬에 액세스할 때 인증서를 확인합니다. 기본값은 true입니다.

--dry-run

이미지를 미러링하지 않고 작업을 출력합니다.

--from <string>

oc-mirror 플러그인 v2를 실행하여 대상 레지스트리를 로드하여 생성된 이미지 세트 아카이브의 경로를 지정합니다.

-h, --help

도움말 표시

--image-timeout 기간

이미지 미러링에 대한 제한 시간입니다. 기본값은 10m0s입니다. 유효한 시간 단위는 ns, us 또는 µs, ms, s, m, h 입니다.

--log-level <string>

문자열 로그 수준을 표시합니다. 지원되는 값에는 info, debug, trace, error가 포함됩니다. 기본값은 info 입니다.

-p, --port

oc-mirror 플러그인 v2 로컬 스토리지 인스턴스에서 사용하는 HTTP 포트를 결정합니다. 기본값은 55000 입니다.

--parallel-images <unit>

병렬로 미러링된 이미지 수를 지정합니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 4 입니다.

--parallel-layers <unit>

병렬로 미러링된 이미지 계층 수를 지정합니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 5 입니다.

--max-nested-paths <int>

중첩된 경로를 제한하는 대상 레지스트리의 최대 중첩된 경로 수를 지정합니다. 기본값은 0입니다.

--secure-policy

기본값은 false입니다. 기본값이 아닌 값을 설정하면 명령은 서명 확인을 위한 보안 정책인 서명 확인을 활성화합니다.

--since

지정된 날짜 이후의 모든 새 콘텐츠를 포함합니다(format: yyyy-mm-dd). 제공되지 않으면 이전 미러링 이후 새 콘텐츠가 미러링됩니다.

--src-tls-verify

HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬에 액세스할 때 인증서를 확인합니다.

--strict-archive

기본값은 false입니다. 값을 설정하면 이 명령은 imageSetConfig CR(사용자 정의 리소스)에 설정된 archiveSize 보다 엄격하게 적은 아카이브를 생성합니다. 보관 중인 파일이 archiveSize (GB)를 초과하는 경우 미러링은 오류가 발생했습니다.

-v,--version

oc-mirror 플러그인 v2의 버전을 표시합니다.

--workspace

--workspace 플래그를 사용하여 oc-mirror 플러그인이 ImageDigestMirrorSetImageTagMirrorSet 매니페스트와 같이 미러링 작업 중에 생성하는 작업 파일을 저장하는 디렉터리를 지정할 수 있습니다. 이 디렉터리를 사용하여 생성된 구성을 클러스터에 적용하고 미러링 작업을 반복합니다. 자세한 내용은 "-cache-dir 및 --workspace 플래그 수락"을 참조하십시오.

--retry-delay duration

두 번 재시도 사이의 지연 시간입니다. 기본값은 1s 입니다.

--retry-times <int>

재시도 횟수입니다. 기본값은 2입니다.

--rootless-storage-path <string>

기본 컨테이너 루트리스 스토리지 경로(일반적으로 etc/containers/storage.conf)를 덮어씁니다.

--remove-signatures

소스 이미지의 서명을 복사하지 않습니다.

--registries.d

레지스트리 구성 파일이 포함된 디렉터리를 지정합니다.

--secure-policy=true

모든 이미지에 대한 서명 확인을 활성화합니다.

--policy

서명 확인 정책 파일의 경로를 지정합니다.

5.13.1. 이미지 삭제를 위한 명령 참조

다음 표에서는 이미지 삭제를 위한 oc mirror 하위 명령 및 플래그를 설명합니다.

Expand
표 5.7. 이미지 삭제의 하위 명령 및 플래그
하위 명령설명

--authfile <string>

인증 파일의 경로입니다. 기본값은 ${XDG_RUNTIME_DIR}/containers/auth.json 입니다.

--cache-dir <string>

이 플래그를 사용하여 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 Blob 및 매니페스트의 영구 캐시를 저장하는 디렉터리를 지정합니다. oc-mirror 플러그인은 disk-to-mirrormirror-to-disk 워크플로의 캐시를 사용하지만 mirror-to-mirror 워크플로우에서 캐시를 사용하지 않습니다. 플러그인은 캐시를 사용하여 증분 미러링을 수행하고 변경되지 않은 이미지를 다시 미러링하지 않으므로 시간을 절약하고 네트워크 대역폭 사용량을 줄입니다. 기본 캐시 디렉터리는 $HOME 입니다. 자세한 내용은 "-cache-dir 및 --workspace 플래그 수락"을 참조하십시오.

-c <string>, --config <string>

삭제 이미지 세트 구성 파일의 경로입니다.

--delete-id <string>

삭제 기능으로 생성된 파일의 버전을 구분하는 데 사용됩니다.

--delete-v1-images

oc-mirror 플러그인 v1로 이전에 미러링된 이미지를 대상으로 하기 위해 --generate 와 함께 마이그레이션 중에 사용됩니다.

--delete-yaml-file <string>

설정된 경우 생성된 yaml 또는 업데이트된 yaml 파일을 사용하여 콘텐츠를 삭제합니다.

--dest-tls-verify

HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬과 통신할 때 인증서를 확인해야 합니다. 기본값은 true입니다.

--force-cache-delete

로컬 캐시 매니페스트 및 Blob을 강제로 삭제하는 데 사용됩니다.

--generate

로컬 캐시 및 원격 레지스트리에서 삭제할 때 사용되는 매니페스트 및 Blob 목록에 대한 삭제 yaml을 생성하는 데 사용됩니다.

-h, --help

도움말을 표시합니다.

--log-level <string>

로그 수준 정보,디버그,추적오류 중 하나입니다. 기본값은 info 입니다.

--parallel-images <unit>

병렬로 삭제된 이미지 수를 나타냅니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 4 입니다.

--parallel-layers <unit>

병렬로 삭제된 이미지 계층 수를 나타냅니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 5 입니다.

-p <unit>, --port <unit>

oc-mirror의 로컬 스토리지 인스턴스에서 사용하는 HTTP 포트입니다. 기본값은 55000 입니다.

--retry-delay

2번 재시도 사이의 기간 지연. 기본값은 1s 입니다.

--retry-times <int>

재시도 횟수입니다. 기본값은 2입니다.

--src-tls-verify

HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬과 통신할 때 인증서를 확인해야 합니다. 기본값은 true입니다.

--workspace <string>

--workspace 플래그를 사용하여 oc-mirror 플러그인이 ImageDigestMirrorSetImageTagMirrorSet 매니페스트와 같이 미러링 작업 중에 생성하는 작업 파일을 저장하는 디렉터리를 지정할 수 있습니다. 이 디렉터리를 사용하여 생성된 구성을 클러스터에 적용하고 미러링 작업을 반복합니다. 자세한 내용은 "-cache-dir 및 --workspace 플래그 수락"을 참조하십시오.

5.13.2. --cache-dir 및 --workspace 플래그 정보

--cache-dir 플래그를 사용하여 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 Blob 및 매니페스트의 영구 캐시를 저장하는 디렉터리를 지정할 수 있습니다.

oc-mirror 플러그인은 mirror-to-diskdisk-to-mirror 워크플로우에서 캐시를 사용하지만 mirror-to-mirror 워크플로우에서 캐시를 사용하지 않습니다. 플러그인은 캐시를 사용하여 증분 미러링을 수행하고 변경되지 않은 이미지를 다시 미러링하지 않으므로 시간을 절약하고 네트워크 대역폭 사용량을 줄입니다.

캐시 디렉터리에는 마지막으로 성공한 미러링 작업까지의 데이터만 포함됩니다. 캐시 디렉터리를 삭제하거나 손상시키는 경우 oc-mirror 플러그인은 이미지 Blob 및 매니페스트를 다시 가져오므로 전체 remirror를 강제 적용하고 네트워크 사용량을 늘릴 수 있습니다.

--workspace 플래그를 사용하여 oc-mirror 플러그인이 ImageDigestMirrorSetImageTagMirrorSet 매니페스트와 같이 미러링 작업 중에 생성하는 작업 파일을 저장하는 디렉터리를 지정할 수 있습니다. 작업 공간 디렉터리를 사용하여 다음 작업을 수행할 수도 있습니다.

  • 릴리스 및 Operator 이미지에 대해 변경되지 않은 메타데이터를 저장합니다.
  • disk-to-mirror 워크플로우에 사용할 tar 아카이브를 생성합니다.
  • 생성된 구성을 클러스터에 적용합니다.
  • 이전 미러링 작업을 반복하거나 다시 시작합니다.

작업 공간 디렉터리를 제거하거나 수정하는 경우 향후 미러링 작업이 실패할 수 있거나 클러스터에서 일관되지 않은 이미지 소스를 사용할 수 있습니다.

주의

캐시 또는 작업 공간 디렉터리의 내용을 삭제하거나 수정하면 다음과 같은 문제가 발생할 수 있습니다.

  • 미러링에 실패하거나 불완전한 미러링 작업입니다.
  • 증분 미러링 데이터 손실.
  • 전체 remirroring 요구 사항과 네트워크 오버헤드가 증가했습니다.

영향을 완전히 이해하지 않는 한 이러한 디렉터리를 수정, 재배치 또는 삭제하지 마십시오. 미러링 작업에 성공한 후 캐시 디렉터리를 정기적으로 백업해야 합니다. 각 미러링 주기 동안 내용이 다시 생성되므로 작업 공간 디렉터리를 백업할 필요가 없습니다.

캐시 및 작업 공간 디렉터리를 효과적으로 관리할 수 있도록 다음 모범 사례를 고려하십시오.

  • 영구 스토리지 사용: 신뢰할 수 있는 백업 스토리지에 캐시 및 작업 공간 디렉터리를 배치합니다.
  • 성공적인 작업 후 백업: 특히 미러링 주기를 완료한 후 캐시 디렉터리를 정기적으로 백업합니다.
  • 필요한 경우 복원: 데이터가 손실되면 백업에서 캐시 및 작업 공간 디렉터리를 복원하여 전체 remirror를 수행하지 않고 미러링 작업을 재개합니다.
  • 별도의 환경: 충돌을 방지하려면 다른 환경에 전용 디렉터리를 사용합니다.

다음 예제를 사용하여 oc-mirror 명령을 실행할 때 캐시 및 작업 공간 디렉터리를 지정합니다.

$ oc mirror --config=imageset-config.yaml \
    file://local_mirror \
    --workspace /mnt/mirror-data/workspace \
    --cache-dir /mnt/mirror-data/cache
    --v2
Copy to Clipboard Toggle word wrap

미러링 작업이 완료되면 디렉터리 구조는 다음과 같습니다.

/mnt/mirror-data/
├── cache/
│   ├── manifests/
│   ├── metadata.db
│   └── previous-mirror-state.json
└── workspace/
    ├── imageset-config-state.yaml
    ├── manifests/
    └── icsp/
Copy to Clipboard Toggle word wrap

미러링 작업이 성공할 때마다 /mnt/mirror-data/cache 디렉터리를 백업해야 합니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat