Container Image Requirements
============================


.. raw:: html

   <!-- SPDX-License-Identifier: CC-BY-4.0 -->

KubernetesのCloudNativePGオペレーターは、次の要件を満たす互換性のあるPostgreSQLコンテナイメージで動作するように設計されています。

- PostgreSQL実行可能ファイルはシステムパスで利用できる必要があります。

- ``initdb``

- ``postgres``

- ``pg_ctl``

- ``pg_controldata``

- ``pg_basebackup``

- 適切なロケール設定が構成済み

オプションのコンポーネント

- `PGAudit <https://www.pgaudit.org/>`_ 拡張機能監査ログが必要な場合にのみ必要

- ``du`` ``kubectl cnpg status`` に使用

..  Note::
   `PostgreSQL versions officially supported by PGDG <https://postgresql.org/>`_ のみが許可されます。 　

..  Note::
   Barman Cloud実行可能ファイルは、CloudNativePGでは必要なくなりました。推奨されるアプローチは、専用の `Barman Cloud Plugin <https://github.com/cloudnative-pg/plugin-barman-cloud>`_  を使用することです。

イメージ定義にエントリーポイントもコマンドも必要ありません。
CloudNativePGは、インスタンスマネージャーで自動的にオーバーライドします。

..  Warning::
   CloudNativePGは、PostgreSQLアプリケーションコンテナイメージの**マルチプル/オプショナルのホットスタンバイサーバーアーキテクチャを備えたプライマリ**のみをサポートしています。 　

CloudNativePGコミュニティは、 `public PostgreSQL container images <https://github.com/cloudnative-pg/postgres-containers>`_ を提供および保守します

CloudNativePGと完全な互換性があります。これらの画像は `ghcr.io <https://ghcr.io/cloudnative-pg/postgresql>`_ 
で公開されています。

イメージタグの要件
------------------

オペレーターが情報に基づいた決定を下せるように、PostgreSQLメジャーバージョンを正確に検出する必要があります。この検出は2つの方法で発生できます。

1. ``imageCatalogRef`` の\ ``major``
   フィールドが定義されている場合、それを利用します。

2. 明示的に指定されていない場合、\ ``imageName``
   のイメージタグからメジャーバージョンを自動検出します。

自動検出が機能するには、イメージタグが特定の形式に準拠している必要があります。これは、有効なPostgreSQLメジャーバージョン番号15.6または16などで始まり、オプションでドットとパッチレベルが続く必要があります。

これに続いて、タグには、Dockerタグで受け入れられる有効な文字の組み合わせを含めることができ、前にドット、アンダースコア、またはマイナス記号が続きます。

受け入れられるイメージタグの例

- ``12.1``

- ``13.3.2.1-1``

- ``13.4``

- ``14``

- ``15.5-10``

- ``16.0``

..  Warning::
   `latest` は、画像の有効なタグとは見なされません。 　

..  Note::
   イメージタグ要件は、カタログで定義されたイメージには適用されません。