Red Hat Summit5.13. oc-mirror 플러그인 v2에 대한 명령어 참조
다음 표에서는 oc-mirror 플러그인 v2에 대한 oc mirror 하위 명령과 플래그를 설명합니다.
| 하위 명령 | 설명 |
|---|---|
|
| 모든 하위 명령에 대한 도움말 표시 |
|
| oc-mirror 버전을 출력합니다 |
|
| 원격 레지스트리 및 로컬 캐시의 이미지를 삭제합니다. |
| 플래그 | 설명 |
|---|---|
|
|
인증 파일의 문자열 경로를 표시합니다. 기본값은 |
|
| 이미지 세트 구성 파일의 경로를 지정합니다. |
|
|
이 플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 블롭과 매니페스트의 영구 캐시를 저장하는 디렉토리를 지정할 수 있습니다. oc-mirror 플러그인은 |
|
|
컨테이너 레지스트리나 데몬에 액세스할 때 HTTPS가 필요하고 인증서를 확인합니다. 기본값은 |
|
| 이미지를 미러링하지 않고 동작을 인쇄합니다. |
|
| oc-mirror 플러그인 v2를 실행하여 대상 레지스트리를 로드하여 생성된 이미지 세트 아카이브의 경로를 지정합니다. |
|
| 도움말 표시 |
|
|
이미지 미러링 시간 초과. 기본값은 10m 입니다. 유효한 시간 단위는 |
|
|
문자열 로그 수준을 표시합니다. 지원되는 값에는 info, debug, trace, error가 있습니다. 기본값은 |
|
|
oc-mirror 플러그인 v2 로컬 스토리지 인스턴스에서 사용되는 HTTP 포트를 결정합니다. 기본값은 |
|
|
병렬로 미러링되는 이미지의 수를 지정합니다. 기본값은 |
|
|
병렬로 미러링되는 이미지 레이어의 수를 지정합니다. 기본값은 |
|
|
중첩 경로를 제한하는 대상 레지스트리의 중첩 경로의 최대 수를 지정합니다. 기본값은 |
|
|
기본값은 |
|
|
지정된 날짜 이후의 모든 새 콘텐츠를 포함합니다(형식: |
|
| 컨테이너 레지스트리나 데몬에 액세스할 때 HTTPS가 필요하고 인증서를 확인합니다. |
|
|
기본값은 |
|
| oc-mirror 플러그인 v2의 버전을 표시합니다. |
|
|
|
|
|
두 번 재시도 사이의 지연 시간입니다. 기본값은 |
|
|
재시도 횟수. 기본값은 |
|
|
기본 컨테이너 루트리스 스토리지 경로(일반적으로 |
|
| 원본 이미지에서 서명을 복사하지 않습니다. |
|
| 레지스트리 구성 파일이 포함된 디렉토리를 지정합니다. |
|
| 모든 이미지에 대한 서명 검증이 가능합니다. |
|
| 서명 검증 정책 파일의 경로를 지정합니다. |
5.13.1. 이미지 삭제를 위한 명령어 참조
다음 표에서는 oc mirror 하위 명령과 이미지 삭제 플래그를 설명합니다.
| 하위 명령 | 설명 |
|---|---|
|
|
인증 파일의 경로입니다. 기본값은 |
|
|
이 플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 블롭과 매니페스트의 영구 캐시를 저장하는 디렉토리를 지정할 수 있습니다. oc-mirror 플러그인은 |
|
| 삭제 이미지셋 구성 파일의 경로입니다. |
|
| 삭제 기능으로 생성된 파일의 버전을 구별하는 데 사용됩니다. |
|
|
|
|
| 설정하면 생성되거나 업데이트된 YAML 파일을 사용하여 콘텐츠를 삭제합니다. |
|
|
컨테이너 레지스트리나 데몬과 통신할 때 HTTPS를 요구하고 인증서를 확인합니다. 기본값은 |
|
| 로컬 캐시 매니페스트와 블롭을 강제로 삭제하는 데 사용됩니다. |
|
| 매니페스트와 블롭 목록에 대한 삭제 YAML을 생성하는 데 사용되며, 로컬 캐시와 원격 레지스트리에서 삭제할 때 사용됩니다. |
|
| 도움말을 표시합니다. |
|
|
|
|
|
동시에 삭제되는 이미지의 개수를 나타냅니다. 기본값은 |
|
|
병렬로 미러링되는 이미지 레이어의 수를 나타냅니다. 기본값은 |
|
|
oc-mirror의 로컬 스토리지 인스턴스에서 사용하는 HTTP 포트입니다. 기본값은 |
|
|
2번의 재시도 사이의 지연 시간입니다. 기본값은 |
|
|
재시도 횟수. 기본값은 |
|
|
컨테이너 레지스트리나 데몬과 통신할 때 HTTPS를 요구하고 인증서를 확인합니다. 기본값은 |
|
|
|
5.13.2. --cache-dir 및 --workspace 플래그에 관하여
--cache-dir 플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 블롭과 매니페스트의 영구 캐시를 저장하는 디렉토리를 지정할 수 있습니다.
oc-mirror 플러그인은 미러-디스크 및 디스크-미러 워크플로에서 캐시를 사용하지만 미러-미러 워크플로에서는 캐시를 사용하지 않습니다. 이 플러그인은 캐시를 사용하여 증분 미러링을 수행하고 변경되지 않은 이미지를 다시 미러링하지 않으므로 시간이 절약되고 네트워크 대역폭 사용량이 줄어듭니다.
캐시 디렉토리에는 마지막으로 성공한 미러링 작업까지의 데이터만 포함됩니다. 캐시 디렉토리를 삭제하거나 손상시키면 oc-mirror 플러그인이 이미지 블롭과 매니페스트를 다시 가져오는데, 이로 인해 전체 리미러링이 강제로 수행되어 네트워크 사용량이 늘어날 수 있습니다.
--workspace 플래그를 사용하면 oc-mirror 플러그인이 미러링 작업 중에 생성하는 작업 파일(예: ImageDigestMirrorSet 및 ImageTagMirrorSet 매니페스트)을 저장하는 디렉토리를 지정할 수 있습니다. 작업 공간 디렉토리를 사용하여 다음 작업을 수행할 수도 있습니다.
- 릴리스 및 운영자 이미지에 대한 압축 해제된 메타데이터를 저장합니다.
-
디스크-투-미러워크플로에 사용할 tar 아카이브를 생성합니다. - 생성된 구성을 클러스터에 적용합니다.
- 이전 미러링 작업을 반복하거나 재개합니다.
작업 공간 디렉토리를 제거하거나 수정하면 향후 미러링 작업이 실패하거나 클러스터에서 일관되지 않은 이미지 소스를 사용할 수 있습니다.
캐시 또는 작업 공간 디렉토리의 내용을 삭제하거나 수정하면 다음과 같은 문제가 발생할 수 있습니다.
- 미러링 작업이 실패했거나 완료되지 않았습니다.
- 증분 미러링 데이터 손실.
- 전체 리미러링 요구 사항과 네트워크 오버헤드 증가.
영향을 완전히 이해하지 않는 한 이러한 디렉토리를 수정, 이전 또는 삭제하지 마십시오. 성공적인 미러링 작업 후에는 캐시 디렉토리를 정기적으로 백업해야 합니다. 각 미러링 주기 동안 내용이 다시 생성되므로 작업 공간 디렉토리를 백업할 필요가 없습니다.
캐시 및 작업 공간 디렉터리를 효과적으로 관리할 수 있도록 다음의 모범 사례를 고려하세요.
- 영구 저장소 사용: 캐시 및 작업 공간 디렉터리를 안정적이고 백업된 저장소에 저장합니다.
- 성공적인 작업 후 백업: 특히 미러링 주기를 완료한 후에는 캐시 디렉토리를 정기적으로 백업하세요.
- 필요할 때 복원: 데이터 손실이 발생한 경우 전체 리미러링을 수행하지 않고도 백업에서 캐시 및 작업 공간 디렉터리를 복원하여 미러링 작업을 재개합니다.
- 별도의 환경: 충돌을 방지하기 위해 다양한 환경에 대한 전용 디렉토리를 사용합니다.
oc-mirror 명령을 실행할 때 캐시 및 작업 공간 디렉토리를 지정하려면 다음 예를 사용하세요.
oc mirror --config=imageset-config.yaml \
file://local_mirror \
--workspace /mnt/mirror-data/workspace \
--cache-dir /mnt/mirror-data/cache
$ oc mirror --config=imageset-config.yaml \
file://local_mirror \
--workspace /mnt/mirror-data/workspace \
--cache-dir /mnt/mirror-data/cache
--v2미러링 작업이 완료된 후 디렉토리 구조는 다음과 같습니다.
성공적인 미러링 작업이 끝날 때마다 /mnt/mirror-data/cache 디렉토리를 백업해야 합니다.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}