6.2. opm CLI 참조

opm CLI(명령줄 인터페이스)는 Operator 카탈로그를 생성하고 유지 관리하는 툴입니다.

opm CLI 구문

$ opm <command> [<subcommand>] [<argument>] [<flags>]

표 6.1. 글로벌 플래그

플래그설명

--skip-tls

번들 또는 인덱스를 가져오는 동안 컨테이너 이미지 레지스트리에 대한 TLS 인증서 확인을 건너뜁니다.

중요

관련 CLI 명령을 포함한 SQLite 기반 카탈로그 형식은 더 이상 사용되지 않는 기능입니다. 더 이상 사용되지 않는 기능은 여전히 OpenShift Container Platform에 포함되어 있으며 계속 지원됩니다. 그러나 이 기능은 향후 릴리스에서 제거될 예정이므로 새로운 배포에는 사용하지 않는 것이 좋습니다.

OpenShift Container Platform에서 더 이상 사용되지 않거나 삭제된 주요 기능의 최신 목록은 OpenShift Container Platform 릴리스 노트에서 더 이상 사용되지 않고 삭제된 기능 섹션을 참조하십시오.

6.2.1. 인덱스

기존 Operator 번들에서 Operator 인덱스 컨테이너 이미지를 생성합니다.

명령 구문

$ opm index <subcommand> [<flags>]

표 6.2. 인덱스 하위 명령

하위 명령설명

add

인덱스에 Operator 번들을 추가합니다.

export

appregistry 형식의 인덱스에서 Operator를 내보냅니다.

prune

지정된 패키지의 인덱스를 모두 정리합니다.

prune-stranded

특정 이미지와 연결되어 있지 않은 번들인 백 번들 인덱스를 정리합니다.

rm

인덱스에서 전체 Operator를 삭제합니다.

6.2.1.1. add

인덱스에 Operator 번들을 추가합니다.

명령 구문

$ opm index add [<flags>]

표 6.3. 인덱스 추가 플래그

플래그설명

-i, --binary-image

on-image opm 명령의 컨테이너 이미지

-u,--build-tool (문자열)

컨테이너 이미지를 빌드하는 툴: podman (기본값) 또는 docker. container -tool 플래그의 일부를 재정의합니다.

-b,--bundles (문자열)

쉼표로 구분된 번들 목록입니다.

-c,--container-tool (문자열)

저장 및 빌드와 같은 컨테이너 이미지와 상호 작용하는 툴: docker 또는 podman.

-f,--from-index (문자열)

추가할 이전 인덱스.

--generate

활성화된 경우 Dockerfile만 생성하여 로컬 디스크에 저장합니다.

--mode (문자열)

채널 그래프를 업데이트하는 방법을 정의하는 그래프 업데이트 모드: 교체 (기본값), semver 또는 semver-skippatch.

-d, --out-dockerfile (string)

선택 사항: Dockerfile을 생성하는 경우 파일 이름을 지정합니다.

--permissive

레지스트리 로드 오류를 허용합니다.

-p,--pull-tool (문자열)

컨테이너 이미지를 가져오는 툴: none (기본값), docker 또는 podman. container -tool 플래그의 일부를 재정의합니다.

-t,--tag (문자열)

빌드 중인 컨테이너 이미지의 사용자 지정 태그입니다.

6.2.1.2. 내보내기

appregistry 형식의 인덱스에서 Operator를 내보냅니다.

명령 구문

$ opm index export [<flags>]

표 6.4. 인덱스 내보내기 플래그

플래그설명

-i,--index (문자열)

패키지를 가져오는 인덱스입니다.

-f,--download-folder (문자열)

다운로드한 Operator 번들이 저장된 디렉터리입니다. 기본 디렉터리가 다운로드 됩니다.

-c,--container-tool (문자열)

저장 및 빌드와 같은 컨테이너 이미지와 상호 작용하는 툴: docker 또는 podman.

-h, --help

export 명령에 대한 도움말입니다.

-p,--package (문자열)

쉼표로 구분된 내보낼 패키지 목록입니다.

6.2.1.3. prune

지정된 패키지의 인덱스를 모두 정리합니다.

명령 구문

$ opm index prune [<flags>]

표 6.5. 인덱스 정리 플래그

플래그설명

-i, --binary-image

on-image opm 명령의 컨테이너 이미지

-c,--container-tool (문자열)

저장 및 빌드와 같은 컨테이너 이미지와 상호 작용하는 툴: docker 또는 podman.

-f,--from-index (문자열)

정리할 인덱스입니다.

--generate

활성화된 경우 Dockerfile만 생성하여 로컬 디스크에 저장합니다.

-d, --out-dockerfile (string)

선택 사항: Dockerfile을 생성하는 경우 파일 이름을 지정합니다.

-p,--packages (문자열)

쉼표로 구분된 보관할 패키지 목록입니다.

--permissive

레지스트리 로드 오류를 허용합니다.

-t,--tag (문자열)

빌드 중인 컨테이너 이미지의 사용자 지정 태그입니다.

6.2.1.4. prune-stranded

특정 이미지와 연결되어 있지 않은 번들인 백 번들 인덱스를 정리합니다.

명령 구문

$ opm index prune-stranded [<flags>]

표 6.6. index prune-stranded 플래그

플래그설명

-i, --binary-image

on-image opm 명령의 컨테이너 이미지

-c,--container-tool (문자열)

저장 및 빌드와 같은 컨테이너 이미지와 상호 작용하는 툴: docker 또는 podman.

-f,--from-index (문자열)

정리할 인덱스입니다.

--generate

활성화된 경우 Dockerfile만 생성하여 로컬 디스크에 저장합니다.

-d, --out-dockerfile (string)

선택 사항: Dockerfile을 생성하는 경우 파일 이름을 지정합니다.

--permissive

레지스트리 로드 오류를 허용합니다.

-t,--tag (문자열)

빌드 중인 컨테이너 이미지의 사용자 지정 태그입니다.

6.2.1.5. rm

인덱스에서 전체 Operator를 삭제합니다.

명령 구문

$ opm index rm [<flags>]

표 6.7. 인덱스 rm 플래그

플래그설명

-i, --binary-image

on-image opm 명령의 컨테이너 이미지

-u,--build-tool (문자열)

컨테이너 이미지를 빌드하는 툴: podman (기본값) 또는 docker. container -tool 플래그의 일부를 재정의합니다.

-c,--container-tool (문자열)

저장 및 빌드와 같은 컨테이너 이미지와 상호 작용하는 툴: docker 또는 podman.

-f,--from-index (문자열)

삭제할 이전 인덱스.

--generate

활성화된 경우 Dockerfile만 생성하여 로컬 디스크에 저장합니다.

-o,--operators (문자열)

삭제할 Operator의 쉼표로 구분된 목록입니다.

-d, --out-dockerfile (string)

선택 사항: Dockerfile을 생성하는 경우 파일 이름을 지정합니다.

--permissive

레지스트리 로드 오류를 허용합니다.

-p,--pull-tool (문자열)

컨테이너 이미지를 가져오는 툴: none (기본값), docker 또는 podman. container -tool 플래그의 일부를 재정의합니다.

-t,--tag (문자열)

빌드 중인 컨테이너 이미지의 사용자 지정 태그입니다.

6.2.2. init

olm.package 선언적 구성 Blob을 생성합니다.

명령 구문

$ opm init <package_name> [<flags>]

표 6.8. init 플래그

플래그설명

-c,--default-channel (문자열)

서브스크립션이 지정되지 않은 경우 기본으로 설정된 채널입니다.

-d,--description (문자열)

Operator의 README.md 또는 기타 문서 경로입니다.

-i,--icon (문자열)

패키지 아이콘 경로.

-o, --output(문자열)

출력 형식: json (기본값) 또는 yaml.

6.2.3. render

제공된 인덱스 이미지, 번들 이미지 및 SQLite 데이터베이스 파일에서 선언적 구성 Blob을 생성합니다.

명령 구문

$ opm render <index_image | bundle_image | sqlite_file> [<flags>]

표 6.9. 렌더 플래그

플래그설명

-o, --output(문자열)

출력 형식: json (기본값) 또는 yaml.

6.2.4. 검증

지정된 디렉터리에서 선언적 구성 JSON 파일의 유효성을 검사합니다.

명령 구문

$ opm validate <directory> [<flags>]

6.2.5. serve

GRPC 서버를 통해 선언적 구성 제공.

참고

선언적 구성 디렉터리는 시작 시 serve 명령으로 로드됩니다. 이 명령을 시작한 후 선언적 구성 변경은 제공된 콘텐츠에 반영되지 않습니다.

명령 구문

$ opm serve <source_path> [<flags>]

표 6.10. 서비스 플래그

플래그설명

--debug

디버그 로깅을 활성화합니다.

-p,--port (문자열)

제공할 포트 번호입니다. 기본값: 50051.

-t,--termination-log (문자열)

컨테이너 종료 로그 파일의 경로입니다. 기본값: /dev/termination-log.