7.4. OLM 1.0에서 일반 번들 관리 (기술 프리뷰)

프로세스

1. 프로젝트 루트에서 번들 이미지를 빌드할 수 있는 Dockerfile을 생성합니다.

   plainbundle.Dockerfile의 예

   FROM scratch 1
   ADD manifests /manifests

   1

   FROM scratch 지시문을 사용하여 이미지 크기를 줄입니다. 번들 이미지에 다른 파일 또는 디렉터리는 필요하지 않습니다.

2. 다음 예와 유사하게 기본 빌드 툴을 사용하여 OCI(Open Container Initiative) 호환 이미지를 빌드합니다.

   $ podman build -f plainbundle.Dockerfile -t \
       quay.io/<organization_name>/<repository_name>:<image_tag> . 1

   1

   내보내기 액세스 권한이 있는 리포지토리를 참조하는 이미지 태그를 사용합니다.

3. 다음 명령을 실행하여 원격 레지스트리로 이미지를 푸시합니다.

   $ podman push quay.io/<organization_name>/<repository_name>:<image_tag>

프로세스

1. 다음 명령을 실행하여 카탈로그의 디렉터리를 생성합니다.

   $ mkdir <catalog_dir>

2. 이전 단계와 동일한 디렉터리 수준에서 opm generate dockerfile 명령을 실행하여 카탈로그 이미지를 빌드할 수 있는 Dockerfile을 생성합니다.

   $ opm generate dockerfile <catalog_dir> \
       -i registry.redhat.io/openshift4/ose-operator-registry:v4.15 1

   1

   -i 플래그를 사용하여 공식 Red Hat 기본 이미지를 지정합니다. 그러지 않으면 Dockerfile에서 기본 업스트림 이미지를 사용합니다.

   참고

   생성된 Dockerfile은 이전 단계에서 생성한 카탈로그 디렉터리와 동일한 상위 디렉터리에 있어야 합니다.

   디렉터리 구조의 예

   .
   ├── <catalog_dir>
   └── <catalog_dir>.Dockerfile

3. opm init 명령을 실행하여 카탈로그를 확장 패키지 정의로 채웁니다.

   $ opm init <extension_name> \
       --output json \
       > <catalog_dir>/index.json

   이 명령은 지정된 카탈로그 구성 파일에 olm.package 선언적 구성 blob을 생성합니다.

프로세스

1. 카탈로그의 index.json 또는 index.yaml 파일이 다음 예와 유사한지 확인합니다.

   예: <catalog_dir>/index.json 파일

   {
       {
        "schema": "olm.package",
        "name": "<extension_name>",
        "defaultChannel": ""
       }
   }

2. olm.bundle blob을 생성하려면 다음 예와 유사하게 index.json 또는 index.yaml 파일을 편집합니다.

   olm.bundle blob이 있는 & lt;catalog_dir>/index.json 파일의 예

   {
      "schema": "olm.bundle",
       "name": "<extension_name>.v<version>",
       "package": "<extension_name>",
       "image": "quay.io/<organization_name>/<repository_name>:<image_tag>",
       "properties": [
           {
               "type": "olm.package",
               "value": {
               "packageName": "<extension_name>",
               "version": "<bundle_version>"
               }
           },
           {
               "type": "olm.bundle.mediatype",
               "value": "plain+v0"
           }
     ]
   }

3. olm.channel blob을 생성하려면 다음 예제와 유사하게 index.json 또는 index.yaml 파일을 편집합니다.

   olm.channel blob이 있는 & lt;catalog_dir>/index.json 파일의 예

   {
       "schema": "olm.channel",
       "name": "<desired_channel_name>",
       "package": "<extension_name>",
       "entries": [
           {
               "name": "<extension_name>.v<version>"
           }
       ]
   }

검증

1. index.json 또는 index.yaml 파일을 열고 다음 예와 유사한지 확인합니다.

   Example <catalog_dir>/index.json file

   {
       "schema": "olm.package",
       "name": "example-extension",
       "defaultChannel": "preview"
   }
   {
       "schema": "olm.bundle",
       "name": "example-extension.v0.0.1",
       "package": "example-extension",
       "image": "quay.io/example-org/example-extension-bundle:v0.0.1",
       "properties": [
           {
               "type": "olm.package",
               "value": {
               "packageName": "example-extension",
               "version": "0.0.1"
               }
           },
           {
               "type": "olm.bundle.mediatype",
               "value": "plain+v0"
           }
       ]
   }
   {
       "schema": "olm.channel",
       "name": "preview",
       "package": "example-extension",
       "entries": [
           {
               "name": "example-extension.v0.0.1"
           }
       ]
   }

2. 다음 명령을 실행하여 카탈로그를 확인합니다.

   $ opm validate <catalog_dir>

프로세스

1. 다음 명령을 실행하여 파일 기반 카탈로그를 이미지로 빌드합니다.

   $ podman build -f <catalog_dir>.Dockerfile -t \
       quay.io/<organization_name>/<repository_name>:<image_tag> .

2. 다음 명령을 실행하여 카탈로그 이미지를 내보냅니다.

   $ podman push quay.io/<organization_name>/<repository_name>:<image_tag>