5.4. クラスターへのカタログソースの追加

手順

1. インデックスイメージを参照する CatalogSource オブジェクトを作成します。oc adm catalog mirror コマンドを使用してカタログをターゲットレジストリーにミラーリングする場合、manifests ディレクトリーに生成される catalogSource.yaml ファイルを開始点としてそのまま使用することができます。

   1. 仕様を以下のように変更し、これを catalogSource.yaml ファイルとして保存します。

      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: my-operator-catalog 

      1

      
        namespace: openshift-marketplace 

      2

      
      spec:
        sourceType: grpc
        grpcPodConfig:
          securityContextConfig: <security_mode> 

      3

      
        image: <registry>/<namespace>/redhat-operator-index:v4.19 

      4

      
        displayName: My Operator Catalog
        publisher: <publisher_name> 

      5

      
        updateStrategy:
          registryPoll: 

      6

      
            interval: 30m

      Copy to Clipboard Toggle word wrap

      1

      レジストリーにアップロードする前にローカルファイルにコンテンツをミラーリングする場合は、metadata.name フィールドからバックスラッシュ (/) 文字を削除し、オブジェクトの作成時に "invalid resource name" エラーを回避します。

      2

      カタログソースを全 namespace のユーザーがグローバルに利用できるようにする場合は、openshift-marketplace namespace を指定します。それ以外の場合は、そのカタログの別の namespace を対象とし、その namespace のみが利用できるように指定できます。

      3

      legacy または restricted の値を指定します。フィールドが設定されていない場合、デフォルト値は legacy です。今後の OpenShift Container Platform リリースでは、デフォルト値が restricted になる予定です。restricted 権限でカタログを実行できない場合は、このフィールドを手動で legacy に設定することを推奨します。

      4

      インデックスイメージを指定します。イメージ名の後にタグを指定した場合 (:v4.19 など)、カタログソース Pod は Always のイメージプルポリシーを使用します。これは、Pod が常にコンテナーを起動する前にイメージをプルすることを意味します。@sha256:<id> などのダイジェストを指定した場合、イメージプルポリシーは IfNotPresent になります。これは、イメージがノード上にまだ存在しない場合にのみ、Pod がイメージをプルすることを意味します。

      5

      カタログを公開する名前または組織名を指定します。

      6

      カタログソースは新規バージョンの有無を自動的にチェックし、最新の状態を維持します。

   2. このファイルを使用して CatalogSource オブジェクトを作成します。

      $ oc apply -f catalogSource.yaml

      Copy to Clipboard Toggle word wrap

2. 以下のリソースが正常に作成されていることを確認します。

   1. Pod を確認します。

      $ oc get pods -n openshift-marketplace

      Copy to Clipboard Toggle word wrap

      出力例

      NAME                                    READY   STATUS    RESTARTS  AGE
      my-operator-catalog-6njx6               1/1     Running   0         28s
      marketplace-operator-d9f549946-96sgr    1/1     Running   0         26h

      Copy to Clipboard Toggle word wrap

   2. カタログソースを確認します。

      $ oc get catalogsource -n openshift-marketplace

      Copy to Clipboard Toggle word wrap

      出力例

      NAME                  DISPLAY               TYPE PUBLISHER  AGE
      my-operator-catalog   My Operator Catalog   grpc            5s

      Copy to Clipboard Toggle word wrap

   3. パッケージマニフェストを確認します。

      $ oc get packagemanifest -n openshift-marketplace

      Copy to Clipboard Toggle word wrap

      出力例

      NAME                          CATALOG               AGE
      jaeger-product                My Operator Catalog   93s

      Copy to Clipboard Toggle word wrap