APIリファレンス =================== パッケージv1には、postgresql v1 APIグループのAPIスキーマ定義が含まれています リソースタイプ -------------- - :ref:`付録A-バックアップ用の共通オブジェクトストア <付録A-バックアップ用の共通オブジェクトストア>` - :ref:`マルチアベイラビリティーゾーン Kubernetesクラスター <マルチアベイラビリティーゾーン Kubernetesクラスター>` - :ref:`ClusterImageCatalog {postgresql-cnpg-io-v1-ClusterImageCatalog} ` - :ref:`ClusterImageCatalog {postgresql-cnpg-io-v1-ClusterImageCatalog} ` - :ref:`プーラー {postgresql-cnpg-io-v1-Pooler} <プーラー {postgresql-cnpg-io-v1-Pooler}>` - :ref:`ScheduledBackup {postgresql-cnpg-io-v1-ScheduledBackup} ` .. _postgresql-cnpg-io-v1-Backup: Backup ------ BackupはバックアップAPIのスキーマです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `apiVersion` **[Required]** string,`postgresql.cnpg.io/v1` `kind` **[Required]** string,`Backup` `metadata` ** `Required]** [_meta/v1.ObjectMeta_ `__ ,説明はありません。`metadata`フィールドのフィールドについては、Kubernetes APIドキュメントを参照してください。 `spec` ** :ref:`Required]** [_BackupSpec_ <#postgresql-cnpg-io-v1-BackupSpec>` ,バックアップの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status `status` :ref:`_BackupStatus_ <#postgresql-cnpg-io-v1-BackupStatus>` ,最近観察されたバックアップのステータス。このデータは最新でない可能性があります。システムによって設定されます。読み取り専用。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-Cluster: クラスター ---------- クラスターはPostgreSQL APIのスキーマです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `apiVersion` **[Required]** string,`postgresql.cnpg.io/v1` `kind` **[Required]** string,`Cluster` `metadata` ** `Required]** [_meta/v1.ObjectMeta_ `__ ,説明はありません。`metadata`フィールドのフィールドについては、Kubernetes APIドキュメントを参照してください。 `spec` ** :ref:`Required]** [_ClusterSpec_ <#postgresql-cnpg-io-v1-ClusterSpec>` ,クラスターの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status `status` :ref:`_ClusterStatus_ <#postgresql-cnpg-io-v1-ClusterStatus>` ,最近観察されたクラスターのステータス。このデータは最新でない可能性があります。システムによって設定されます。読み取り専用。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-ClusterImageCatalog: ClusterImageCatalog ------------------- ClusterImageCatalogは、 clusterimagecatalogs APIのスキーマです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `apiVersion` **[Required]** string,`postgresql.cnpg.io/v1` `kind` **[Required]** string,`ClusterImageCatalog` `metadata` ** `Required]** [_meta/v1.ObjectMeta_ `__ ,説明はありません。`metadata`フィールドのフィールドについては、Kubernetes APIドキュメントを参照してください。 `spec` ** :ref:`Required]** [_ImageCatalogSpec_ <#postgresql-cnpg-io-v1-ImageCatalogSpec>` ,ClusterImageCatalogの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-ImageCatalog: ImageCatalog ------------ ImageCatalogは、imagecatalogs APIのスキーマです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `apiVersion` **[Required]** string,`postgresql.cnpg.io/v1` `kind` **[Required]** string,`ImageCatalog` `metadata` ** `Required]** [_meta/v1.ObjectMeta_ `__ ,説明はありません。`metadata`フィールドのフィールドについては、Kubernetes APIドキュメントを参照してください。 `spec` ** :ref:`Required]** [_ImageCatalogSpec_ <#postgresql-cnpg-io-v1-ImageCatalogSpec>` ,ImageCatalogの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-Pooler: プーラー -------- Poolerは、プーラーAPIのスキーマです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `apiVersion` **[Required]** string,`postgresql.cnpg.io/v1` `kind` **[Required]** string,`Pooler` `metadata` ** `Required]** [_meta/v1.ObjectMeta_ `__ ,説明はありません。`metadata`フィールドのフィールドについては、Kubernetes APIドキュメントを参照してください。 `spec` ** :ref:`Required]** [_PoolerSpec_ <#postgresql-cnpg-io-v1-PoolerSpec>` ,プーラーの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status `status` :ref:`_PoolerStatus_ <#postgresql-cnpg-io-v1-PoolerStatus>` ,プーラーの最近観察されたステータス。このデータは最新でない可能性があります。システムによって設定されます。読み取り専用。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-ScheduledBackup: ScheduledBackup --------------- ScheduledBackupは、スケジュールされたバックアップAPIのスキーマです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `apiVersion` **[Required]** string,`postgresql.cnpg.io/v1` `kind` **[Required]** string,`ScheduledBackup` `metadata` ** `Required]** [_meta/v1.ObjectMeta_ `__ ,説明はありません。`metadata`フィールドのフィールドについては、Kubernetes APIドキュメントを参照してください。 `spec` ** :ref:`Required]** [_ScheduledBackupSpec_ <#postgresql-cnpg-io-v1-ScheduledBackupSpec>` ,ScheduledBackupの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status `status` :ref:`_ScheduledBackupStatus_ <#postgresql-cnpg-io-v1-ScheduledBackupStatus>` ,ScheduledBackupの最近観察されたステータス。このデータは最新でない可能性があります。システムによって設定されます。読み取り専用。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-AffinityConfiguration: AffinityConfiguration --------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` AffinityConfigurationには、ポッドのアフィニティルールを作成するために必要な情報が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `enablePodAntiAffinity` _bool_,ポッドのアンチアフィニティをアクティブにします。このフィールドが明示的にfalseに設定されていない限り、オペレーターはポッドのアンチアフィニティを定義します `topologyKey` _string_,アンチアフィニティ構成に使用するトポロジキー。その詳細については、k8sドキュメントを参照してください `nodeSelector` _map[string]string_,NodeSelectorは、ポッドを実行できるノードを定義するために使用されるキーと値ペアのマップです。詳細 https://kubernetes.io/docs/concepts/configuration/assign-pod-node/ `nodeAffinity` `_core/v1.NodeAffinity_ `__ ,NodeAffinityは、ポッドのノードアフィニティスケジューリングルールを説明します。詳細 https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#node-affinity `tolerations` `_[]core/v1.Toleration_ `__ ,Tolerationsは、汚染されたノードで実行できるようにするために、すべてのポッドに設定する必要がある許容範囲のリストです。詳細情報 https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/ `podAntiAffinityType` _string_,PodAntiAffinityTypeを使用すると、ユーザーは、クラスターインスタンス間のポッドアンチアフィニティを、スケジュール中に強い要件と見なす必要があるかどうかを決定できます。使用できる値は「preferred」空の場合のデフォルトまたは「required」です。 「required」に設定すると、既存のすべてのノードが必要なポッドのアンチアフィニティルールと一致しない場合、新しいkubernetesノードが追加されるまでインスタンスが保留されたままになる可能性があります。詳細 https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity `additionalPodAntiAffinity` `_core/v1.PodAntiAffinity_ `__ ,AdditionalPodAntiAffinityでは、 EnablePodAntiAffinityがtrueデフォルトに設定されている場合にオペレーターが生成した用語に追加するポッドアンチアフィニティ用語、falseに設定されている場合に排他的に使用されるポッドアンチアフィニティ用語を指定できます。 `additionalPodAffinity` `_core/v1.PodAffinity_ `__ ,AdditionalPodAffinityでは、すべてのクラスターのポッドに渡されるポッドアフィニティ用語を指定できます。 .. _postgresql-cnpg-io-v1-AvailableArchitecture: AvailableArchitecture --------------------- **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` AvailableArchitectureは、クラスターのアーキテクチャの状態を表します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `goArch` **[Required]** _string_,GoArchは実行可能アーキテクチャの名前です `hash` **[Required]** _string_,ハッシュは実行可能ファイルのハッシュです .. _postgresql-cnpg-io-v1-AzureCredentials: AzureCredentials ---------------- **利用箇所** - :ref:`BarmanCredentials {postgresql-cnpg-io-v1-BarmanCredentials} ` AzureCredentialsは、Azure Blob Storageにファイルをアップロードするために使用される資格情報のタイプです。接続文字列には、必要なすべての情報が含まれています。接続文字列が指定されない場合、ストレージアカウント名と、次のいずれか1つだけが必要です。 - storageKey - storageSasToken - manageFromAzureADをtrueに設定することにより、ポッド環境から資格情報を継承する .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `connectionString` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,使用する接続文字列 `storageAccount` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,データをアップロードするストレージアカウント `storageKey` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,ストレージアカウント名と組み合わせて使用されるストレージアカウントキー `storageSasToken` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,ストレージアカウント名と組み合わせて使用する共有アクセス署名 `inheritFromAzureAD` _bool_,キーを明示的に提供せずにAzure ADベースの認証を使用します。 .. _postgresql-cnpg-io-v1-BackupConfiguration: BackupConfiguration ------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` BackupConfigurationは、クラスターのバックアップを取得する方法を定義します。サポートされているバックアップ方法は、BarmanObjectStoreと VolumeSnapshotです。詳細と例については、ドキュメントのバックアップとリカバリーセクションを参照してください。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `volumeSnapshot` :ref:`_VolumeSnapshotConfiguration_ <#postgresql-cnpg-io-v1-VolumeSnapshotConfiguration>` ,VolumeSnapshotは、ボリュームスナップショットバックアップを実行するための構成を提供します。 `barmanObjectStore` :ref:`_BarmanObjectStoreConfiguration_ <#postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration>` ,barman-cloudツールスイートの構成 `retentionPolicy` _string_,RetentionPolicyは、バックアップとWALつまり '60d'に使用される保持ポリシーです。保持ポリシーは`XXu`の形式で表されます。ここで、 `XX`は正の整数、`u`は`[dwm]`-日、週、月です。現在、BarmanObjectStoreメソッドを使用する場合にのみ適用されます。 `target` :ref:`_BackupTarget_ <#postgresql-cnpg-io-v1-BackupTarget>` ,バックアップを実行するインスタンスを決定するポリシー。使用可能なオプションは空の文字列で、デフォルトで`prefer-standby`ポリシー、バックアップを常にプライマリインスタンスで実行する`primary`、可能な場合は最も更新されたスタンバイでバックアップを実行する`prefer-standby`です。 .. _postgresql-cnpg-io-v1-BackupMethod: BackupMethod ------------ ``string`` のエイリアス **利用箇所** - :ref:`BackupSpec {postgresql-cnpg-io-v1-BackupSpec} ` - :ref:`BackupStatus {postgresql-cnpg-io-v1-BackupStatus} ` - :ref:`ScheduledBackupSpec {postgresql-cnpg-io-v1-ScheduledBackupSpec} ` BackupMethodは、選択したPostgreSQLインスタンスの物理ベースのバックアップを実行する方法を定義します .. _postgresql-cnpg-io-v1-BackupPhase: BackupPhase ----------- ``string`` のエイリアス **利用箇所** - :ref:`BackupStatus {postgresql-cnpg-io-v1-BackupStatus} ` BackupPhaseはバックアップのフェーズです .. _postgresql-cnpg-io-v1-BackupPluginConfiguration: BackupPluginConfiguration ------------------------- **利用箇所** - :ref:`BackupSpec {postgresql-cnpg-io-v1-BackupSpec} ` - :ref:`ScheduledBackupSpec {postgresql-cnpg-io-v1-ScheduledBackupSpec} ` BackupPluginConfigurationには、バックアッププラグインが使用するバックアップ構成が含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,Nameは、このバックアップを管理するプラグインの名前です `parameters` _map[string]string_,パラメーターは、このバックアップのバックアッププラグインに渡される構成パラメーターです。 .. _postgresql-cnpg-io-v1-BackupSnapshotElementStatus: BackupSnapshotElementStatus --------------------------- **利用箇所** - :ref:`BackupSnapshotStatus {postgresql-cnpg-io-v1-BackupSnapshotStatus} ` BackupSnapshotElementStatusは、ボリュームスナップショット方式バックアップの一部であるボリュームスナップショットです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,Nameはスナップショットリソース名です `type` **[Required]** _string_,タイプは、クラスター内のスナップショットのロールです。PG_DATA、PG_WAL、PG_TABLESPACEなど `tablespaceName` **[Required]** _string_,TablespaceNameは、スナップショットされたテーブルスペースの名前です。タイプがPG_TABLESPACEの場合にのみ設定されます .. _postgresql-cnpg-io-v1-BackupSnapshotStatus: BackupSnapshotStatus -------------------- **利用箇所** - :ref:`BackupStatus {postgresql-cnpg-io-v1-BackupStatus} ` BackupSnapshotStatus volumeSnapshot方法のバックアップ専用のフィールド .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `elements` :ref:`_[]BackupSnapshotElementStatus_ <#postgresql-cnpg-io-v1-BackupSnapshotElementStatus>` ,収集されたボリュームスナップショットが設定された要素リスト .. _postgresql-cnpg-io-v1-BackupSource: BackupSource ------------ **利用箇所** - :ref:`BootstrapRecovery {postgresql-cnpg-io-v1-BootstrapRecovery} ` BackupSourceには、復元する必要があるバックアップと、それを正しく復元するために必要な情報が含まれています。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `LocalObjectReference` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,`LocalObjectReference`のメンバーはこのタイプに埋め込まれます。説明はありません。 `endpointCA` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,EndpointCAは、バーマンエンドポイントのCAバンドルを保存します。自己署名証明書を使用して、証明書の発行者とbarman-cloud-wal-archiveでのエラーを回避する場合に役立ちます。 .. _postgresql-cnpg-io-v1-BackupSpec: BackupSpec ---------- **利用箇所** - :ref:`付録A-バックアップ用の共通オブジェクトストア <付録A-バックアップ用の共通オブジェクトストア>` BackupSpecは、バックアップの望ましい状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `cluster` ** :ref:`Required]** [_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,バックアップするクラスター `target` :ref:`_BackupTarget_ <#postgresql-cnpg-io-v1-BackupTarget>` ,このバックアップを実行するインスタンスを決定するポリシー。空の場合、デフォルトの`cluster.spec.backup.target`になります。使用可能なオプションは、空の文字列、`primary`および`prefer-standby`です。 `primary`は常にプライマリインスタンスでバックアップを実行します。`prefer-standby`は、可能な場合は最も更新されたスタンバイでバックアップを実行します。 `method` :ref:`_BackupMethod_ <#postgresql-cnpg-io-v1-BackupMethod>` ,使用するバックアップ方法、可能なオプションは`barmanObjectStore`、`volumeSnapshot`または`plugin`です。デフォルト`barmanObjectStore` `pluginConfiguration` :ref:`_BackupPluginConfiguration_ <#postgresql-cnpg-io-v1-BackupPluginConfiguration>` ,このバックアップを管理するプラグインに渡される構成パラメーター `online` _bool_,ボリュームスナップショットを使用したバックアップのデフォルトのタイプがオンライン/ホット `true`、default またはオフライン/コールド `false` かどうか クラスターフィールド '.spec.backup.volumeSnapshot.online'で指定されたデフォルト設定をオーバーライドします `onlineConfiguration` :ref:`_OnlineConfiguration_ <#postgresql-cnpg-io-v1-OnlineConfiguration>` ,ボリュームスナップショットを使用してオンライン/ホットバックアップを制御する構成パラメーター クラスターで指定されたデフォルト設定をオーバーライドします '.backup.volumeSnapshot.onlineConfiguration'スタンザ .. _postgresql-cnpg-io-v1-BackupStatus: BackupStatus ------------ **利用箇所** - :ref:`付録A-バックアップ用の共通オブジェクトストア <付録A-バックアップ用の共通オブジェクトストア>` BackupStatusは、バックアップの監視された状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `BarmanCredentials` :ref:`_BarmanCredentials_ <#postgresql-cnpg-io-v1-BarmanCredentials>` ,`BarmanCredentials`のメンバーはこのタイプに埋め込まれます。各クラウドプロバイダーの潜在的な資格情報 `endpointCA` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,EndpointCAは、バーマンエンドポイントのCAバンドルを保存します。自己署名証明書を使用して、証明書の発行者とbarman-cloud-wal-archiveでのエラーを回避する場合に役立ちます。 `endpointURL` _string_,クラウドにデータをアップロードするために使用されるエンドポイント、自動エンドポイント検出をオーバーライドする `destinationPath` _string_,バックアップを保存するパスつまりs3://bucket/path/to/folder このパスは、さまざまな宛先フォルダーで、WALとデータに使用されます。これは、エラーが発生した場合に入力されない場合があります。 `serverName` _string_,このパラメータが省略された場合、S3のサーバー名、クラスター名が使用されます `encryption` _string_,S3 APIに必要な暗号化方法 `backupId` _string_,BarmanバックアップのID `backupName` _string_,Barmanのバックアップの名前 `phase` :ref:`_BackupPhase_ <#postgresql-cnpg-io-v1-BackupPhase>` ,前回のバックアップステータス `startedAt` `_meta/v1.Time_ `__ ,バックアップが開始されたとき `stoppedAt` `_meta/v1.Time_ `__ ,バックアップが終了したとき `beginWal` _string_,開始するWAL `endWal` _string_,エンディングWAL `beginLSN` _string_,スタートxlog `endLSN` _string_,エンディングxlog `error` _string_,検出されたエラー `commandOutput` _string_,未使用。古いバージョンとの互換性のために保持されています。 `commandError` _string_,エラーが発生した場合のbackupコマンド出力 `backupLabelFile` _[]byte_,オンラインホットバックアップの場合にPostgresから返されたラベルファイルのコンテンツをバックアップします `tablespaceMapFile` _[]byte_,オンラインホットバックアップの場合にPostgresによって返されるテーブルスペースマップファイルのコンテンツ `instanceID` :ref:`_InstanceID_ <#postgresql-cnpg-io-v1-InstanceID>` ,バックアップが取得されたインスタンスを識別する情報 `snapshotBackupStatus` :ref:`_BackupSnapshotStatus_ <#postgresql-cnpg-io-v1-BackupSnapshotStatus>` ,ボリュームのステータススナップショットバックアップ `method` :ref:`_BackupMethod_ <#postgresql-cnpg-io-v1-BackupMethod>` ,使用されているバックアップ方法 `online` **[Required]** _bool_,バックアップがオンライン/ホット `true` またはオフライン/コールド `false` .. _postgresql-cnpg-io-v1-BackupTarget: BackupTarget ------------ ``string`` のエイリアス **利用箇所** - :ref:`BackupConfiguration {postgresql-cnpg-io-v1-BackupConfiguration} ` - :ref:`BackupSpec {postgresql-cnpg-io-v1-BackupSpec} ` - :ref:`ScheduledBackupSpec {postgresql-cnpg-io-v1-ScheduledBackupSpec} ` BackupTargetは、バックアップの優先ターゲットを説明します .. _postgresql-cnpg-io-v1-BarmanCredentials: BarmanCredentials ----------------- **利用箇所** - :ref:`BackupStatus {postgresql-cnpg-io-v1-BackupStatus} ` - :ref:`BarmanObjectStoreConfiguration {postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration} ` BarmanCredentials 各クラウドプロバイダーの潜在的な資格情報を含むオブジェクト .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `googleCredentials` :ref:`_GoogleCredentials_ <#postgresql-cnpg-io-v1-GoogleCredentials>` ,Google Cloud Storageにデータをアップロードするために使用する資格情報 `s3Credentials` :ref:`_S3Credentials_ <#postgresql-cnpg-io-v1-S3Credentials>` ,S3にデータをアップロードするために使用する資格情報 `azureCredentials` :ref:`_AzureCredentials_ <#postgresql-cnpg-io-v1-AzureCredentials>` ,Azure Blob Storageにデータをアップロードするために使用する資格情報 .. _postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration: BarmanObjectStoreConfiguration ------------------------------ **利用箇所** - :ref:`BackupConfiguration {postgresql-cnpg-io-v1-BackupConfiguration} ` - :ref:``externalClusters` セクション <`externalClusters` セクション>` BarmanObjectStoreConfigurationには、S3互換オブジェクトストレージに対してBarmanを使用したバックアップ構成が含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `BarmanCredentials` :ref:`_BarmanCredentials_ <#postgresql-cnpg-io-v1-BarmanCredentials>` ,`BarmanCredentials`のメンバーはこのタイプに埋め込まれます。各クラウドプロバイダーの潜在的な資格情報 `endpointURL` _string_,クラウドにデータをアップロードするために使用されるエンドポイント、自動エンドポイント検出をオーバーライドする `endpointCA` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,EndpointCAは、バーマンエンドポイントのCAバンドルを保存します。自己署名証明書を使用して、証明書の発行者とbarman-cloud-wal-archiveでのエラーを回避する場合に役立ちます `destinationPath` **[Required]** _string_,バックアップを保存するパスつまりs3://bucket/path/to/folder このパスは、さまざまな宛先フォルダーで、WALとデータに使用されます `serverName` _string_,このパラメータが省略された場合、S3のサーバー名、クラスター名が使用されます `wal` :ref:`_WalBackupConfiguration_ <#postgresql-cnpg-io-v1-WalBackupConfiguration>` ,WALストリームのバックアップの構成。定義されない場合、WALファイルは非圧縮で保存され、バケットのデフォルトポリシーに従って、オブジェクトストアで暗号化されない場合があります。 `data` :ref:`_DataBackupConfiguration_ <#postgresql-cnpg-io-v1-DataBackupConfiguration>` ,データファイルのバックアップに使用される構成 定義されていない場合、バケットのデフォルトポリシーに従って、ベースバックアップファイルは非圧縮で保存され、オブジェクトストアで暗号化されない場合があります。 `tags` _map[string]string_,Tagsは、 Barman --tagsオプションに渡されるキー値ペアのリストです。 `historyTags` _map[string]string_,HistoryTagsは、 Barman --history-tagsオプションに渡されるキー値ペアのリストです。 .. _postgresql-cnpg-io-v1-BootstrapConfiguration: BootstrapConfiguration ---------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` BootstrapConfigurationには、PostgreSQLクラスターの作成方法に関する情報が含まれています。サポートされているブートストラップ方法のうち、1つのブートストラップ方法のみを定義できます。 ``initdb`` は、指定しない場合、ブートストラップ方法として使用されます。詳細については、ドキュメントのBootstrapページを参照してください。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `initdb` :ref:`_BootstrapInitDB_ <#postgresql-cnpg-io-v1-BootstrapInitDB>` ,initdbを介してクラスターをブートストラップする `recovery` :ref:`_BootstrapRecovery_ <#postgresql-cnpg-io-v1-BootstrapRecovery>` ,バックアップからクラスターをブートストラップする `pg_basebackup` :ref:`_BootstrapPgBaseBackup_ <#postgresql-cnpg-io-v1-BootstrapPgBaseBackup>` ,互換性のある別のPostgreSQLインスタンスの物理バックアップを取得してクラスターをブートストラップする .. _postgresql-cnpg-io-v1-BootstrapInitDB: BootstrapInitDB --------------- **利用箇所** - :ref:`BootstrapConfiguration {postgresql-cnpg-io-v1-BootstrapConfiguration} ` BootstrapInitDBは、initdbが使用される場合のブートストラッププロセスの構成です。詳細については、ドキュメントのBootstrapページを参照してください。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `database` _string_,アプリケーションが使用するデータベースの名前。デフォルト`app` `owner` _string_,アプリケーションが使用するインスタンス内のデータベースの所有者の名前。 `database`キーの値のデフォルト。 `secret` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,ユーザーデータベースの所有者の初期資格情報を含むシークレットの名前。空の場合、新しいシークレットは最初から作成されます `options` _[]string_,クラスターの作成時にinitdbに渡す必要があるオプションのリスト。非推奨これは、一貫性のない構成を引き起こす可能性があります。代わりに明示的に提供されたパラメーターを使用してください。定義されている場合、明示的な値は無視されます。 `dataChecksums` _bool_,`-k`オプションをinitdbに渡し、データページのチェックサムを有効にするかどうかデフォルト`false` `encoding` _string_,initdbのオプション`--encoding`として渡される値デフォルト`UTF8` `localeCollate` _string_,initdbのオプション`--lc-collate`として渡される値デフォルト`C` `localeCType` _string_,initdbのオプション`--lc-ctype`として渡される値デフォルト`C` `walSegmentSize` _int_,initdbの`--wal-segsize`オプションに渡されるメガバイト単位の値1〜1024デフォルト空、PostgreSQLのデフォルト16MBになります `postInitSQL` _[]string_,クラスターが作成された直後に`postgres`データベースでスーパーユーザーとして実行されるSQLクエリーのリスト-細心の注意を払って使用しますデフォルトでは空 `postInitApplicationSQL` _[]string_,クラスターが作成された直後にアプリケーションデータベースでスーパーユーザーとして実行されるSQLクエリーのリスト-細心の注意を払って使用しますデフォルトでは空 `postInitTemplateSQL` _[]string_,クラスターが作成された直後に`template1`データベースでスーパーユーザーとして実行されるSQLクエリーのリスト-細心の注意を払って使用しますデフォルトでは空 `import` :ref:`_Import_ <#postgresql-cnpg-io-v1-Import>` ,論理バックアップ `pg_dump`および`pg_restore`を使用して既存のPostgreSQLインスタンスからデータをインポートすることにより、新しいクラスターをブートストラップします `postInitApplicationSQLRefs` :ref:`_SQLRefs_ <#postgresql-cnpg-io-v1-SQLRefs>` ,クラスターが作成された直後にアプリケーションデータベースでスーパーユーザーとして実行されるSQLファイルを含むConfigMapまたはSecretへの参照のリスト。参照は特定の順序で処理されます。最初にすべてのシークレットが処理され、次にすべてのConfigMapが処理されます。各グループ内での処理順序は、それぞれの配列で指定されたシーケンスに従います。デフォルトでは空 `postInitTemplateSQLRefs` :ref:`_SQLRefs_ <#postgresql-cnpg-io-v1-SQLRefs>` ,クラスターが作成された直後に`template1`データベースでスーパーユーザーとして実行されるSQLファイルを含むConfigMapまたはSecretへの参照のリスト。参照は特定の順序で処理されます。最初にすべてのシークレットが処理され、次にすべてのConfigMapが処理されます。各グループ内での処理順序は、それぞれの配列で指定されたシーケンスに従います。デフォルトでは空 `postInitSQLRefs` :ref:`_SQLRefs_ <#postgresql-cnpg-io-v1-SQLRefs>` ,クラスターが作成された直後に`postgres`データベースでスーパーユーザーとして実行されるSQLファイルを含むConfigMapまたはSecretへの参照のリスト。参照は特定の順序で処理されます。最初にすべてのシークレットが処理され、次にすべてのConfigMapが処理されます。各グループ内での処理順序は、それぞれの配列で指定されたシーケンスに従います。デフォルトでは空 .. _postgresql-cnpg-io-v1-BootstrapPgBaseBackup: BootstrapPgBaseBackup --------------------- **利用箇所** - :ref:`BootstrapConfiguration {postgresql-cnpg-io-v1-BootstrapConfiguration} ` BootstrapPgBaseBackupには、既存のPostgreSQLクラスターの物理バックアップを取得するために必要な構成が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `source` **[Required]** _string_,物理的バックアップを取得する必要があるサーバーの名前 `database` _string_,アプリケーションが使用するデータベースの名前。デフォルト`app` `owner` _string_,アプリケーションが使用するインスタンス内のデータベースの所有者の名前。 `database`キーの値のデフォルト。 `secret` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,ユーザーデータベースの所有者の初期資格情報を含むシークレットの名前。空の場合、新しいシークレットは最初から作成されます .. _postgresql-cnpg-io-v1-BootstrapRecovery: BootstrapRecovery ----------------- **利用箇所** - :ref:`BootstrapConfiguration {postgresql-cnpg-io-v1-BootstrapConfiguration} ` BootstrapRecoveryには、外部クラスター、ボリュームスナップショット、またはバックアップオブジェクトの3つの方法論を使用して既存のクラスターから復元するために必要な構成が含まれています。フルリカバリーとポイントインタイムリカバリーがサポートされています。この方法は、継続的リカバリーのクラスターレプリカクラスターを作成するために使用することもでき、次の場合にカスケードレプリケーションをサポートします ``instances`` > 1. クラスターがリカバリーを終了すると、スーパーユーザーのパスワードは、提供されたシークレットを介して変更されます。詳細については、ドキュメントのBootstrapページを参照してください。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `backup` :ref:`_BackupSource_ <#postgresql-cnpg-io-v1-BackupSource>` ,リカバリ手順を開始する物理ベースバックアップを含むバックアップオブジェクト。 `source`および`volumeSnapshots`と相互排他的。 `source` _string_,バックアップを復元する外部クラスター。これは、バックアップが保存されるフォルダーの名前としても使用されるため、ソースクラスターの名前に設定する必要があります `backup`と相互排他的。 `volumeSnapshots` :ref:`_DataSource_ <#postgresql-cnpg-io-v1-DataSource>` ,リカバリ手順を開始する静的PVCデータソース。現在、既存のPVCグループをマッピングする`VolumeSnapshot`および`PersistentVolumeClaim`リソースをサポートしており、CloudNativePGと互換性があり、フェンスされたPostgresインスタンスのコールドバックアップコピーで取得されます将来的にオンラインバックアップが実装されるときに削除される制限。 `backup`と相互排他的。 `recoveryTarget` :ref:`_RecoveryTarget_ <#postgresql-cnpg-io-v1-RecoveryTarget>` ,デフォルトでは、復旧プロセスは、アーカイブ内の使用可能なすべてのWALファイルを適用します完全復旧。ただし、一貫した状態に到達するとすぐにリカバリーを終了するか、PostgreSQLで予想されるように`RecoveryTarget`オブジェクトつまりタイムスタンプ、トランザクションID、LSN、..を指定することにより、ポイントインタイムPITRにリカバリーすることもできます。 .)。詳細 https://www.postgresql.org/docs/current/runtime-config-wal.html#RUNTIME-CONFIG-WAL-RECOVERY-TARGET `database` _string_,アプリケーションが使用するデータベースの名前。デフォルト`app` `owner` _string_,アプリケーションが使用するインスタンス内のデータベースの所有者の名前。 `database`キーの値のデフォルト。 `secret` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,ユーザーデータベースの所有者の初期資格情報を含むシークレットの名前。空の場合、新しいシークレットは最初から作成されます .. _postgresql-cnpg-io-v1-CatalogImage: CatalogImage ------------ **利用箇所** - :ref:`ImageCatalogSpec {postgresql-cnpg-io-v1-ImageCatalogSpec} ` CatalogImageはイメージとメジャーバージョンを定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `image` **[Required]** _string_,画像参照 `major` **[Required]** _int_,イメージのPostgreSQLメジャーバージョン。カタログ内で一意である必要があります。 .. _postgresql-cnpg-io-v1-CertificatesConfiguration: CertificatesConfiguration ------------------------- **利用箇所** - :ref:`CertificatesStatus {postgresql-cnpg-io-v1-CertificatesStatus} ` - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` CertificatesConfigurationには、サーバー証明書を処理するために必要な構成が含まれています。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `serverCASecret` _string_,Server CA証明書を含むシークレット。定義されていない場合、新しいシークレットは自己署名CAで作成され、TLS証明書ServerTLSSecretの生成に使用されます。以下が含まれます *`ca.crt` サーバー証明書の検証に使用するCA。クライアント接続文字列で`sslrootcert`として使用されます。* `ca.key` サーバーSSL証明書を生成するために使用されるキー。ServerTLSSecretが提供されている場合、これは省略できます。 `serverTLSSecret` _string_,サーバーTLS証明書とキーを含むkubernetes.io/tlsタイプのシークレット。クライアントがpostgresに安全に接続できるように`ssl_cert_file`および`ssl_key_file`として設定されます。定義されていない場合、ServerCASecretは`ca.key`も提供する必要があり、提供されたCAを使用して新しいシークレットが作成されます。 `replicationTLSSecret` _string_,`streaming_replica`ユーザーとして認証するためのクライアント証明書を含むkubernetes.io/tlsタイプのシークレット。定義されていない場合、 ClientCASecretは`ca.key`も提供する必要があり、新しいシークレットは、提供されたCAを使用して作成されます。 `clientCASecret` _string_,クライアントCA証明書を含むシークレット。定義しない場合、自己署名CAで新しいシークレットが作成され、すべてのクライアント証明書を生成するために使用されます。以下が含まれます *`ca.crt` クライアントを検証するために使用するCA証明書。すべてのインスタンスの`ssl_ca_file`として使用されます。* `ca.key` クライアント証明書の生成に使用されるキー。ReplicationTLSSecretが提供されている場合、これは省略できます。 `serverAltDNSNames` _[]string_,必要に応じて、生成されたサーバーTLS証明書に追加されるサーバー代替DNS名のリスト。 .. _postgresql-cnpg-io-v1-CertificatesStatus: CertificatesStatus ------------------ **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` CertificatesStatusには、構成証明書と関連する有効期限が含まれています。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `CertificatesConfiguration` :ref:`_CertificatesConfiguration_ <#postgresql-cnpg-io-v1-CertificatesConfiguration>` ,`CertificatesConfiguration`のメンバーはこのタイプに埋め込まれています。サーバー証明書を処理するために必要な構成、必要に応じてデフォルト値で初期化されます。 `expirations` _map[string]string_,すべての証明書の有効期限。 .. _postgresql-cnpg-io-v1-ClusterMonitoringTLSConfiguration: ClusterMonitoringTLSConfiguration --------------------------------- **利用箇所** - :ref:`MonitoringConfiguration {postgresql-cnpg-io-v1-MonitoringConfiguration} ` ClusterMonitoringTLSConfigurationは、クラスターのモニタリングのTLS構成を含むタイプです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `enabled` _bool_,監視エンドポイントのTLSを有効にします。このオプションを変更すると、すべてのインスタンスのロールアウトが強制されます。 .. _postgresql-cnpg-io-v1-ClusterSpec: ClusterSpec ----------- **利用箇所** - :ref:`マルチアベイラビリティーゾーン Kubernetesクラスター <マルチアベイラビリティーゾーン Kubernetesクラスター>` ClusterSpecは、クラスターの望ましい状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `description` _string_,このPostgreSQLクラスターの説明 `inheritedMetadata` :ref:`_EmbeddedObjectMetadata_ <#postgresql-cnpg-io-v1-EmbeddedObjectMetadata>` ,クラスターに関連するすべてのオブジェクトが継承するメタデータ `imageName` _string_,コンテナイメージの名前、タグ `:` と決定的で反復可能な展開用のダイジェスト `:@sha256:` の両方をサポート `imageCatalogRef` :ref:`_ImageCatalogRef_ <#postgresql-cnpg-io-v1-ImageCatalogRef>` ,イメージカタログ内で使用するPostgreSQLのメジャーバージョンを定義します `imagePullPolicy` `_core/v1.PullPolicy_ `__ ,イメージプルポリシー。 `Always`、`Never`または`IfNotPresent`のいずれか。定義されていない場合、デフォルトの`IfNotPresent`が使用されます。更新できません。詳細 https://kubernetes.io/docs/concepts/containerimages#updating-images `schedulerName` _string_,指定した場合、ポッドは指定されたKubernetesスケジューラーによってディスパッチされます。指定しない場合、ポッドはデフォルトのスケジューラーによってディスパッチされます。詳細 https://kubernetes.io/docs/concepts/scheduling-eviction/kube-scheduler/ `postgresUID` _int64_,画像内の`postgres`ユーザーのUID、デフォルトは`26` `postgresGID` _int64_,画像内の`postgres`ユーザーのGID、デフォルトは`26` `instances` **[Required]** _int_,クラスターで必要なインスタンスの数 `minSyncReplicas` _int_,プライマリとの同期レプリケーションで必要なインスタンスの最小数。未定義または0では、使用可能なスタンバイがない場合に書き込みを完了できます。 `maxSyncReplicas` _int_,同期レプリケーションクォーラムのターゲット値。準備ができているスタンバイの数がこれよりも少ない場合、削減できます。未定義または0は、同期レプリケーションを無効にします。 `postgresql` :ref:`_PostgresConfiguration_ <#postgresql-cnpg-io-v1-PostgresConfiguration>` ,PostgreSQLサーバーの構成 `replicationSlots` :ref:`_ReplicationSlotsConfiguration_ <#postgresql-cnpg-io-v1-ReplicationSlotsConfiguration>` ,レプリケーションスロット管理構成 `bootstrap` :ref:`_BootstrapConfiguration_ <#postgresql-cnpg-io-v1-BootstrapConfiguration>` ,このクラスターをブートストラップする手順 `replica` :ref:`_ReplicaClusterConfiguration_ <#postgresql-cnpg-io-v1-ReplicaClusterConfiguration>` ,レプリカクラスター構成 `superuserSecret` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,スーパーユーザーのパスワードを含むシークレット。定義されていない場合、ランダムに生成されたパスワードで新しいシークレットが作成されます `enableSuperuserAccess` _bool_,このオプションが有効になっている場合、オペレーターは`SuperuserSecret`を使用して`postgres`ユーザーパスワードを更新しますシークレットが存在しない場合、オペレーターは自動的に作成します。このオプションが無効になっている場合、オペレーターは`SuperuserSecret`コンテンツを無視し、自動的に作成されたら削除し、`NULL`に設定して`postgres`ユーザーのパスワードを空白にします。デフォルトでは無効になっています。 `certificates` :ref:`_CertificatesConfiguration_ <#postgresql-cnpg-io-v1-CertificatesConfiguration>` ,CAおよび関連する証明書の構成 `imagePullSecrets` :ref:`_[]LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,イメージのプルに使用されるプルシークレットのリスト `storage` :ref:`_StorageConfiguration_ <#postgresql-cnpg-io-v1-StorageConfiguration>` ,インスタンスのストレージの構成 `serviceAccountTemplate` :ref:`_ServiceAccountTemplate_ <#postgresql-cnpg-io-v1-ServiceAccountTemplate>` ,サービスアカウントの世代を構成する `walStorage` :ref:`_StorageConfiguration_ <#postgresql-cnpg-io-v1-StorageConfiguration>` ,PostgreSQL WALのストレージの構成書き込み先行ログ `ephemeralVolumeSource` `_core/v1.EphemeralVolumeSource_ `__ ,Ephemeral VolumeSourceを使用すると、ユーザーはエフェメラルボリュームのソースを構成できます。 `startDelay` _int32_,PostgreSQLインスタンスが正常に起動するまでの秒単位の時間デフォルト3600。起動プローブ障害しきい値は、次の式ceiling(startDelay / 10)を使用してこの値から導き出されます。 `stopDelay` _int32_,PostgreSQLインスタンスが正常にシャットダウンできるまでの秒単位の時間デフォルト1800 `smartShutdownTimeout` _int32_,Postgresのスマートシャットダウンが完了するために予約された時間枠を制御する秒単位の時間。オペレーターがPostgresの高速シャットダウンを要求するための十分な時間を確保してください `stopDelay`- `smartShutdownTimeout` 。 `switchoverDelay` _int32_,スイッチオーバー中にプライマリPostgreSQLインスタンスが正常にシャットダウンできる秒単位の時間。デフォルト値は3600秒1時間です。 `failoverDelay` _int32_,クラスター内のプライマリPostgreSQLインスタンスが異常であることが検出された後、フェールオーバーをトリガーするまで待機する時間秒 `livenessProbeTimeout` _int32_,LivenessProbeTimeoutは、PostgreSQLインスタンスがlivenessプローブデフォルト30に正常に応答するまでに許可される時間秒単位です。 Livenessプローブの障害しきい値は、次の式を使用してこの値から導き出されます。ceiling(livenessProbe / 10) `affinity` :ref:`_AffinityConfiguration_ <#postgresql-cnpg-io-v1-AffinityConfiguration>` ,ポッドのアフィニティ/アンチアフィニティルール `topologySpreadConstraints` `_[]core/v1.TopologySpreadConstraint_ `__ ,TopologySpreadConstraintsは、指定されたトポロジ間で一致するポッドを分散する方法を指定します。詳細 https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/ `resources` `_core/v1.ResourceRequirements_ `__ ,生成されたすべてのポッドのリソース要件。詳細については、 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/を参照してください。 `ephemeralVolumesSizeLimit` ** :ref:`Required]** [_EphemeralVolumesSizeLimitConfiguration_ <#postgresql-cnpg-io-v1-EphemeralVolumesSizeLimitConfiguration>` ,Ephemeral VolumesSizeLimitを使用すると、ユーザーは一時ボリュームの制限を設定できます `priorityClassName` _string_,生成されたすべてのポッドで使用される優先度クラスの名前。指定されたPriorityClassが存在しない場合、ポッドはスケジュールできません。詳細については、https://kubernetes.io/docs/concepts/scheduling-eviction/pod-priority-preemption/#priorityclassを参照してください。 `primaryUpdateStrategy` :ref:`_PrimaryUpdateStrategy_ <#postgresql-cnpg-io-v1-PrimaryUpdateStrategy>` ,すべてのレプリカが正常に更新された後、ローリング更新手順中にプライマリサーバーをアップグレードするために従う展開戦略。自動化することができます `unsupervised`-default または手動`supervised` `primaryUpdateMethod` :ref:`_PrimaryUpdateMethod_ <#postgresql-cnpg-io-v1-PrimaryUpdateMethod>` ,すべてのレプリカが正常に更新された後、ローリング更新手順中にプライマリサーバーをアップグレードするために従う方法。スイッチオーバー`switchover`またはインプレース`restart`-defaultを使用できます。 `backup` :ref:`_BackupConfiguration_ <#postgresql-cnpg-io-v1-BackupConfiguration>` ,バックアップに使用される構成 `nodeMaintenanceWindow` :ref:`_NodeMaintenanceWindow_ <#postgresql-cnpg-io-v1-NodeMaintenanceWindow>` ,Kubernetesノードのメンテナンスウィンドウを定義する `monitoring` :ref:`_MonitoringConfiguration_ <#postgresql-cnpg-io-v1-MonitoringConfiguration>` ,このクラスターの監視インフラストラクチャの構成 `externalClusters` :ref:`_[]ExternalCluster_ <#postgresql-cnpg-io-v1-ExternalCluster>` ,構成で使用される外部クラスターのリスト `logLevel` _string_,インスタンスのログレベル、次の値のいずれかError、Warning、infoデフォルト、debug、trace `projectedVolumeTemplate` `_core/v1.ProjectedVolumeSource_ `__ ,投影ボリュームを定義するために使用されるテンプレート。投影ボリュームは`/projected`ベースフォルダーの下にマウントされます `env` `_[]core/v1.EnvVar_ `__ ,Envは、 Env形式に従って、クラスター内に作成されたポッドに環境変数を渡します `envFrom` `_[]core/v1.EnvFromSource_ `__ ,EnvFromは、 EnvFromフォーマットに従って、環境変数ソースをEnvが使用するポッドに渡します `managed` :ref:`_ManagedConfiguration_ <#postgresql-cnpg-io-v1-ManagedConfiguration>` ,インスタンスマネージャーによって管理されるPostgreSQLの部分で使用される構成 `seccompProfile` `_core/v1.SeccompProfile_ `__ ,すべてのポッドとコンテナに適用されるSeccompプロファイル。デフォルト`RuntimeDefault` `tablespaces` :ref:`_[]TablespaceConfiguration_ <#postgresql-cnpg-io-v1-TablespaceConfiguration>` ,テーブルスペース構成 `enablePDB` _bool_,クラスター内の`PodDisruptionBudget`リソースを管理します。 `true`デフォルト設定として構成されている場合、ポッド中断バジェットは、プライマリノードが終了されないように安全に保護されます。逆に、`false`に設定すると、`PodDisruptionBudget`リソースが存在せず、PostgreSQLクラスターをホストするすべてのノードのシャットダウンが許可されます。この後者の構成は、開発/ステージングの目的で使用されるPostgreSQLクラスターにお勧めします。 `plugins` ** :ref:`Required]** [_PluginConfigurationList_ <#postgresql-cnpg-io-v1-PluginConfigurationList>` ,プラグイン構成。対応する構成でロードされるプラグインを含む .. _postgresql-cnpg-io-v1-ClusterStatus: ClusterStatus ------------- **利用箇所** - :ref:`マルチアベイラビリティーゾーン Kubernetesクラスター <マルチアベイラビリティーゾーン Kubernetesクラスター>` ClusterStatusは、クラスターの観察された状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `instances` _int_,クラスター内で検出されたPVCグループの合計数。既存のインスタンスポッドの数とは異なる場合があります。 `readyInstances` _int_,クラスター内の準備ができているインスタンスの合計数。これは、準備ができているインスタンスポッドの数と同じです。 `instancesStatus` _map[PodStatus][]string_,InstancesStatusは、インスタンスがどのステータスを示します `instancesReportedState` :ref:`_map[PodName]InstanceReportedState_ <#postgresql-cnpg-io-v1-InstanceReportedState>` ,最後の調整ループ中に報告されたインスタンスの状態 `managedRolesStatus` :ref:`_ManagedRoles_ <#postgresql-cnpg-io-v1-ManagedRoles>` ,ManchedRolesStatusは、クラスター内の管理対象ロールの状態を報告します `tablespacesStatus` :ref:`_[]TablespaceState_ <#postgresql-cnpg-io-v1-TablespaceState>` ,TablespacesStatusは、クラスター内の宣言的表領域の状態をレポートします `timelineID` _int_,Postgresクラスターのタイムライン `topology` :ref:`_Topology_ <#postgresql-cnpg-io-v1-Topology>` ,インスタンスのトポロジ。 `latestGeneratedNode` _int_,最後に生成されたノードのIDノード名の衝突を回避するために使用されます `currentPrimary` _string_,現在のプライマリインスタンス `targetPrimary` _string_,ターゲットプライマリインスタンス、これは、スイッチオーバーまたはフェイルオーバー中の以前のインスタンスとは異なります。 `lastPromotionToken` **[Required]** _string_,LastPromotionTokenは、レプリカクラスターをプロモートするために使用された最後の検証されたプロモーショントークンです `pvcCount` _int32_,このクラスターによって作成されたPVCの数 `jobCount` _int32_,このクラスターによって作成されたジョブの数 `danglingPVC` _[]string_,このクラスターによって作成され、ポッドに接続されていないまだ使用可能なすべてのPVCのリスト `resizingPVC` _[]string_,ResizingPVC条件を持つすべてのPVCのリスト。 `initializingPVC` _[]string_,このクラスターによって初期化されているすべてのPVCのリスト `healthyPVC` _[]string_,ハングリングも初期化もしていないすべてのPVCのリスト `unusablePVC` _[]string_,別のPVCが欠落しているため使用できないすべてのPVCのリスト `writeService` _string_,現在の書き込みポッド `readService` _string_,読み取りポッドの現在のリスト `phase` _string_,クラスターの現在のフェーズ `phaseReason` _string_,現在のフェーズの理由 `secretsResourceVersion` :ref:`_SecretsResourceVersion_ <#postgresql-cnpg-io-v1-SecretsResourceVersion>` ,オペレーターによって管理されているシークレットのリソースバージョンのリスト。ここでのすべての変更は、インスタンスマネージャーの利益のために行われ、シークレットデータが更新されます `configMapResourceVersion` :ref:`_ConfigMapResourceVersion_ <#postgresql-cnpg-io-v1-ConfigMapResourceVersion>` ,オペレーターによって管理される、構成マップのリソースバージョンのリスト。ここでのすべての変更は、インスタンスマネージャーの利益のために行われ、構成マップデータが更新されます `certificates` :ref:`_CertificatesStatus_ <#postgresql-cnpg-io-v1-CertificatesStatus>` ,CAおよび関連する証明書の構成。デフォルトで初期化されます。 `firstRecoverabilityPoint` _string_,最初の復旧可能ポイント。RFC3339形式の日付として保存されます。このフィールドは、FirstRecoverabilityPointByMethodの内容から計算されます `firstRecoverabilityPointByMethod` `_map[BackupMethod]meta/v1.Time_ `__ ,バックアップ方法タイプごとに、RFC3339形式の日付として保存される最初の復旧可能ポイント `lastSuccessfulBackup` _string_,最後に成功したバックアップ、RFC3339形式の日付として保存されますこのフィールドは、LastSuccessfulBackupByMethodの内容から計算されます `lastSuccessfulBackupByMethod` `_map[BackupMethod]meta/v1.Time_ `__ ,最後に成功したバックアップ、バックアップ方法タイプごとにRFC3339形式で日付として保存 `lastFailedBackup` _string_,RFC3339形式の日付として保存 `cloudNativePGCommitHash` _string_,このオペレーターが実行しているコミットハッシュ番号 `currentPrimaryTimestamp` _string_,最後にプライマリへの実際の昇格が発生したタイムスタンプ `currentPrimaryFailingSinceTimestamp` _string_,プライマリが異常であることが検出されたときのタイムスタンプ このフィールドは、`.spec.failoverDelay`が設定されたとき、またはオンラインアップグレード中に報告されます `targetPrimaryTimestamp` _string_,新しいプライマリの最後の要求が発生したタイムスタンプ `poolerIntegrations` :ref:`_PoolerIntegrations_ <#postgresql-cnpg-io-v1-PoolerIntegrations>` ,クラスターを参照するプーラーに必要な統合 `cloudNativePGOperatorHash` _string_,オペレーターのバイナリのハッシュ `availableArchitectures` :ref:`_[]AvailableArchitecture_ <#postgresql-cnpg-io-v1-AvailableArchitecture>` ,AvailableArchitecturesは、クラスターの使用可能なアーキテクチャをレポートします `conditions` `_[]meta/v1.Condition_ `__ ,クラスターオブジェクトの条件 `instanceNames` _[]string_,クラスター内のインスタンス名のリスト `onlineUpdateEnabled` _bool_,OnlineUpdateEnabledは、クラスター内でオンラインアップグレードが有効になっているかどうかを示します `azurePVCUpdateEnabled` _bool_,AzurePVCUpdateEnabledは、このクラスターでPVCオンラインアップグレードが有効になっているかどうかを示します `image` _string_,イメージには、ポッドが使用するイメージ名が含まれています `pluginStatus` ** :ref:`Required]** [_[]PluginStatus_ <#postgresql-cnpg-io-v1-PluginStatus>` ,PluginStatusは、ロードされたプラグインのステータスです `switchReplicaClusterStatus` :ref:`_SwitchReplicaClusterStatus_ <#postgresql-cnpg-io-v1-SwitchReplicaClusterStatus>` ,SwitchReplicaClusterStatusは、レプリカクラスターへのスイッチのステータスです `demotionToken` _string_,DemotionTokenは、データベースシステム識別子、最新のチェックポイントのTimeLineID、最新のチェックポイントのREDO場所、最新のチェックポイントのREDO WALファイル、最新のチェックポイントの時間などのpg_controldataからの情報を含むJSONトークン .. _postgresql-cnpg-io-v1-CompressionType: CompressionType --------------- ``string`` のエイリアス **利用箇所** - :ref:`DataBackupConfiguration {postgresql-cnpg-io-v1-DataBackupConfiguration} ` - :ref:`WalBackupConfiguration {postgresql-cnpg-io-v1-WalBackupConfiguration} ` CompressionTypeは、使用可能な圧縮の種類をカプセル化します .. _postgresql-cnpg-io-v1-ConfigMapKeySelector: ConfigMapKeySelector -------------------- **利用箇所** - :ref:`MonitoringConfiguration {postgresql-cnpg-io-v1-MonitoringConfiguration} ` - :ref:`SQLRefs {postgresql-cnpg-io-v1-SQLRefs} ` ConfigMapKeySelectorには、ConfigMapのキーを見つけられるように十分な情報が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `LocalObjectReference` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,`LocalObjectReference`のメンバーはこのタイプに埋め込まれています。選択するポッドの名前空間のシークレットの名前。 `key` **[Required]** _string_,選択するキー .. _postgresql-cnpg-io-v1-ConfigMapResourceVersion: ConfigMapResourceVersion ------------------------ **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` ConfigMapResourceVersionは、オペレーターが管理するシークレットのリソースバージョンです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `metrics` _map[string]string_,メトリックを渡すために使用されるすべての構成マップのバージョンを含むマップ。マップキーは構成マップ名であり、マップ値はバージョンです .. _postgresql-cnpg-io-v1-DataBackupConfiguration: DataBackupConfiguration ----------------------- **利用箇所** - :ref:`BarmanObjectStoreConfiguration {postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration} ` DataBackupConfigurationは、データディレクトリのバックアップの構成です .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `compression` :ref:`_CompressionType_ <#postgresql-cnpg-io-v1-CompressionType>` ,バックアップファイルテーブルスペースごとのtarファイルをオブジェクトストアにストリーミングしながら圧縮します。使用可能なオプションは、空の文字列圧縮なし、デフォルト、`gzip`、`bzip2`、または`snappy`です。 `encryption` :ref:`_EncryptionType_ <#postgresql-cnpg-io-v1-EncryptionType>` ,ファイルの暗号化を強制する場合バケットがそのようにまだ構成されていない場合。許可されるオプションは空の文字列バケットポリシーを使用しますデフォルト 、`AES256`および`aws:kms`です `jobs` _int32_,バックアップのアップロードに使用される並列ジョブの数、デフォルト2 `immediateCheckpoint` _bool_,PostgreSQLサーバーの`checkpoint_completion_target`設定に従って、バックアップの初期チェックポイントのI/Oワークロードを制限するかどうかを制御します。 trueに設定されている場合、即時チェックポイントが使用されます。つまり、PostgreSQLができるだけ早くチェックポイントを完了します。デフォルトでは`false`。 `additionalCommandArgs` **[Required]** _[]string_,AdditionalCommandArgsは、'barman-cloud-backup'コマンドライン呼び出しに追加できる追加引数を表します。これらの引数は、特定の要件または構成に応じてバックアッププロセスをさらにカスタマイズする柔軟性を提供します。 例 特定のタイムアウトの設定やカスタム動作の定義など、特殊なバックアップオプションが必要なシナリオでは、ユーザーはこのフィールドを使用して追加のコマンド引数を指定できます。 注 実行中の潜在的なエラーまたは意図しない動作を回避するには、指定された引数が有効であり、 'barman-cloud-backup'コマンドでサポートされていることを確認することが重要です。 .. _postgresql-cnpg-io-v1-DataSource: DataSource ---------- **利用箇所** - :ref:`BootstrapRecovery {postgresql-cnpg-io-v1-BootstrapRecovery} ` データソースには、既存のストレージからPostgreSQLクラスターをブートストラップするために必要な構成が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `storage` ** `Required]** [_core/v1.TypedLocalObjectReference_ `__ ,インスタンスのストレージの構成 `walStorage` `_core/v1.TypedLocalObjectReference_ `__ ,PostgreSQL WALのストレージの構成書き込み先行ログ `tablespaceStorage` `_map[string]core/v1.TypedLocalObjectReference_ `__ ,PostgreSQLテーブルスペースのストレージの構成 .. _postgresql-cnpg-io-v1-DatabaseRoleRef: DatabaseRoleRef --------------- **利用箇所** - :ref:`TablespaceConfiguration {postgresql-cnpg-io-v1-TablespaceConfiguration} ` DatabaseRoleRefは、PostgreSQL内で使用可能なロールの参照です .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` _string_,説明はありません。 .. _postgresql-cnpg-io-v1-EmbeddedObjectMetadata: EmbeddedObjectMetadata ---------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` EmbeddedObjectMetadataには、クラスターに関連するすべてのリソースによって継承されるメタデータが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `labels` _map[string]string_,説明はありません。 `annotations` _map[string]string_,説明はありません。 .. _postgresql-cnpg-io-v1-EncryptionType: EncryptionType -------------- ``string`` のエイリアス **利用箇所** - :ref:`DataBackupConfiguration {postgresql-cnpg-io-v1-DataBackupConfiguration} ` - :ref:`WalBackupConfiguration {postgresql-cnpg-io-v1-WalBackupConfiguration} ` EncryptionTypeは、使用可能な暗号化の種類をカプセル化しました .. _postgresql-cnpg-io-v1-EnsureOption: EnsureOption ------------ ``string`` のエイリアス **利用箇所** - :ref:`RoleConfiguration {postgresql-cnpg-io-v1-RoleConfiguration} ` EnsureOptionは、PostgreSQLインスタンスにロールの存在または不存在を強制するかどうかを表します Ephemeral VolumesSizeLimitConfiguration {#postgresql-cnpg-io-v1-Ephemeral VolumesSizeLimitConfiguration} -------------------------------------------------------------------------------------------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` Ephemeral VolumesSizeLimitConfigurationには、エフェメラルストレージの構成が含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `shm` ** `Required]** [_k8s.io/apimachinery/pkg/api/resource.Quantity_ `__ ,Shmは、共有メモリボリュームのサイズ制限です `temporaryData` ** `Required]** [_k8s.io/apimachinery/pkg/api/resource.Quantity_ `__ ,TemporaryDataは、一時データボリュームのサイズ制限です .. _postgresql-cnpg-io-v1-外部クラスター: 外部クラスター -------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` 外部クラスターは、構成の他のセクションで使用される外部クラスターへの接続パラメーターを表します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,サーバー名必須 `connectionParameters` _map[string]string_,dbname、ホスト、ユーザー名などの接続パラメーターのリスト `sslCert` `_core/v1.SecretKeySelector_ `__ ,このインスタンスへの接続に使用されるSSL証明書への参照 `sslKey` `_core/v1.SecretKeySelector_ `__ ,このインスタンスへの接続に使用されるSSLプライベートキーへの参照 `sslRootCert` `_core/v1.SecretKeySelector_ `__ ,このインスタンスへの接続に使用されるSSL CA公開キーへの参照 `password` `_core/v1.SecretKeySelector_ `__ ,"サーバーへの接続に使用されるパスワードへの参照。パスワードが指定された場合、CloudNativePGは`/controller/external/NAME/pass`でPostgreSQLパスファイルを作成します""NAME""はクラスターの名前です。このパスファイルは、現在のPostgreSQL `Cluster`からリモートPostgreSQLサーバーへの接続を確立するときに、接続文字列で自動的に参照されます。これにより、外部クラスターの安全で効率的なパスワード管理が保証されます。" `barmanObjectStore` :ref:`_BarmanObjectStoreConfiguration_ <#postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration>` ,barman-cloudツールスイートの構成 .. _postgresql-cnpg-io-v1-GoogleCredentials: GoogleCredentials ----------------- **利用箇所** - :ref:`BarmanCredentials {postgresql-cnpg-io-v1-BarmanCredentials} ` GoogleCredentialsは、Google Cloud Storage資格情報のタイプです。これは、GKE環境内で実行する場合でも指定する必要があります。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `applicationCredentials` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,資格情報を含むGoogle Cloud Storage JSONファイルを含むシークレット `gkeEnvironment` _bool_,trueに設定されている場合、GKE環境内で実行されていると想定されます。デフォルトはfalseです。 .. _postgresql-cnpg-io-v1-ImageCatalogRef: ImageCatalogRef --------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` ImageCatalogRefは、ImageCatalog内のメジャーバージョンへの参照を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `TypedLocalObjectReference` `_core/v1.TypedLocalObjectReference_ `__ ,`TypedLocalObjectReference`のメンバーはこのタイプに埋め込まれます。説明はありません。 `major` **[Required]** _int_,ImageCatalogから使用するPostgreSQLのメジャーバージョン .. _postgresql-cnpg-io-v1-ImageCatalogSpec: ImageCatalogSpec ---------------- **利用箇所** - :ref:`ClusterImageCatalog {postgresql-cnpg-io-v1-ClusterImageCatalog} ` - :ref:`ClusterImageCatalog {postgresql-cnpg-io-v1-ClusterImageCatalog} ` ImageCatalogSpecは、目的のイメージカタログを定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `images` ** :ref:`Required]** [_[]CatalogImage_ <#postgresql-cnpg-io-v1-CatalogImage>` ,カタログで使用可能なカタログ画像のリスト .. _postgresql-cnpg-io-v1-Import: Import ------ **利用箇所** - :ref:`BootstrapInitDB {postgresql-cnpg-io-v1-BootstrapInitDB} ` インポートには、外部クラスターの論理スナップショットからデータベースを初期化する構成が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `source` ** :ref:`Required]** [_ImportSource_ <#postgresql-cnpg-io-v1-ImportSource>` ,輸入元 `type` ** :ref:`Required]** [_SnapshotType_ <#postgresql-cnpg-io-v1-SnapshotType>` ,インポートタイプ。 `microservice`または`monolith`です。 `databases` **[Required]** _[]string_,インポートするデータベース `roles` _[]string_,インポートするロール `postImportApplicationSQL` _[]string_,インポートされた直後にアプリケーションデータベースでスーパーユーザーとして実行されるSQLクエリーのリスト。細心の注意を払って使用されますデフォルトでは空。マイクロサービスタイプでのみ使用できます。 `schemaOnly` _bool_,trueに設定されている場合、 `pg_restore`の`pre-data`および`post-data`セクションのみが呼び出され、データのインポートが回避されます。デフォルト`false` .. _postgresql-cnpg-io-v1-ImportSource: ImportSource ------------ **利用箇所** - :ref:`Import {postgresql-cnpg-io-v1-Import} ` ImportSourceは、論理スナップショットのソースを説明します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `externalCluster` **[Required]** _string_,インポートに使用される外部クラスターの名前 .. _postgresql-cnpg-io-v1-InstanceID: インスタンスID -------------- **利用箇所** - :ref:`BackupStatus {postgresql-cnpg-io-v1-BackupStatus} ` InstanceIDには、インスタンスを識別する情報が含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `podName` _string_,ポッド名 `ContainerID` _string_,コンテナID .. _postgresql-cnpg-io-v1-InstanceReportedState: InstanceReportedState --------------------- **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` InstanceReportedStateは、調整ループ中に最後に報告されたインスタンスの状態を説明します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `isPrimary` **[Required]** _bool_,インスタンスがプライマリかどうかを示します `timeLineID` _int_,インスタンスがどのTimelineIdにあるかを示します .. _postgresql-cnpg-io-v1-LDAPBindAsAuth: LDAPBindAsAuth -------------- **利用箇所** - :ref:`LDAPConfig {postgresql-cnpg-io-v1-LDAPConfig} ` LDAPBindAsAuthは、 LDAPのバインド認証を使用するための必須フィールドを提供します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `prefix` _string_,バインド認証オプションのプレフィックス `suffix` _string_,バインド認証オプションのサフィックス .. _postgresql-cnpg-io-v1-LDAPBindSearchAuth: LDAPBindSearchAuth ------------------ **利用箇所** - :ref:`LDAPConfig {postgresql-cnpg-io-v1-LDAPConfig} ` LDAPBindSearchAuthは、バインド+検索LDAP認証プロセスを使用するための必須フィールドを提供します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `baseDN` _string_,ユーザー検索を開始するルートDN `bindDN` _string_,ディレクトリにバインドするユーザーのDN `bindPassword` `_core/v1.SecretKeySelector_ `__ ,ディレクトリにバインドするユーザーのパスワードを使用したシークレット `searchAttribute` _string_,ユーザー名と一致する属性 `searchFilter` _string_,検索+バインド認証を実行するときに使用する検索フィルター .. _postgresql-cnpg-io-v1-LDAPConfig: LDAPConfig ---------- **利用箇所** - :ref:`PostgresConfiguration {postgresql-cnpg-io-v1-PostgresConfiguration} ` LDAPConfigには、LDAP認証に必要なパラメーターが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `server` _string_,LDAPホスト名またはIPアドレス `port` _int_,LDAPサーバーポート `scheme` :ref:`_LDAPScheme_ <#postgresql-cnpg-io-v1-LDAPScheme>` ,使用するLDAPスキーマ、使用可能なオプションは`ldap`および`ldaps`です `bindAsAuth` :ref:`_LDAPBindAsAuth_ <#postgresql-cnpg-io-v1-LDAPBindAsAuth>` ,認証構成としてバインド `bindSearchAuth` :ref:`_LDAPBindSearchAuth_ <#postgresql-cnpg-io-v1-LDAPBindSearchAuth>` ,バインド+サーチ認証構成 `tls` _bool_,LDAP over TLSを有効にするには、 'true'に設定します。 'false'がデフォルトです .. _postgresql-cnpg-io-v1-LDAPScheme: LDAPScheme ---------- ``string`` のエイリアス **利用箇所** - :ref:`LDAPConfig {postgresql-cnpg-io-v1-LDAPConfig} ` LDAPSchemeは、 LDAPの使用可能なスキームを定義します .. _postgresql-cnpg-io-v1-LocalObjectReference: LocalObjectReference -------------------- **利用箇所** - :ref:`BackupSource {postgresql-cnpg-io-v1-BackupSource} ` - :ref:`BackupSpec {postgresql-cnpg-io-v1-BackupSpec} ` - :ref:`BootstrapInitDB {postgresql-cnpg-io-v1-BootstrapInitDB} ` - :ref:`BootstrapPgBaseBackup {postgresql-cnpg-io-v1-BootstrapPgBaseBackup} ` - :ref:`BootstrapRecovery {postgresql-cnpg-io-v1-BootstrapRecovery} ` - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` - :ref:`ConfigMapKeySelector {postgresql-cnpg-io-v1-ConfigMapKeySelector} ` - :ref:`PgBouncerSpec {postgresql-cnpg-io-v1-PgBouncerSpec} ` - :ref:`PoolerSpec {postgresql-cnpg-io-v1-PoolerSpec} ` - :ref:`RoleConfiguration {postgresql-cnpg-io-v1-RoleConfiguration} ` - :ref:`ScheduledBackupSpec {postgresql-cnpg-io-v1-ScheduledBackupSpec} ` - :ref:`SecretKeySelector {postgresql-cnpg-io-v1-SecretKeySelector} ` LocalObjectReferenceには、同じ名前空間内の既知のタイプを持つローカルオブジェクトを見つけるための十分な情報が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,参照先の名前。 .. _postgresql-cnpg-io-v1-ManchedConfiguration: ManchedConfiguration -------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` ManageConfigurationは、インスタンスマネージャーによって管理されるPostgreSQLの部分を表します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `roles` :ref:`_[]RoleConfiguration_ <#postgresql-cnpg-io-v1-RoleConfiguration>` ,`Cluster`によって管理されるデータベースロール `services` :ref:`_ManagedServices_ <#postgresql-cnpg-io-v1-ManagedServices>` ,`Cluster`によって管理されるサービスロール .. _postgresql-cnpg-io-v1-ManadedRoles: ManchedRoles ------------ **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` ManageRolesは、クラスターの管理対象ロールのステータスを追跡します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `byStatus` _map[RoleStatus][]string_,ByStatusは、各状態のロールのリストを提供します `cannotReconcile` _map[string][]string_,CannotReconcileは、PostgreSQLでリコンサイルできないロールと、その原因の説明をリストします `passwordStatus` :ref:`_map[string]PasswordState_ <#postgresql-cnpg-io-v1-PasswordState>` ,PasswordStatusは、各管理対象ロールの最後のトランザクションIDとパスワードのシークレットバージョンを提供します .. _postgresql-cnpg-io-v1-ManchedService: ManchedService -------------- **利用箇所** - :ref:`ManagedServices {postgresql-cnpg-io-v1-ManagedServices} ` ManchedServiceは、クラスターによって管理される特定のサービスを表します。これには、サービスの種類とそれに関連するテンプレート仕様が含まれます。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `selectorType` ** :ref:`Required]** [_ServiceSelectorType_ <#postgresql-cnpg-io-v1-ServiceSelectorType>` ,SelectorTypeは、サービスが持つセレクターのタイプを指定します。有効な値は「rw」、「r」、および「ro」で、読み取り書き込み、読み取り、および読み取り専用サービスを表します。 `updateStrategy` ** :ref:`Required]** [_ServiceUpdateStrategy_ <#postgresql-cnpg-io-v1-ServiceUpdateStrategy>` ,UpdateStrategyは、サービスの違いを調整する方法を説明します `serviceTemplate` ** :ref:`Required]** [_ServiceTemplateSpec_ <#postgresql-cnpg-io-v1-ServiceTemplateSpec>` ,ServiceTemplateは、サービスのテンプレート仕様です。 .. _postgresql-cnpg-io-v1-ManagedServices: ManagedServices --------------- **利用箇所** - :ref:`ManchedConfiguration {postgresql-cnpg-io-v1-ManchedConfiguration} ` ManagedServicesは、クラスターによって管理されるサービスを表します。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `disabledDefaultServices` :ref:`_[]ServiceSelectorType_ <#postgresql-cnpg-io-v1-ServiceSelectorType>` ,DisabledDefaultServicesは、デフォルトで無効になっているサービスタイプのリストです。有効な値は「r」および「ro」で、読み取りおよび読み取り専用サービスを表します。 `additional` ** :ref:`Required]** [_[]ManagedService_ <#postgresql-cnpg-io-v1-ManagedService>` ,Additionalは、ユーザーが指定した追加の管理サービスのリストです。 .. _postgresql-cnpg-io-v1-Metadata: メタデータ ---------- **利用箇所** - :ref:`PodTemplateSpec {postgresql-cnpg-io-v1-PodTemplateSpec} ` - :ref:`ServiceAccountTemplate {postgresql-cnpg-io-v1-ServiceAccountTemplate} ` - :ref:`ServiceTemplateSpec {postgresql-cnpg-io-v1-ServiceTemplateSpec} ` メタデータはmetav1.ObjectMetaに似た構造ですが、controller-genによって解析され、ユーザーに適切なCRDを作成できます。 PodTemplateSpecのコメントには、コアデータ型を使用しない理由の説明があります。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,リソースの名前。特定のタイプでのみサポートされています `labels` _map[string]string_,オブジェクトを整理および分類および選択するために使用できる文字列キーと値のマップ。レプリケーションコントローラとサービスのセレクターと一致する場合があります。詳細 http://kubernetes.io/docs/user-guide/labels `annotations` _map[string]string_,アノテーションは、リソースと共に保存される非構造化キー値マップであり、任意のメタデータを保存および取得する外部ツールによって設定される場合があります。これらは照会不可であり、オブジェクトを変更するときに保存する必要があります。詳細 http://kubernetes.io/docs/user-guide/annotations .. _postgresql-cnpg-io-v1-MonitoringConfiguration: MonitoringConfiguration ----------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` MonitoringConfigurationは、特定のクラスターのすべての監視構成を含むタイプです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `disableDefaultQueries` _bool_,デフォルトのクエリーを挿入するかどうか。クラスターにデフォルトのクエリーを挿入したくない場合は、`true`に設定します。デフォルトfalse。 `customQueriesConfigMap` :ref:`_[]ConfigMapKeySelector_ <#postgresql-cnpg-io-v1-ConfigMapKeySelector>` ,カスタムクエリを含む構成マップのリスト `customQueriesSecret` :ref:`_[]SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,カスタムクエリーを含むシークレットのリスト `enablePodMonitor` _bool_,`PodMonitor`を有効または無効にします `tls` :ref:`_ClusterMonitoringTLSConfiguration_ <#postgresql-cnpg-io-v1-ClusterMonitoringTLSConfiguration>` ,メトリックエンドポイントのTLS通信を構成します。 tls.enabledオプションを変更すると、すべてのインスタンスのロールアウトが強制されます。 `podMonitorMetricRelabelings` :ref:`archive_timeout <モニタリング>` ,`PodMonitor`のメトリックの再ラベル付けのリスト。摂取する前にサンプルに適用されます。 `podMonitorRelabelings` :ref:`archive_timeout <モニタリング>` ,`PodMonitor`の再ラベル付けのリスト。スクレイピングの前にサンプルに適用されます。 .. _postgresql-cnpg-io-v1-NodeMaintenanceWindow: NodeMaintenanceWindow --------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` NodeMaintenanceWindowには、基になるノードのアップグレード中にオペレーターが使用する情報が含まれています。 このオプションは、選択したストレージがポッドをノード間で自由に移動できない場合にのみ役立ちます。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `reusePVC` _bool_,既存のPVCを再利用するノードが再び起動するまで待機するか、他の場所で再作成します- `instances` >1の場合 `inProgress` _bool_,進行中のノードのメンテナンスアクティビティはありますか? .. _postgresql-cnpg-io-v1-OnlineConfiguration: OnlineConfiguration ------------------- **利用箇所** - :ref:`BackupSpec {postgresql-cnpg-io-v1-BackupSpec} ` - :ref:`ScheduledBackupSpec {postgresql-cnpg-io-v1-ScheduledBackupSpec} ` - :ref:`VolumeSnapshotConfiguration {postgresql-cnpg-io-v1- VolumeSnapshotConfiguration} ` OnlineConfigurationには、オンラインボリュームスナップショットの構成パラメーターが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `waitForArchive` _bool_,falseの場合、ファンクションは、バックアップが完了すると、WALがアーカイブされるのを待たずに、すぐに返されます。この動作は、WALアーカイブを個別に監視するバックアップソフトウェアでのみ役立ちます。そうしないと、バックアップの一貫性を保つために必要なWALが欠落し、バックアップが役に立たなくなる可能性があります。デフォルトでは、またはこのパラメータがtrueの場合、アーカイブが有効になっているときにpg_backup_stopはWALがアーカイブされるまで待機します。スタンバイでは、これはarchive_mode = Alwaysの場合にのみ待機することを意味します。プライマリの書き込みアクティビティが低い場合、プライマリでpg_switch_walを実行して、即時セグメントスイッチをトリガーすると役立つ場合があります。 `immediateCheckpoint` _bool_,PostgreSQLサーバーの`checkpoint_completion_target`設定に従って、バックアップの初期チェックポイントのI/Oワークロードを制限するかどうかを制御します。 trueに設定されている場合、即時チェックポイントが使用されます。つまり、PostgreSQLができるだけ早くチェックポイントを完了します。デフォルトでは`false`。 .. _postgresql-cnpg-io-v1-PasswordState: PasswordState ------------- **利用箇所** - :ref:`ManchedRoles {postgresql-cnpg-io-v1-ManadedRoles} ` PasswordStateは、管理対象ロール構成のパスワードの状態を表します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `transactionID` _int64_,PostgreSQLのロール定義に影響を与える最後のトランザクションID `resourceVersion` _string_,パスワードシークレットのリソースバージョン .. _postgresql-cnpg-io-v1-PgBouncerIntegrationStatus: PgBouncerIntegrationStatus -------------------------- **利用箇所** - :ref:`PoolerIntegrations {postgresql-cnpg-io-v1-PoolerIntegrations} ` PgBouncerIntegrationStatusは、クラスターを参照するpgbouncerプーラーに必要な統合をカプセル化します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `secrets` _[]string_,説明はありません。 .. _postgresql-cnpg-io-v1-PgBouncerPoolMode: PgBouncerPoolMode ----------------- ``string`` のエイリアス **利用箇所** - :ref:`PgBouncerSpec {postgresql-cnpg-io-v1-PgBouncerSpec} ` PgBouncerPoolModeはPgBouncerのモードです .. _postgresql-cnpg-io-v1-PgBouncerSecrets: PgBouncerSecrets ---------------- **利用箇所** - :ref:`PoolerSecrets {postgresql-cnpg-io-v1-PoolerSecrets} ` PgBouncerSecretsには、pgbouncerが使用するシークレットのバージョンが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `authQuery` :ref:`_SecretVersion_ <#postgresql-cnpg-io-v1-SecretVersion>` ,認証クエリーのシークレットバージョン .. _postgresql-cnpg-io-v1-PgBouncerSpec: PgBouncerSpec ------------- **利用箇所** - :ref:`PoolerSpec {postgresql-cnpg-io-v1-PoolerSpec} ` PgBouncerSpecは、PgBouncerの構成方法を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `poolMode` :ref:`_PgBouncerPoolMode_ <#postgresql-cnpg-io-v1-PgBouncerPoolMode>` ,プールモード。デフォルト`session` `authQuerySecret` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,"認証クエリーに使用する必要があるユーザーの資格情報。指定される場合、AuthQuery たとえば、 ""SELECT usename, passwd FROM pg_catalog.pg_shadow WHERE usename=$1"" を指定する必要があり、自動CNPGクラスター統合はトリガーされません。" `authQuery` _string_,"特定のユーザーのパスワードのハッシュをダウンロードするために使用されるクエリー。デフォルト「SELECT usename, passwd FROM public.user_search($1)」。指定される場合、AuthQuerySecretも指定する必要があり、自動CNPGクラスター統合はトリガーされません。" `parameters` _map[string]string_,PgBouncerに渡される追加パラメーター-構成可能なオプションのリストについては、CNPGドキュメントを確認してください `pg_hba` _[]string_,PostgreSQLホストベースの認証ルール pg_hba.confファイルに追加される行 `paused` _bool_,`true`に設定すると、PgBouncerはPostgreSQLサーバーから切断し、最初にすべてのクエリが完了するのを待機し、この値が`false`デフォルトに設定されるまで、すべての新しいクライアント接続を一時停止します。内部的には、オペレーターはPgBouncerの`PAUSE`および`RESUME`コマンドを呼び出します。 .. _postgresql-cnpg-io-v1-PluginStatus: PluginStatus ------------ **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` PluginStatusは、ロードされたプラグインのステータスです .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,Nameはプラグインの名前です `version` **[Required]** _string_,バージョンは、最新の調整ループによってロードされたプラグインのバージョンです `capabilities` **[Required]** _[]string_,Capacityは、プラグインの機能のリストです。 `operatorCapabilities` **[Required]** _[]string_,OperatorCapabilitiesは、リコンサイラーに関するプラグインの機能のリストです。 `walCapabilities` **[Required]** _[]string_,WALCapabilitiesは、WAL管理に関するプラグインの機能のリストです。 `backupCapabilities` **[Required]** _[]string_,BackupCapabilitiesは、バックアップ管理に関するプラグインの機能のリストです。 `status` **[Required]** _string_,ステータスには、 SetStatusInClusterインターフェイスを介してプラグインによって報告されたステータスが含まれます .. _postgresql-cnpg-io-v1-PodTemplateSpec: PodTemplateSpec --------------- **利用箇所** - :ref:`PoolerSpec {postgresql-cnpg-io-v1-PoolerSpec} ` PodTemplateSpecは、ユーザーがPod生成のテンプレートを設定できる構造です。 残念ながら、生成されたCRDにはメタデータセクションのフィールドが含まれないため、 corev1.PodTemplateSpecタイプは使用できません。 参考 https://github.com/kubernetes-sigs/controller-tools/issues/385 https://github.com/kubernetes-sigs/controller-tools/issues/448 https://github.com/prometheus- Operator/prometheus-operator/issues/3041 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `metadata` :ref:`_Metadata_ <#postgresql-cnpg-io-v1-Metadata>` ,標準オブジェクトのメタデータ。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata `spec` `_core/v1.PodSpec_ `__ ,ポッドの目的の動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-PodTopologyLabels: PodTopologyLabels ----------------- ``map[string]string`` のエイリアス **利用箇所** - :ref:`PodTopologyLabels {postgresql-cnpg-io-v1-PodTopologyLabels} ` PodTopologyLabelsは、ポッドのトポロジを表します。 map[labelName]labelValue .. _postgresql-cnpg-io-v1-PoolerIntegrations: PoolerIntegrations ------------------ **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` PoolerIntegrationsは、クラスターを参照するプーラーに必要な統合をカプセル化します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `pgBouncerIntegration` :ref:`_PgBouncerIntegrationStatus_ <#postgresql-cnpg-io-v1-PgBouncerIntegrationStatus>` ,説明はありません。 .. _postgresql-cnpg-io-v1-PoolerMonitoringConfiguration: PoolerMonitoringConfiguration ----------------------------- **利用箇所** - :ref:`PoolerSpec {postgresql-cnpg-io-v1-PoolerSpec} ` PoolerMonitoringConfigurationは、特定のプーラーのすべての監視構成を含むタイプです。 クラスターのモニタリング構成をミラーしますが、今のところカスタムクエリ部分はありません。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `enablePodMonitor` _bool_,`PodMonitor`を有効または無効にします `podMonitorMetricRelabelings` :ref:`archive_timeout <モニタリング>` ,`PodMonitor`のメトリックの再ラベル付けのリスト。摂取する前にサンプルに適用されます。 `podMonitorRelabelings` :ref:`archive_timeout <モニタリング>` ,`PodMonitor`の再ラベル付けのリスト。スクレイピングの前にサンプルに適用されます。 .. _postgresql-cnpg-io-v1-PoolerSecrets: PoolerSecrets ------------- **利用箇所** - :ref:`PoolerStatus {postgresql-cnpg-io-v1-PoolerStatus} ` PoolerSecretsには、使用されるすべてのシークレットのバージョンが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `serverTLS` :ref:`_SecretVersion_ <#postgresql-cnpg-io-v1-SecretVersion>` ,サーバーTLSシークレットバージョン `serverCA` :ref:`_SecretVersion_ <#postgresql-cnpg-io-v1-SecretVersion>` ,サーバーCAシークレットバージョン `clientCA` :ref:`_SecretVersion_ <#postgresql-cnpg-io-v1-SecretVersion>` ,クライアントCAシークレットバージョン `pgBouncerSecrets` :ref:`_PgBouncerSecrets_ <#postgresql-cnpg-io-v1-PgBouncerSecrets>` ,PgBouncerが使用するシークレットのバージョン .. _postgresql-cnpg-io-v1-PoolerSpec: PoolerSpec ---------- **利用箇所** - :ref:`プーラー {postgresql-cnpg-io-v1-Pooler} <プーラー {postgresql-cnpg-io-v1-Pooler}>` PoolerSpecは、プーラーの目的の状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `cluster` ** :ref:`Required]** [_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,これは、プーラーが動作するクラスター参照です。プール名は、同じ名前空間内のクラスター名と決して一致しないはずです。 `type` :ref:`_PoolerType_ <#postgresql-cnpg-io-v1-PoolerType>` ,トラフィックの転送先のサービスの種類。デフォルト`rw` `instances` _int32_,必要なレプリカの数。デフォルト1 `template` :ref:`_PodTemplateSpec_ <#postgresql-cnpg-io-v1-PodTemplateSpec>` ,作成するPodのテンプレート `pgbouncer` ** :ref:`Required]** [_PgBouncerSpec_ <#postgresql-cnpg-io-v1-PgBouncerSpec>` ,PgBouncer構成 `deploymentStrategy` `_apps/v1.DeploymentStrategy_ `__ ,pgbouncerで既存のポッドを新しいポッドに置き換えるために使用する展開戦略 `monitoring` :ref:`_PoolerMonitoringConfiguration_ <#postgresql-cnpg-io-v1-PoolerMonitoringConfiguration>` ,このプーラーの監視インフラストラクチャの構成。 `serviceTemplate` :ref:`_ServiceTemplateSpec_ <#postgresql-cnpg-io-v1-ServiceTemplateSpec>` ,作成するサービスのテンプレート .. _postgresql-cnpg-io-v1-PoolerStatus: PoolerStatus ------------ **利用箇所** - :ref:`プーラー {postgresql-cnpg-io-v1-Pooler} <プーラー {postgresql-cnpg-io-v1-Pooler}>` PoolerStatusは、プーラーの観察された状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `secrets` :ref:`_PoolerSecrets_ <#postgresql-cnpg-io-v1-PoolerSecrets>` ,configオブジェクトのリソースバージョン `instances` _int32_,スケジュールしようとしているポッドの数 .. _postgresql-cnpg-io-v1-PoolerType: PoolerType ---------- ``string`` のエイリアス **利用箇所** - :ref:`PoolerSpec {postgresql-cnpg-io-v1-PoolerSpec} ` PoolerTypeは接続プールのタイプ、つまりターゲットとしているサービスを意味します。使用できる値は\ ``rw`` および\ ``ro`` です。 .. _postgresql-cnpg-io-v1-PostgresConfiguration: PostgresConfiguration --------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` PostgresConfigurationはPostgreSQL構成を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `parameters` _map[string]string_,PostgreSQL構成オプションpostgresql.conf `synchronous` :ref:`_SynchronousReplicaConfiguration_ <#postgresql-cnpg-io-v1-SynchronousReplicaConfiguration>` ,PostgreSQL同期レプリケーション機能の構成 `pg_hba` _[]string_,PostgreSQLホストベースの認証ルール pg_hba.confファイルに追加される行 `pg_ident` _[]string_,PostgreSQLのユーザー名マップルール pg_ident.confファイルに追加される行 `syncReplicaElectionConstraint` :ref:`_SyncReplicaElectionConstraints_ <#postgresql-cnpg-io-v1-SyncReplicaElectionConstraints>` ,"同期レプリカが満たす要件。これは、 ""synchronous_standby_names""パラメーターの設定方法に影響します。" `shared_preload_libraries` _[]string_,デフォルトのライブラリに追加する共有プリロードライブラリのリスト `ldap` :ref:`_LDAPConfig_ <#postgresql-cnpg-io-v1-LDAPConfig>` ,LDAP構成を指定するオプション `promotionTimeout` _int32_,インスタンスをプライマリに昇格するときに待機する最大秒数を指定します。デフォルト値は40000000で、秒単位で1年より大きく、無限タイムアウトをシミュレートするのに十分な大きさです `enableAlterSystem` _bool_,このパラメーターがtrueの場合、ユーザーはこのCloudNativePGクラスターで`ALTER SYSTEM`を呼び出すことができます。これは、デバッグとトラブルシューティングの場合にのみ使用してください。デフォルトfalse。 .. _postgresql-cnpg-io-v1-PrimaryUpdateMethod: PrimaryUpdateMethod ------------------- ``string`` のエイリアス **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` PrimaryUpdateMethodには、ローリング更新の一部としてクラスターのプライマリサーバーをアップグレードするときに使用するメソッドが含まれています .. _postgresql-cnpg-io-v1-PrimaryUpdateStrategy: PrimaryUpdateStrategy --------------------- ``string`` のエイリアス **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` PrimaryUpdateStrategyには、ローリング更新の一部としてクラスターのプライマリサーバーをアップグレードするときに従うべき戦略が含まれています .. _postgresql-cnpg-io-v1-RecoveryTarget: RecoveryTarget -------------- **利用箇所** - :ref:`BootstrapRecovery {postgresql-cnpg-io-v1-BootstrapRecovery} ` RecoveryTargetを使用すると、復旧プロセスが停止する瞬間を構成できます。 TargetTLIを除くすべてのターゲットオプションは相互排他的です。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `backupID` _string_,リカバリプロセスを開始するバックアップのID。空の場合デフォルト 、オペレーターは指定されている場合、targetTimeまたはtargetLSNに基づいて、バックアップを自動的に検出します。それ以外の場合は、使用可能な最新のバックアップを時系列で使用します。 `targetTLI` _string_,ターゲットタイムライン「latest」または正の整数 `targetXID` _string_,ターゲットトランザクションID `targetName` _string_,ターゲット名 `pg_create_restore_point`で事前に作成します `targetLSN` _string_,ターゲットLSNログシーケンス番号 `targetTime` _string_,RFC3339標準のタイムスタンプとしてのターゲット時間 `targetImmediate` _bool_,一貫した状態に到達すると、リカバリーを終了します `exclusive` _bool_,ターゲットを排他的に設定します。省略した場合、デフォルトのfalseになるため、Postgresでは`recovery_target_inclusive`がtrueになります .. _postgresql-cnpg-io-v1-ReplicaClusterConfiguration: ReplicaClusterConfiguration --------------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` ReplicaClusterConfigurationは、レプリカクラスターの構成をカプセル化します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `self` **[Required]** _string_,このクラスターの名前を自己定義します。 `primary`と比較して、これがプライマリクラスターであるかレプリカクラスターであるかを判断するために使用されます `primary` **[Required]** _string_,Primaryは、 externalClustersで指定されたトポロジに基づいて、分散PostgreSQLクラスターのプライマリとして定義されるクラスターを定義します `source` **[Required]** _string_,レプリケーション元の外部クラスターの名前 `enabled` **[Required]** _bool_,レプリカモードが有効になっている場合、このクラスターは既存のクラスターのレプリカになります。レプリカクラスターは、リカバリオブジェクトストアから、またはpg_basebackupを介したストリーミングを介して作成できます。詳細については、ドキュメントのレプリカクラスターページを参照してください。 `promotionToken` **[Required]** _string_,プロモーション要件が満たされているかどうかを確認するために使用される外部クラスターによって生成された降格トークン。 `minApplyDelay` ** `Required]** [_meta/v1.Duration_ `__ ,レプリカモードが有効になっている場合、このパラメーターを使用すると、システム時間が少なくとも構成された時間コミット時間を経過している場合にのみトランザクションを再生できます。これにより、データ損失エラーを修正する機会が提供されます。このパラメーターが設定されている場合、プロモーショントークンは使用できないことに注意してください。 .. _postgresql-cnpg-io-v1-ReplicationSlotsConfiguration: ReplicationSlotsConfiguration ----------------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` ReplicationSlotsConfigurationは、レプリケーションスロットの構成をカプセル化します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `highAvailability` :ref:`_ReplicationSlotsHAConfiguration_ <#postgresql-cnpg-io-v1-ReplicationSlotsHAConfiguration>` ,高可用性構成のレプリケーションスロット `updateInterval` _int_,スタンバイは、`updateInterval`秒ごとにローカルレプリケーションスロットのステータスを更新しますデフォルト30。 `synchronizeReplicas` :ref:`_SynchronizeReplicasConfiguration_ <#postgresql-cnpg-io-v1-SynchronizeReplicasConfiguration>` ,ユーザー定義の物理レプリケーションスロットの同期を構成します .. _postgresql-cnpg-io-v1-ReplicationSlotsHAConfiguration: ReplicationSlotsHAConfiguration ------------------------------- **利用箇所** - :ref:`ReplicationSlotsConfiguration {postgresql-cnpg-io-v1-ReplicationSlotsConfiguration} ` ReplicationSlotsHAConfigurationは、オペレーターが自動的に管理するレプリケーションスロットの構成をカプセル化して、高可用性HAを目的としてスタンバイインスタンスとのストリーミングレプリケーション接続を制御します。レプリケーションスロットは、PostgreSQLの機能であり、ストリーミングクライアントこの特定の場合、HAクラスターの一部であるレプリカが切断されたときに、PostgreSQLがWALファイルをプライマリに自動的に保持するようにします。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `enabled` _bool_,有効になっているデフォルト場合、オペレーターはプライマリインスタンスのレプリケーションスロットを自動的に管理し、HAクラスターの一部であるすべてのスタンバイインスタンスとのストリーミングレプリケーション接続でそれらを使用します。無効にすると、オペレーターはレプリカとのストリーミング接続でレプリケーションスロットを利用しません。この機能は、指定されたプライマリからそのカスケードレプリカまで、レプリカクラスター内のレプリケーションスロットも制御します。 `slotPrefix` _string_,HAのオペレーターが管理するレプリケーションスロットのプレフィックス。小文字、数字、アンダースコア文字のみを含めることができます。これは、作成時にのみ設定できます。デフォルトでは`_cnpg_`に設定されます。 .. _postgresql-cnpg-io-v1-RoleConfiguration: RoleConfiguration ----------------- **利用箇所** - :ref:`ManchedConfiguration {postgresql-cnpg-io-v1-ManchedConfiguration} ` RoleConfigurationは、追加フィールドEnsureを備えたPostgreSQLロールのKubernetesでの表現形式であり、データベース内のロールの存在または不在を保証するかどうかを指定します CREATE ROLEコマンドのデフォルトが適用されます 参考 https://www.postgresql.org/docs/current/sql-createrole.html .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,ロールの名前 `comment` _string_,ロールの説明 `ensure` :ref:`_EnsureOption_ <#postgresql-cnpg-io-v1-EnsureOption>` ,ロールが`present`または`absent`であることを確認します-デフォルトは「present」です `passwordSecret` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,ロールのパスワードを含むシークレット存在する場合 nullの場合、パスワードはDisablePasswordが設定されていない限り無視されます `connectionLimit` _int64_,ロールがログインできる場合、これはロールが確立できる同時接続の数を指定します。 `-1`デフォルトは制限なしを意味します。 `validUntil` `_meta/v1.Time_ `__ ,ロールのパスワードが有効でなくなる日時。省略すると、パスワードの有効期限はありませんデフォルト。 `inRoles` _[]string_,このロールが新しいメンバーとしてすぐに追加される1つ以上の既存のロールのリスト。デフォルトは空。 `inherit` _bool_,ロールが、そのメンバーであるロールの特権を「継承」するかどうか。デフォルトは`true`です。 `disablePassword` _bool_,DisablePasswordは、PostgresでロールのパスワードをNULLに設定する必要があることを示します `superuser` _bool_,ロールがデータベース内のすべてのアクセス制限をオーバーライドできる`superuser`であるかどうか。スーパーユーザーステータスは危険で、本当に必要な場合にのみ使用する必要があります。新しいスーパーユーザーを作成するには、自分自身がスーパーユーザーである必要があります。デフォルトは`false`です。 `createdb` _bool_,`true`に設定すると、定義されるロールは新しいデータベースを作成できます。 `false`デフォルトを指定すると、ロールがデータベースを作成する機能が拒否されます。 `createrole` _bool_,ロールが他のロールのメンバーシップを作成、変更、ドロップ、コメント、セキュリティラベルの変更、および他のロールのメンバーシップを付与または取り消しできるかどうか。デフォルトは`false`です。 `login` _bool_,ロールにログインを許可するかどうか。 `login`属性を持つロールはユーザーと考えられます。この属性のないロールは、データベース特権の管理に役立ちますが、通常の意味でのユーザーではありません。デフォルトは`false`です。 `replication` _bool_,ロールがレプリケーションロールであるかどうか。レプリケーションモード物理または論理レプリケーションでサーバーに接続し、レプリケーションスロットを作成またはドロップできるようにするには、ロールがこの属性を持つか、スーパーユーザーである必要があります。 `replication`属性を持つロールは非常に高い特権ロールであり、レプリケーションに実際に使用されるロールでのみ使用する必要があります。デフォルトは`false`です。 `bypassrls` _bool_,ロールがすべての行レベルセキュリティRLSポリシーをバイパスするかどうか。デフォルトは`false`です。 .. _postgresql-cnpg-io-v1-S3Credentials: S3Credentials ------------- **利用箇所** - :ref:`BarmanCredentials {postgresql-cnpg-io-v1-BarmanCredentials} ` S3Credentialsは、S3にファイルをアップロードするために使用される資格情報のタイプです。これは、2つの代替方法で提供できます。 - accessKeyIdとsecretAccessKeyを明示的に渡す - promoteFromIAMRoleをtrueに設定することにより、ポッド環境からロールを継承します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `accessKeyId` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,アクセスキーIDへの参照 `secretAccessKey` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,シークレットアクセスキーへの参照 `region` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,リージョン名を含むシークレットへの参照 `sessionToken` :ref:`_SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,セッションキーへの参照 `inheritFromIAMRole` _bool_,キーを明示的に提供せずにロールベースの認証を使用します。 .. _postgresql-cnpg-io-v1-SQLRefs: SQLRefs ------- **利用箇所** - :ref:`BootstrapInitDB {postgresql-cnpg-io-v1-BootstrapInitDB} ` SQLRefsは、 SQLファイルを含むConfigMapまたはSecretへの参照を保持します。参照は特定の順序で処理されます。最初にすべてのシークレットが処理され、次にすべてのConfigMapが処理されます。各グループ内での処理順序は、それぞれの配列で指定されたシーケンスに従います。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `secretRefs` :ref:`_[]SecretKeySelector_ <#postgresql-cnpg-io-v1-SecretKeySelector>` ,SecretRefsは、シークレットへの参照のリストを保持します `configMapRefs` :ref:`_[]ConfigMapKeySelector_ <#postgresql-cnpg-io-v1-ConfigMapKeySelector>` ,ConfigMapRefsは、ConfigMapsへの参照のリストを保持します .. _postgresql-cnpg-io-v1-ScheduledBackupSpec: ScheduledBackupSpec ------------------- **利用箇所** - :ref:`ScheduledBackup {postgresql-cnpg-io-v1-ScheduledBackup} ` ScheduledBackupSpecは、 ScheduledBackupの目的の状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `suspend` _bool_,このバックアップが一時停止されているかどうか `immediate` _bool_,最初のバックアップを作成後にすぐに開始する必要があるかどうか `schedule` **[Required]** _string_,スケジュールは、追加の秒指定子が含まれるため、KubernetesのCronジョブで使用される形式に従いません。https://pkg.go.dev/github.com/robfig/cron#hdr-CRON_Expression_Formatを参照してください。 `cluster` ** :ref:`Required]** [_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,バックアップするクラスター `backupOwnerReference` _string_,作成したバックアップリソース内にどのownerReferenceを配置するかを示します。 *none 作成されたバックアップオブジェクトの所有者参照なしフィールドが導入される前と同じ動作* self スケジュールされたバックアップオブジェクトをバックアップの所有者として設定します * cluster クラスターをバックアップの所有者として設定します `target` :ref:`_BackupTarget_ <#postgresql-cnpg-io-v1-BackupTarget>` ,このバックアップを実行するインスタンスを決定するポリシー。空の場合、デフォルトの`cluster.spec.backup.target`になります。使用可能なオプションは、空の文字列、`primary`および`prefer-standby`です。 `primary`は常にプライマリインスタンスでバックアップを実行します。`prefer-standby`は、可能な場合は最も更新されたスタンバイでバックアップを実行します。 `method` :ref:`_BackupMethod_ <#postgresql-cnpg-io-v1-BackupMethod>` ,使用するバックアップ方法、可能なオプションは`barmanObjectStore`、`volumeSnapshot`または`plugin`です。デフォルト`barmanObjectStore` `pluginConfiguration` :ref:`_BackupPluginConfiguration_ <#postgresql-cnpg-io-v1-BackupPluginConfiguration>` ,このバックアップを管理するプラグインに渡される構成パラメーター `online` _bool_,ボリュームスナップショットを使用したバックアップのデフォルトのタイプがオンライン/ホット `true`、default またはオフライン/コールド `false` かどうか クラスターフィールド '.spec.backup.volumeSnapshot.online'で指定されたデフォルト設定をオーバーライドします `onlineConfiguration` :ref:`_OnlineConfiguration_ <#postgresql-cnpg-io-v1-OnlineConfiguration>` ,ボリュームスナップショットを使用してオンライン/ホットバックアップを制御する構成パラメーター クラスターで指定されたデフォルト設定をオーバーライドします '.backup.volumeSnapshot.onlineConfiguration'スタンザ .. _postgresql-cnpg-io-v1-ScheduledBackupStatus: ScheduledBackupStatus --------------------- **利用箇所** - :ref:`ScheduledBackup {postgresql-cnpg-io-v1-ScheduledBackup} ` ScheduledBackupStatusは、 ScheduledBackupの観察された状態を定義します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `lastCheckTime` `_meta/v1.Time_ `__ ,最新のスケジュール `lastScheduleTime` `_meta/v1.Time_ `__ ,そのバックアップが最後に正常にスケジュールされたときの情報。 `nextScheduleTime` `_meta/v1.Time_ `__ ,次回バックアップを実行します .. _postgresql-cnpg-io-v1-SecretKeySelector: SecretKeySelector ----------------- **利用箇所** - :ref:`AzureCredentials {postgresql-cnpg-io-v1-AzureCredentials} ` - :ref:`BackupSource {postgresql-cnpg-io-v1-BackupSource} ` - :ref:`BackupStatus {postgresql-cnpg-io-v1-BackupStatus} ` - :ref:`BarmanObjectStoreConfiguration {postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration} ` - :ref:`GoogleCredentials {postgresql-cnpg-io-v1-GoogleCredentials} ` - :ref:`MonitoringConfiguration {postgresql-cnpg-io-v1-MonitoringConfiguration} ` - :ref:`S3Credentials {postgresql-cnpg-io-v1-S3Credentials} ` - :ref:`SQLRefs {postgresql-cnpg-io-v1-SQLRefs} ` SecretKeySelectorには、シークレットのキーを見つけるための十分な情報が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `LocalObjectReference` :ref:`_LocalObjectReference_ <#postgresql-cnpg-io-v1-LocalObjectReference>` ,`LocalObjectReference`のメンバーはこのタイプに埋め込まれています。選択するポッドの名前空間のシークレットの名前。 `key` **[Required]** _string_,選択するキー .. _postgresql-cnpg-io-v1-SecretVersion: SecretVersion ------------- **利用箇所** - :ref:`PgBouncerSecrets {postgresql-cnpg-io-v1-PgBouncerSecrets} ` - :ref:`PoolerSecrets {postgresql-cnpg-io-v1-PoolerSecrets} ` SecretVersionには、シークレット名とそのリソースバージョンが含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` _string_,シークレットの名前 `version` _string_,シークレットのリソースバージョン .. _postgresql-cnpg-io-v1-SecretsResourceVersion: SecretsResourceVersion ---------------------- **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` SecretsResourceVersionは、オペレーターが管理するシークレットのリソースバージョンです。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `superuserSecretVersion` _string_,"""postgres""ユーザーシークレットのリソースバージョン" `replicationSecretVersion` _string_,「streaming_replica」ユーザーシークレットのリソースバージョン `applicationSecretVersion` _string_,"""app""ユーザーシークレットのリソースバージョン" `managedRoleSecretVersion` _map[string]string_,管理対象ロールシークレットのリソースバージョン `caSecretVersion` _string_,未使用。古いバージョンとの互換性のために保持されています。 `clientCaSecretVersion` _string_,PostgreSQLのリソースバージョンクライアントサイドのCAシークレットバージョン `serverCaSecretVersion` _string_,PostgreSQLのリソースバージョンサーバーサイドCAシークレットバージョン `serverSecretVersion` _string_,PostgreSQLのリソースバージョンサーバーサイドシークレットバージョン `barmanEndpointCA` _string_,BarmanエンドポイントCAのリソースバージョンが提供されている場合 `externalClusterSecretVersion` _map[string]string_,外部クラスターシークレットのリソースバージョン `metrics` _map[string]string_,メトリックを渡すために使用されるすべてのシークレットのバージョンを含むマップ。マップキーはシークレット名であり、マップ値はバージョンです .. _postgresql-cnpg-io-v1-ServiceAccountTemplate: ServiceAccountTemplate ---------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` ServiceAccountTemplateには、サービスアカウントを生成するために必要なテンプレートが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `metadata` ** :ref:`Required]** [_Metadata_ <#postgresql-cnpg-io-v1-Metadata>` ,Metadataは、生成されたサービスアカウントに使用されるメタデータです .. _postgresql-cnpg-io-v1-ServiceSelectorType: ServiceSelectorType ------------------- ``string`` のエイリアス **利用箇所** - :ref:`ManchedService {postgresql-cnpg-io-v1-ManchedService} ` - :ref:`ManagedServices {postgresql-cnpg-io-v1-ManagedServices} ` ServiceSelectorTypeは、サービスセレクターを生成するための有効な値を説明します。読み取り/書き込み、読み取り、読み取り専用など、セレクターが適用されるサービスの種類を示します .. _postgresql-cnpg-io-v1-ServiceTemplateSpec: ServiceTemplateSpec ------------------- **利用箇所** - :ref:`ManchedService {postgresql-cnpg-io-v1-ManchedService} ` - :ref:`PoolerSpec {postgresql-cnpg-io-v1-PoolerSpec} ` ServiceTemplateSpecは、ユーザーがサービス生成のテンプレートを設定できる構造です。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `metadata` :ref:`_Metadata_ <#postgresql-cnpg-io-v1-Metadata>` ,標準オブジェクトのメタデータ。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata `spec` `_core/v1.ServiceSpec_ `__ ,サービスの目的な動作の仕様。詳細情報 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status .. _postgresql-cnpg-io-v1-ServiceUpdateStrategy: ServiceUpdateStrategy --------------------- ``string`` のエイリアス **利用箇所** - :ref:`ManchedService {postgresql-cnpg-io-v1-ManchedService} ` ServiceUpdateStrategyは、管理対象サービスへの変更を処理する方法を説明します .. _postgresql-cnpg-io-v1-SnapshotOwnerReference: SnapshotOwnerReference ---------------------- ``string`` のエイリアス **利用箇所** - :ref:`VolumeSnapshotConfiguration {postgresql-cnpg-io-v1- VolumeSnapshotConfiguration} ` SnapshotOwnerReferenceは、スナップショットの所有者の参照タイプを定義します。これは、処理されたリソースがどの所有者に関連するかを指定します。 .. _postgresql-cnpg-io-v1-SnapshotType: SnapshotType ------------ ``string`` のエイリアス **利用箇所** - :ref:`Import {postgresql-cnpg-io-v1-Import} ` SnapshotTypeは許可されるインポートのタイプです .. _postgresql-cnpg-io-v1-StorageConfiguration: StorageConfiguration -------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` - :ref:`TablespaceConfiguration {postgresql-cnpg-io-v1-TablespaceConfiguration} ` StorageConfigurationは、PVCの作成と調整に使用される構成であり、WALボリューム、PGDATAボリューム、またはテーブルスペースに使用できます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `storageClass` _string_,PVCに使用するStorageClass。可能な場合は、PVCテンプレートを評価した後に適用されます。指定しない場合、生成されたPVCはデフォルトのストレージクラスを使用します `size` _string_,ストレージのサイズ。 PVCテンプレートでまだ指定されていない場合は必須。このフィールドへの変更は、作成されたPVCに自動的に再適用されます。サイズを小さくすることはできません。 `resizeInUseVolumes` _bool_,既存のPVCのサイズを変更します、デフォルトはtrue `pvcTemplate` `_core/v1.PersistentVolumeClaimSpec_ `__ ,Persistent Volume Claimを生成するために使用されるテンプレート .. _postgresql-cnpg-io-v1-SwitchReplicaClusterStatus: SwitchReplicaClusterStatus -------------------------- **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` SwitchReplicaClusterStatusには、クラスターからレプリカクラスターへのスイッチに関するすべてのステータスが含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `inProgress` _bool_,InProgressは、クラスターをレプリカクラスターに切り替える進行中の手順があるかどうかを示します。 .. _postgresql-cnpg-io-v1-SyncReplicaElectionConstraints: SyncReplicaElectionConstraints ------------------------------ **利用箇所** - :ref:`PostgresConfiguration {postgresql-cnpg-io-v1-PostgresConfiguration} ` SyncReplicaElectionConstraintsには、同期レプリカ選択のコンストレインが含まれています。 アンチアフィニティパラメーターの場合、すべてのラベル値が一致する場合、2つのインスタンスは同じ場所にあるとみなされます。 将来的には、名前による同期レプリカ選択制限がサポートされる予定です。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `nodeLabelsAntiAffinity` _[]string_,抽出および比較して、ポッドが同じトポロジに存在するかどうかを評価するノードラベル値のリスト `enabled` **[Required]** _bool_,このフラグは、同期レプリカのコンストレインを有効にします .. _postgresql-cnpg-io-v1-SynchronizeReplicasConfiguration: SynchronizeReplicasConfiguration -------------------------------- **利用箇所** - :ref:`ReplicationSlotsConfiguration {postgresql-cnpg-io-v1-ReplicationSlotsConfiguration} ` SynchronizeReplicasConfigurationには、ユーザー定義の物理レプリケーションスロットの同期のための構成が含まれています .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `enabled` **[Required]** _bool_,trueに設定すると、プライマリにあるすべてのレプリケーションスロットが各スタンバイで同期されます `excludePatterns` _[]string_,除外するレプリケーションスロットの名前と一致する正規表現パターンのリストデフォルトでは空 `-` ** :ref:`Required]** [_synchronizeReplicasCache_ <#postgresql-cnpg-io-v1-synchronizeReplicasCache>` ,説明はありません。 .. _postgresql-cnpg-io-v1-SynchronousReplicaConfiguration: SynchronousReplicaConfiguration ------------------------------- **利用箇所** - :ref:`PostgresConfiguration {postgresql-cnpg-io-v1-PostgresConfiguration} ` SynchronousReplicaConfigurationには、PostgreSQL同期レプリケーション機能の構成が含まれています。重要 現時点では、 ``.spec.minSyncReplicas`` および\ ``.spec.maxSyncReplicas`` も考慮する必要があります。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `method` ** :ref:`Required]** [_SynchronousReplicaConfigurationMethod_ <#postgresql-cnpg-io-v1-SynchronousReplicaConfigurationMethod>` ,'any'クォーラムベースの同期レプリケーションまたは'first'プライオリティベースの同期レプリケーションを値として受け入れて、リストされたサーバーから同期レプリケーションスタンバイを選択する方法。 `number` **[Required]** _int_,トランザクションが応答を待機する必要がある同期スタンバイサーバーの数を指定します。 `maxStandbyNamesFromCluster` _int_,PostgreSQLの`synchronous_standby_names`オプションに自動的に含めることができるローカルクラスターポッドの最大数を指定します。 `standbyNamesPre` _[]string_,ローカルクラスターポッドの前に`synchronous_standby_names`に追加されるアプリケーション名のユーザー定義のリストこの順序は、優先度ベースの同期レプリケーションの場合にのみ役立ちます。 `standbyNamesPost` _[]string_,ローカルクラスターポッドの後に`synchronous_standby_names`に追加されるアプリケーション名のユーザー定義のリストこの順序は、優先度ベースの同期レプリケーションの場合にのみ役立ちます。 .. _postgresql-cnpg-io-v1-SynchronousReplicaConfigurationMethod: SynchronousReplicaConfigurationMethod ------------------------------------- ``string`` のエイリアス **利用箇所** - :ref:`SynchronousReplicaConfiguration {postgresql-cnpg-io-v1-SynchronousReplicaConfiguration} ` SynchronousReplicaConfigurationMethodは、クォーラムベースのレプリケーションまたは優先リストを使用するかどうかを構成します .. _postgresql-cnpg-io-v1-TablespaceConfiguration: TablespaceConfiguration ----------------------- **利用箇所** - :ref:`ClusterSpec {postgresql-cnpg-io-v1-ClusterSpec} ` TablespaceConfigurationはテーブルスペースの構成であり、テーブルスペースのストレージ仕様が含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,テーブルスペースの名前 `storage` ** :ref:`Required]** [_StorageConfiguration_ <#postgresql-cnpg-io-v1-StorageConfiguration>` ,テーブルスペースのストレージ構成 `owner` :ref:`_DatabaseRoleRef_ <#postgresql-cnpg-io-v1-DatabaseRoleRef>` ,所有者は、テーブルスペースを所有するPostgreSQLユーザーです `temporary` _bool_,trueに設定すると、テーブルスペースがPostgreSQLの`temp_tablespaces`エントリとして追加され、一時データベースオブジェクトまたはその他の一時ファイルを自動的に収容するために利用できます。 `temp_tablespaces` GUCの詳細については、 PostgreSQLドキュメントを参照してください。 .. _postgresql-cnpg-io-v1-TablespaceState: TablespaceState --------------- **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` TablespaceStateは、クラスター内のテーブルスペースの状態を表します .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `name` **[Required]** _string_,Nameはテーブルスペースの名前です `owner` _string_,所有者は、テーブルスペースを所有するPostgreSQLユーザーです `state` ** :ref:`Required]** [_TablespaceStatus_ <#postgresql-cnpg-io-v1-TablespaceStatus>` ,状態は最新の調整状態です `error` _string_,Errorはリコンシリエーションエラーである場合 .. _postgresql-cnpg-io-v1-TablespaceStatus: TablespaceStatus ---------------- ``string`` のエイリアス **利用箇所** - :ref:`TablespaceState {postgresql-cnpg-io-v1-TablespaceState} ` TablespaceStatusは、クラスター内のテーブルスペースのステータスを表します .. _postgresql-cnpg-io-v1-Topology: トポロジ -------- **利用箇所** - :ref:`ClusterStatus {postgresql-cnpg-io-v1-ClusterStatus} ` トポロジにはクラスタートポロジが含まれます .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `instances` :ref:`_map[PodName]PodTopologyLabels_ <#postgresql-cnpg-io-v1-PodTopologyLabels>` ,インスタンスには、インスタンスのポッドトポロジが含まれます `nodesUsed` _int32_,Nodes Usedは、インスタンスを収容する個別のノードの数を表します。値「1」は、すべてのインスタンスが単一のノードでホストされることを示し、高可用性HAが存在しないことを示します。理想的には、この値はPostgres HAクラスターのインスタンスの数と同じである必要があり、コンピューティング側でシェアードナッシングアーキテクチャを意味します。 `successfullyExtracted` _bool_,SuccessquietlyExtractedは、トポロジデータが抽出されたかどうかを示します。障害が発生した場合に、同期レプリカ選択でフォールバック動作を制定すると役立ちます VolumeSnapshotConfiguration {#postgresql-cnpg-io-v1- VolumeSnapshotConfiguration} --------------------------------------------------------------------------------- **利用箇所** - :ref:`BackupConfiguration {postgresql-cnpg-io-v1-BackupConfiguration} ` VolumeSnapshotConfigurationは、スナップショットバックアップを実行するための構成を表します。 .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `labels` _map[string]string_,ラベルは、 .metadata.labelsスナップショットリソースに追加されるキーと値のペアです。 `annotations` _map[string]string_,.metadata.annotationsスナップショットリソースに追加される注釈のキーと値のペア。 `className` _string_,ClassNameは、PG_DATA Persistent VolumeClaimに使用されるスナップショットクラスを指定します。特定のクラスが存在しない場合、それは他のタイプのデフォルトクラスです `walClassName` _string_,WalClassNameは、PG_WAL Persistent VolumeClaimに使用されるスナップショットクラスを指定します。 `tablespaceClassName` _map[string]string_,TablespaceClassNameは、テーブルスペースに使用されるスナップショットクラスを指定します。デフォルトでPGDATAスナップショットクラスが設定されている場合 `snapshotOwnerReference` :ref:`_SnapshotOwnerReference_ <#postgresql-cnpg-io-v1-SnapshotOwnerReference>` ,SnapshotOwnerReferenceは、スナップショットが持つ必要がある所有者参照のタイプを示します `online` _bool_,ボリュームスナップショットを使用したバックアップのデフォルトのタイプがオンライン/ホット `true`、default またはオフライン/コールド `false` `onlineConfiguration` :ref:`_OnlineConfiguration_ <#postgresql-cnpg-io-v1-OnlineConfiguration>` ,ボリュームスナップショットを使用してオンライン/ホットバックアップを制御する構成パラメーター .. _postgresql-cnpg-io-v1-WalBackupConfiguration: WalBackupConfiguration ---------------------- **利用箇所** - :ref:`BarmanObjectStoreConfiguration {postgresql-cnpg-io-v1-BarmanObjectStoreConfiguration} ` WalBackupConfigurationは、WALストリームのバックアップの構成です .. csv-table:: :header: Field,Description :widths: 15,25 :align: left :class: longtable `compression` :ref:`_CompressionType_ <#postgresql-cnpg-io-v1-CompressionType>` ,WALファイルをオブジェクトストアに送信する前に圧縮します。使用可能なオプションは、空の文字列圧縮なし、デフォルト、`gzip`、`bzip2`、または`snappy`です。 `encryption` :ref:`_EncryptionType_ <#postgresql-cnpg-io-v1-EncryptionType>` ,ファイルの暗号化を強制する場合バケットがそのようにまだ構成されていない場合。許可されるオプションは空の文字列バケットポリシーを使用しますデフォルト 、`AES256`および`aws:kms`です `maxParallel` _int_,並列アーカイブするPostgreSQLインスタンスがバックアップオブジェクトストアにアーカイブしている場合、または並列リストアするWALファイルの数PostgreSQLスタンバイがリカバリオブジェクトストアからWALファイルを取得している場合。指定しない場合、WALファイルは一度に1つずつ処理されます。値として正の整数を受け入れます。1が受け入れられる最小値です。 `archiveAdditionalCommandArgs` **[Required]** _[]string_,'barman-cloud-wal-archive'コマンドライン呼び出しに追加できる追加引数。これらの引数は、特定の要件または構成に従って、WALアーカイブプロセスをさらにカスタマイズする柔軟性を提供します。 例 特定のタイムアウトの設定やカスタム動作の定義など、特殊なバックアップオプションが必要なシナリオでは、ユーザーはこのフィールドを使用して追加のコマンド引数を指定できます。 注 実行中の潜在的なエラーまたは意図しない動作を回避するには、指定された引数が有効であり、 'barman-cloud-wal-archive'コマンドでサポートされていることを確認することが重要です。 `restoreAdditionalCommandArgs` **[Required]** _[]string_,'barman-cloud-wal-restore'コマンドライン呼び出しに追加できる追加引数。これらの引数は、特定の要件または構成に従って、WAL復元プロセスをさらにカスタマイズする柔軟性を提供します。 例 特定のタイムアウトの設定やカスタム動作の定義など、特殊なバックアップオプションが必要なシナリオでは、ユーザーはこのフィールドを使用して追加のコマンド引数を指定できます。 注 実行中の潜在的なエラーまたは意図しない動作を回避するには、指定された引数が有効であり、 'barman-cloud-wal-restore'コマンドでサポートされていることを確認することが重要です。 h1>htmlmarkdown.com HTMLからMarkdownコンバータ HTML5をMarkdownに変換する場合に最適なツール。 - - - `CommonMark `_ に準拠することを目指しており、出力をスタイルするオプションが含まれています。これらのオプションには次のものが含まれます。 \*見出しスタイルsetextまたはatx *ホリゾンタルルール* 、-、または\_ *弾丸* 、-、または - codeBlockStyleインデントまたはフェンスされた \*フェンス`または~ *em区切り文字_または* \*強い区切り文字*\* または\_\_ - linkStyleインラインまたは参照 - linkReferenceStyle完全、折りたたみ、またはショートカット