5.13. oc-mirror 플러그인 v2에 대한 명령 참조
다음 표에서는 oc-mirror 플러그인 v2의 oc mirror
하위 명령 및 플래그를 설명합니다.
하위 명령 | 설명 |
---|---|
| 모든 하위 명령에 대한 도움말 표시 |
| oc-mirror 버전을 출력합니다. |
| 원격 레지스트리 및 로컬 캐시의 이미지를 삭제합니다. |
플래그 | 설명 |
---|---|
|
인증 파일의 문자열 경로를 표시합니다. 기본값은 |
| 이미지 세트 구성 파일의 경로를 지정합니다. |
|
이 플래그를 사용하여 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 Blob 및 매니페스트의 영구 캐시를 저장하는 디렉터리를 지정합니다. oc-mirror 플러그인은 |
|
HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬에 액세스할 때 인증서를 확인합니다. 기본값은 |
| 이미지를 미러링하지 않고 작업을 출력합니다. |
| oc-mirror 플러그인 v2를 실행하여 대상 레지스트리를 로드하여 생성된 이미지 세트 아카이브의 경로를 지정합니다. |
| 도움말 표시 |
|
이미지 미러링에 대한 제한 시간입니다. 기본값은 10m0s입니다. 유효한 시간 단위는 |
|
문자열 로그 수준을 표시합니다. 지원되는 값에는 info, debug, trace, error가 포함됩니다. 기본값은 |
|
oc-mirror 플러그인 v2 로컬 스토리지 인스턴스에서 사용하는 HTTP 포트를 결정합니다. 기본값은 |
|
병렬로 미러링된 이미지 수를 지정합니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 |
|
병렬로 미러링된 이미지 계층 수를 지정합니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 |
|
중첩된 경로를 제한하는 대상 레지스트리의 최대 중첩된 경로 수를 지정합니다. 기본값은 |
|
기본값은 |
|
지정된 날짜 이후의 모든 새 콘텐츠를 포함합니다(format: |
| HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬에 액세스할 때 인증서를 확인합니다. |
|
기본값은 |
| oc-mirror 플러그인 v2의 버전을 표시합니다. |
|
|
|
두 번 재시도 사이의 지연 시간입니다. 기본값은 |
|
재시도 횟수입니다. 기본값은 |
|
기본 컨테이너 루트리스 스토리지 경로(일반적으로 |
| 소스 이미지의 서명을 복사하지 않습니다. |
| 레지스트리 구성 파일이 포함된 디렉터리를 지정합니다. |
| 모든 이미지에 대한 서명 확인을 활성화합니다. |
| 서명 확인 정책 파일의 경로를 지정합니다. |
5.13.1. 이미지 삭제를 위한 명령 참조 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 이미지 삭제를 위한 oc mirror
하위 명령 및 플래그를 설명합니다.
하위 명령 | 설명 |
---|---|
|
인증 파일의 경로입니다. 기본값은 |
|
이 플래그를 사용하여 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 Blob 및 매니페스트의 영구 캐시를 저장하는 디렉터리를 지정합니다. oc-mirror 플러그인은 |
| 삭제 이미지 세트 구성 파일의 경로입니다. |
| 삭제 기능으로 생성된 파일의 버전을 구분하는 데 사용됩니다. |
|
oc-mirror 플러그인 v1로 이전에 미러링된 이미지를 대상으로 하기 위해 |
| 설정된 경우 생성된 yaml 또는 업데이트된 yaml 파일을 사용하여 콘텐츠를 삭제합니다. |
|
HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬과 통신할 때 인증서를 확인해야 합니다. 기본값은 |
| 로컬 캐시 매니페스트 및 Blob을 강제로 삭제하는 데 사용됩니다. |
| 로컬 캐시 및 원격 레지스트리에서 삭제할 때 사용되는 매니페스트 및 Blob 목록에 대한 삭제 yaml을 생성하는 데 사용됩니다. |
| 도움말을 표시합니다. |
|
로그 수준 |
|
병렬로 삭제된 이미지 수를 나타냅니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 |
|
병렬로 삭제된 이미지 계층 수를 나타냅니다. 값은 1-10의 범위에 있어야 합니다. 기본값은 |
|
oc-mirror의 로컬 스토리지 인스턴스에서 사용하는 HTTP 포트입니다. 기본값은 |
|
2번 재시도 사이의 기간 지연. 기본값은 |
|
재시도 횟수입니다. 기본값은 |
|
HTTPS가 필요하며 컨테이너 레지스트리 또는 데몬과 통신할 때 인증서를 확인해야 합니다. 기본값은 |
|
|
5.13.2. --cache-dir 및 --workspace 플래그 정보 링크 복사링크가 클립보드에 복사되었습니다!
--cache-dir
플래그를 사용하여 oc-mirror 플러그인이 미러링 작업 중에 사용할 이미지 Blob 및 매니페스트의 영구 캐시를 저장하는 디렉터리를 지정할 수 있습니다.
oc-mirror 플러그인은 mirror-to-disk
및 disk-to-mirror
워크플로우에서 캐시를 사용하지만 mirror-to-mirror
워크플로우에서 캐시를 사용하지 않습니다. 플러그인은 캐시를 사용하여 증분 미러링을 수행하고 변경되지 않은 이미지를 다시 미러링하지 않으므로 시간을 절약하고 네트워크 대역폭 사용량을 줄입니다.
캐시 디렉터리에는 마지막으로 성공한 미러링 작업까지의 데이터만 포함됩니다. 캐시 디렉터리를 삭제하거나 손상시키는 경우 oc-mirror 플러그인은 이미지 Blob 및 매니페스트를 다시 가져오므로 전체 remirror를 강제 적용하고 네트워크 사용량을 늘릴 수 있습니다.
--workspace
플래그를 사용하여 oc-mirror 플러그인이 ImageDigestMirrorSet
및 ImageTagMirrorSet
매니페스트와 같이 미러링 작업 중에 생성하는 작업 파일을 저장하는 디렉터리를 지정할 수 있습니다. 작업 공간 디렉터리를 사용하여 다음 작업을 수행할 수도 있습니다.
- 릴리스 및 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
$ 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
디렉터리를 백업해야 합니다.