7.4. OLM 1.0 でのプレーンバンドルの管理 (テクノロジープレビュー)

手順

1. プロジェクトのルートで、バンドルイメージを構築できる Dockerfile を作成します。

   plainbundle.Dockerfile の例

   FROM scratch 

   1

   
   ADD manifests /manifests

   1

   イメージのサイズを小さくするには、FROM scratch ディレクティブを使用します。バンドルイメージには他のファイルやディレクトリーは必要ありません。

2. 次の例のように、任意のビルドツールを使用して Open Container Initiative (OCI) 準拠のイメージをビルドします。

   $ 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-rhel9: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 ブロブを作成するには、次の例のように、index.json または index.yaml ファイルを編集します。

   olm.bundle ブロブを含む <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 ブロブを作成するには、次の例のように、index.json または index.yaml ファイルを編集します。

   olm.channel ブロブを含む <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 ファイルを開き、次の例のようになっていることを確認します。

   <catalog_dir>/index.json ファイルの例

   {
       "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>