イメージカタログ

ImageCatalog およびClusterImageCatalog は、 Cluster を作成するためのイメージを定義できるようにする重要なリソースです。

主な違いはスコープにあります。ImageCatalog は名前空間ですが、ClusterImageCatalog はクラスタースコープです。

どちらも、イメージのリストで構成される共通の構造を共有し、各イメージのメジャーバージョンを示すmajor フィールドを備えています。

警告

オペレーターはユーザー定義のメジャーバージョンを信頼し、PostgreSQLバージョンの検出の実行を控えます。カタログで宣言されたメジャーバージョンとPostgreSQLイメージ間のアライメントを保証するのはあなたの責任です。

major フィールドの値は、カタログ内で一意を維持し、イメージ間の重複を防ぐ必要があります。ただし、個別のカタログには、同じmajor 値でさまざまなイメージを公開する柔軟性があります。

名前空間``ImageCatalog`` の例

kind: ImageCatalog
metadata:
  name: postgresql
  namespace: default
spec:
  images:
    - major: 15
      image: ghcr.io/cloudnative-pg/postgresql:15.6
    - major: 16
      image: ghcr.io/cloudnative-pg/postgresql:16.2

``ClusterImageCatalog`` リソースを使用したクラスター全体のカタログの例

apiVersion: postgresql.cnpg.io/v1
kind: ClusterImageCatalog
metadata:
  name: postgresql
spec:
  images:
    - major: 15
      image: ghcr.io/cloudnative-pg/postgresql:15.6
    - major: 16
      image: ghcr.io/cloudnative-pg/postgresql:16.2

Cluster リソースは、 ImageCatalog またはClusterImageCatalog を参照して、目的の画像を正確に指定する柔軟性を備えています。

apiVersion: postgresql.cnpg.io/v1
kind: Cluster
metadata:
  name: cluster-example
spec:
  instances: 3
  imageCatalogRef:
    apiGroup: postgresql.cnpg.io
    kind: ImageCatalog
    name: postgresql
    major: 16
  storage:
    size: 1Gi

これらのカタログを使用するクラスターは、継続的な監視を維持します。カタログ内の画像が変更されると、その特定のエントリを参照する 関連するすべてのクラスター の自動更新がトリガーされます。