DBCluster)のストレージと Persistent Volume Claim(PVC)の容量を適切に計画する必要があります。AlloyDB Omni Kubernetes Operator を使用して Kubernetes にデプロイする場合は、これらのサイズ設定の推奨事項を使用してボリュームを構成します。
カスタム リソースDBClusterを作成すると、
AlloyDB Omni Operator は、次のフィールドで定義したディスクに基づいて Kubernetes PVC をプロビジョニングします
。
- プライマリ インスタンスと高可用性(HA)スタンバイ インスタンス:
DBClusterカスタム リソースのspec.primarySpec.resources.disksフィールドで構成されます。 高可用性を有効にするには、spec.availability.numberOfStandbysフィールドを構成します。各スタンバイ レプリカは、プライマリ インスタンスと同じ ディスク構成を使用します。 - 読み取りプール インスタンス:
spec.resources.disksで構成されます。各DBInstanceカスタム リソースで、instanceTypeがReadPoolに設定されています。DBInstanceリソースでspec.resourcesセクションを省略すると、読み取りプール インスタンスは親DBClusterリソースのspec.primarySpec.resourcesフィールドからディスク構成を継承します。
サポートされている PVC ボリューム
AlloyDB Omni Operator は、すべての PVC ボリュームを同時にプロビジョニングしません。
- 常にプロビジョニングされる: Operator は、すべてのプライマリ、HA スタンバイ、読み取りプール データベース インスタンス Pod に対して、常に
DataDisk、ObsDisk、BackupDisk、LogDiskをプロビジョニングします。マニフェストでDataDiskとそのサイズを明示的に指定する必要があります。マニフェストでObsDisk、BackupDisk、LogDiskを指定することは省略可能です。基本的な インストール マニフェストに示すように省略した場合でも、Operator はデフォルト サイズを使用してこれらの PVC をプロビジョニングします。 - デフォルトではプロビジョニングされない: スタンドアロン
DBClusterリソースを作成する場合、または Cloud Storage または Amazon S3 にバックアップを保存する場合、Operator はBackupRepoDiskボリュームをプロビジョニングしません。バックアップを Kubernetes クラスタにローカルに保存するBackupPlanリソース(リモートbackupLocationフィールドのないBackupPlanリソース)を作成した場合にのみ、バックアップ リポジトリ Pod とそのBackupRepoDiskPVC をプロビジョニングします。
次の表に、AlloyDB Omni Operator が管理する永続ボリュームを示します。
| ディスク名 | マウントパス | ターゲット Pod | マニフェスト構成 | プロビジョニングの動作 | 目的 |
|---|---|---|---|---|---|
DataDisk |
/mnt/disks/pgsql |
データベース Pod | 必須 | 各データベース Pod に対して常にプロビジョニングされます。 | PostgreSQL データベース クラスタ ディレクトリ
(PGDATA)、テーブル、インデックス、一時ファイル、アクティブな
write-ahead log(WAL)セグメントを保存します。 |
ObsDisk |
/obs |
データベース Pod | 省略可(デフォルト: 2Gi) |
各データベース Pod に対して常にプロビジョニングされます。 | PostgreSQL サーバーログ
(postgresql.log)、pgAudit ログ
(postgresql.audit)、内部ログ
(postgresql.internal)、ローテーションされた .gz ログ
アーカイブなどのオブザーバビリティ データを保存します。 |
BackupDisk |
/backup |
データベース Pod | 省略可(デフォルト: 10Gi) |
各データベース Pod に対して常にプロビジョニングされます。 | データベース Pod のバックアップ オペレーション用のローカル ステージング ディレクトリを提供します。 |
LogDisk |
/archive |
データベース Pod | 省略可(デフォルト: 2Gi) |
各データベース Pod に対して常にプロビジョニングされます。 | カスタムまたは
サードパーティのバックアップ サイドカー専用の WAL アーカイブの宛先を提供します。カスタム WAL アーカイブ
サイドカーを使用しない場合は、このディスクをマニフェストから省略して、デフォルトの 2Gi サイズのままにできます。 |
BackupRepoDisk |
/backup |
バックアップ リポジトリ Pod | 省略可(デフォルト: 10Gi) |
デフォルトではプロビジョニングされません。BackupPlan リソースがバックアップをローカルに保存する場合にのみプロビジョニングされます(BackupPlan が構成されていない場合、またはバックアップで Cloud Storage または Amazon S3 を使用する場合はプロビジョニングされません)。 |
ローカル ストレージ バックアップを使用する場合に、物理データベース バックアップ、 増分バックアップと差分バックアップ、アーカイブされた WAL ファイルを保存する専用ボリュームを提供します。 |
PVC のサイズ設定に関する推奨事項
ワークロード、ロギング構成、バックアップ戦略に基づいて各 PVC ボリュームのサイズを設定するには、次のガイドラインを使用します。
プライマリ データベース ストレージ用の DataDisk ボリューム
AlloyDB Omni Operator は、すべてのデータベース Pod に対して常に DataDisk ボリュームをプロビジョニングします。マニフェストでそのサイズを明示的に指定する必要があります。DataDisk の最小容量を見積もるには、次の式を使用します。
DataDisk capacity = (initial_dataset_size + projected_growth + max_wal_size) * 1.30
DataDisk ボリュームのサイズを設定する際は、次の要素を考慮してください。
- インデックスのオーバーヘッド: PostgreSQL インデックスとシステム カタログ テーブルでは、通常、未加工のテーブル データに加えて 20% ~ 50% のストレージが必要です。
- アクティブな WAL ヘッドルーム: スループットの高い書き込みトランザクションでは、チェックポイントが完了するまで
pg_walディレクトリに WAL ファイルが蓄積されます。構成したmax_wal_sizeデータベース パラメータに対応できる十分なストレージを割り当てます(通常、ワークロードに応じて数 GB から数十 GB)。max_wal_sizeなどのデータベース パラメータを表示または変更するには、 データベース パラメータを構成するをご覧ください。 - 一時ファイルとバキューム オペレーション: クエリの並べ替え、インデックスの作成、再インデックス作成、自動バキューム オペレーションには、追加の一時ディスク容量が必要です。
- 一般的なサイズ設定ルール: 未加工のデータベース サイズの 1.5 ~ 2 倍を割り当てます。少なくとも 30% の安全バッファを含めます。
診断ログと監査ログ用の ObsDisk ボリューム
AlloyDB Omni Operator は、すべてのデータベース Pod に対して常に ObsDisk ボリュームをプロビジョニングします(マニフェストで省略した場合はデフォルト サイズの 2Gi)。ObsDisk ボリュームがいっぱいになると、PostgreSQL は新しいログエントリを書き込むことができず、ログ ローテーションが停止する可能性があります。ObsDisk ボリュームのログ ローテーションと保持
設定を構成する方法については、ログ ローテーションを構成するを
ご覧ください。
ObsDisk ボリュームのサイズを設定する際は、次のガイドラインを考慮してください。
- 標準ロギング: デフォルトのログ ローテーション設定(200 MB のローテーションしきい値と 7 日間の保持)では、4 GiB ~ 10 GiB のボリュームで十分です。
- 監査ロギング(pgAudit): pgAudit で監査ロギングを有効にすると、 監査ロギングによって生成されるログボリュームが大幅に増加します。クエリレートと監査ルールの詳細度に応じて、20 GiB ~ 50 GiB 以上を割り当てます。
ローカル バックアップ リポジトリ用の BackupRepoDisk ボリューム
データベース Pod ディスクとは異なり、BackupRepoDisk はデフォルトではプロビジョニングされません。
AlloyDB Omni Operator は、リモート backupLocation フィールドのない
Kubernetes クラスタにバックアップをローカルに保存する
BackupPlan リソースを作成した場合にのみ、バックアップ リポジトリ Pod とその
BackupRepoDisk PVC をプロビジョニングします。このディスクを DBCluster マニフェストから省略すると、デフォルト サイズの 10Gi が使用されます。
BackupPlan リソースを構成しない場合、または BackupPlan リソースが GCS タイプの Cloud Storage または S3 タイプの Amazon S3 を使用する場合、Operator は BackupRepoDisk をプロビジョニングしません。バックアップ プランの構成とバックアップ ストレージのサイズ変更の詳細については、
Kubernetes でのバックアップと復元と
バックアップ ディスクのサイズを変更するをご覧ください。
バックアップをローカルに保存する場合、BackupRepoDisk ボリュームには、圧縮されたフル バックアップ、差分バックアップ、増分バックアップがアーカイブされた WAL ファイルとともに保存されます。必要な合計ストレージは、データベース サイズ、1 日あたりのデータ変更率、backupSchedules で定義されたバックアップ スケジュール、backupRetainDays で設定された保持期間によって異なります。
- バックアップ圧縮: 圧縮されたバックアップは、通常、圧縮されていないデータベース サイズの 37% ~ 38% を使用します。これは、サイズが 62% ~ 63% 削減されることを意味します。たとえば、50 GiB のデータベースは、約 18.5 GiB に圧縮されます。
- バックアップ スケジュールと保持: 週単位のフル バックアップと日単位の増分バックアップまたは差分バックアップを組み合わせると、日単位のフル バックアップを行うよりも必要なストレージが大幅に少なくなります。
次の表に、100 GiB のデータベースで、1 日あたりのデータ変更率が 10%、デフォルトの 14 日間の保持期間(backupRetainDays: 14)の場合に、さまざまなバックアップ スケジュールでベンチマークされたピーク時のストレージ使用量と推奨される BackupRepoDisk サイズ(20% のバッファを含む)を示します。
バックアップ スケジュール(backupSchedules) |
ピーク時のフル バックアップ | 差分バックアップ | 増分バックアップ | アーカイブされた WAL ファイル | ピーク時の使用ストレージ | 推奨される BackupRepoDisk サイズ(+20% バッファ) |
|---|---|---|---|---|---|---|
| 週単位のフル + 日単位の増分 | 148.0 GiB | 0 GiB | 66.6 GiB | 155.4 GiB | 370.0 GiB | 444 GiB(データベース サイズの約 4.4 倍) |
| 週単位のフル + 週半ばの差分 + 日単位の増分 | 148.0 GiB | 22.2 GiB | 44.4 GiB | 155.4 GiB | 370.0 GiB | 444 GiB(データベース サイズの約 4.4 倍) |
| 週単位のフル + 日単位の差分 | 148.0 GiB | 155.4 GiB | 0 GiB | 155.4 GiB | 458.8 GiB | 551 GiB(データベース サイズの約 5.5 倍) |
| 日単位のフルのみ(デフォルト スケジュール) | 592.0 GiB | 0 GiB | 0 GiB | 111.0 GiB | 703.0 GiB | 844 GiB(データベース サイズの約 8.4 倍) |
データベース Pod バックアップ ステージング用の BackupDisk ボリューム
AlloyDB Omni Operator は、デフォルト サイズの 10 GiB(10Gi)で、すべてのデータベース Pod に対して常に BackupDisk ボリュームをプロビジョニングします。AlloyDB Omni は、バックアップ オペレーション中に BackupDisk ボリュームをローカル ステージング ディレクトリとして使用します。デフォルトの 10 GiB サイズは標準オペレーションに十分であるため、DBCluster マニフェストから BackupDisk を省略してデフォルト サイズを使用できます。
カスタム WAL アーカイブ用の LogDisk ボリューム
AlloyDB Omni Operator は、デフォルト サイズの 2 GiB(2Gi)で、すべてのデータベース
Pod に対して常に LogDisk ボリュームをプロビジョニングします。LogDisk ボリュームの
カスタムサイズを指定する必要があるのは、WAL ファイルを /archive ディレクトリにアーカイブする
カスタムまたはサードパーティのサイドカー コンテナ
をデプロイする場合のみです。組み込みのバックアップを使用する標準の AlloyDB Omni Operator デプロイの場合、DBCluster マニフェストから LogDisk を省略して、デフォルトの 2Gi サイズのままにできます。
データセット サイズ別のサイズ設定リファレンス
次の表に、一般的な未加工のデータセット サイズに対する推奨 PVC サイズを示します。
| 元データサイズ | 推奨される DataDisk サイズ |
推奨される ObsDisk サイズ |
推奨される BackupRepoDisk サイズ(ローカル バックアップ用にのみプロビジョニング) |
推奨される BackupDisk サイズ |
推奨される LogDisk サイズ |
|---|---|---|---|---|---|
| 50 GiB | 100 GiB | 4 GiB(pgAudit を使用する場合は 10 ~ 20 GiB) | 150 GiB | 10 GiB(デフォルト) | 2 GiB(デフォルト) |
| 200 GiB | 400 GiB | 10 GiB(pgAudit を使用する場合は 20 ~ 50 GiB) | 600 GiB | 10 GiB(デフォルト) | 2 GiB(デフォルト) |
| 500 GiB | 1,000 GiB(1 TiB) | 15 GiB(pgAudit を使用する場合は 30 ~ 60 GiB) | 1,500 GiB(1.5 TiB) | 10 GiB(デフォルト) | 2 GiB(デフォルト) |
| 1 TiB | 2,000 GiB(2 TiB) | 20 GiB(pgAudit を使用する場合は 50 ~ 100 GiB) | 3,000 GiB(3 TiB) | 10 GiB(デフォルト) | 2 GiB(デフォルト) |
ディスク使用量と I/O 指標をモニタリングする
kubectl を使用するか、AlloyDB Omni によってエクスポートされた Prometheus 指標を収集することで、データベースとバックアップ リポジトリ Pod 内のライブ ディスク使用量を直接モニタリングできます。
kubectl を使用してディスク使用量を確認する
データベース Pod とバックアップ リポジトリ Pod 内にマウントされた PVC ボリュームの現在のディスク容量の使用量を確認するには、次のコマンドを実行します。
DBClusterリソースのデータベース Pod の名前を取得します。export DB_POD=$(kubectl get pod -n NAMESPACE -l alloydbomni.internal.dbadmin.goog/dbcluster=DB_CLUSTER_NAME,alloydbomni.internal.dbadmin.goog/task-type=database -o jsonpath='{.items[0].metadata.name}')次のように置き換えます。
NAMESPACE: データベース クラスタがデプロイされている Kubernetes Namespace。DB_CLUSTER_NAME: データベース クラスタの名前。
データベース コンテナ内で
df -hを実行して、DataDisk(/mnt/disks/pgsql)、ObsDisk(/obs)、BackupDisk(/backup)、LogDisk(/archive)ボリュームの容量と使用量を確認します。kubectl exec -n NAMESPACE "${DB_POD}" -c database -- df -h /mnt/disks/pgsql /obs /backup /archiveバックアップをローカルに保存するように
BackupPlanリソースを構成した場合は、バックアップ リポジトリ Pod の名前を取得し、df -hを実行してBackupRepoDiskボリューム(/backup)の容量と使用量を確認します。export BACKUP_REPO_POD=$(kubectl get pod -n NAMESPACE -l alloydbomni.internal.dbadmin.goog/dbcluster=DB_CLUSTER_NAME,alloydbomni.internal.dbadmin.goog/backup-repository -o jsonpath='{.items[0].metadata.name}') kubectl exec -n NAMESPACE "${BACKUP_REPO_POD}" -c backuprepo -- df -h /backup
Prometheus を使用してストレージ指標をモニタリングする
AlloyDB Omni は、
al-INSTANCE_ID-DB_CLUSTER_NAME-monitoring-system
サービス(ポート 9187)でストレージとディスク I/O 指標をエクスポートします。これらの指標をスクレイピングしてクエリする方法については、
AlloyDB Omni をモニタリングするをご覧ください。使用可能な指標の
完全なリストについては、
AlloyDB Omni の指標をご覧ください。
次のディスク指標をモニタリングします。
- ストレージ使用量と容量:
alloydb_omni_node_storage_usage_per_disk_byte指標とalloydb_omni_node_storage_limit_per_disk_byte指標をモニタリングします。これらの指標は、diskラベル (DataDisk、ObsDisk、BackupDiskなど)を使用して、各ボリュームの使用済み ストレージと合計容量をバイト単位で報告します。ディスク使用量が容量の 80% と 90% に達したときにアラートを構成 して、容量が不足する前にボリュームを拡張できるようにします。 - ディスク スループットと I/O オペレーション: ディスクの読み取りと書き込みのスループットについては
alloydb_omni_node_storage_read_bytes_count_total指標とalloydb_omni_node_storage_write_bytes_count_total指標を、読み取りと書き込みの I/O オペレーションについてはalloydb_omni_node_storage_read_ops_count_total指標とalloydb_omni_node_storage_write_ops_count_total指標をモニタリングします。
既存の DBCluster の PVC のサイズを変更する
データベース クラスタを作成するに沿って
データベース クラスタを作成するに沿って DBCluster リソースをすでに作成している場合、
最初のマニフェストでは DataDisk ボリューム(10Gi など)のみが指定されている可能性があります。
AlloyDB Omni Operator は、ObsDisk(2Gi)、BackupDisk
(10Gi)、LogDisk(2Gi)ボリュームをデフォルト サイズでプロビジョニングします。DBCluster マニフェストを更新することで、これらの PVC を拡張できます。
PVC のサイズを変更する前に、次の要件と制限事項を確認してください。
- StorageClass ボリュームの拡張: ディスクのサイズを増やすことができるのは、
Kubernetes
StorageClassリソース でallowVolumeExpansion: trueが設定されている場合のみです。詳細については、 永続ボリュームの要求の拡張をご覧ください。 - 縮小や StorageClass の変更は不可: ディスクのサイズを縮小することはできません。また、プロビジョニング後に既存の PVC の
storageClassフィールドを変更することはできません。 - デフォルト サイズのディスクのサイズ変更: マニフェストから省略したディスク(
ObsDiskボリュームやBackupRepoDiskボリュームなど)を拡張するには、そのディスクのエントリをspec.primarySpec.resources.disksフィールドに追加し、現在のデフォルト容量よりも大きいsizeフィールドを指定します。マニフェストを更新するときは、DataDiskとその他の既存のディスク エントリを常にdisksリストに保持してください。 - Pod の再起動動作:
resources.disksフィールドを変更すると、AlloyDB Omni Operator は基盤となる PVC を更新し、新しいリソース仕様を適用するためにデータベース インスタンス Pod を再起動します。計画メンテナンスの時間枠で ストレージの拡張を行うか、ダウンタイムを最小限に抑えるように 高可用性を構成します。
DBCluster の PVC を調べてサイズを変更する手順は次のとおりです。
データベース クラスタの Namespace 内の PVC を一覧表示して、現在の容量と
StorageClassリソースを確認します。kubectl get pvc -n NAMESPACENAMESPACEは、DBClusterをデプロイした Namespace(defaultなど)に置き換えます。my-db-clusterという名前のクラスタの場合、出力は次のようになります。NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE backupdisk-al-1060-my-db-cluster-0 Bound pvc-45a28be2-a111-40ed-9641-61b9d25f313b 10Gi RWO standard-rwo 10m datadisk-al-1060-my-db-cluster-0 Bound pvc-c23a1ab8-f97c-4449-9072-502b6d9ba869 10Gi RWO standard-rwo 10m logdisk-al-1060-my-db-cluster-0 Bound pvc-f0c41d15-bb13-4d28-b94b-01a28dc67ef6 2Gi RWO standard-rwo 10m obsdisk-al-1060-my-db-cluster-0 Bound pvc-69ea1ca7-a868-4dc9-a9f8-503d5e5f2387 2Gi RWO standard-rwo 10mPVC で使用されている
StorageClassリソースがボリュームの拡張をサポートしていることを確認します。kubectl get storageclass STORAGE_CLASS_NAME -o jsonpath='{.allowVolumeExpansion}{"\n"}'STORAGE_CLASS_NAMEは、前の出力のSTORAGECLASS列のストレージ クラス名(standard-rwoなど)に置き換えます。コマンドがtrueを返すことを確認します。DBClusterマニフェストのspec.primarySpec.resources.disksフィールドを更新して、DataDiskボリュームのsize値を増やし、拡張する必要があるデフォルト サイズのディスク(ObsDiskボリュームやBackupRepoDiskボリュームなど)を追加します。次のマニフェスト例では、
DataDiskボリュームを400Giに拡張し、ObsDiskボリュームをデフォルトの2Giから10Giに拡張し、200 GiB のワークロードに対してBackupRepoDiskボリュームを600Giに構成します。apiVersion: alloydbomni.dbadmin.goog/v1 kind: DBCluster metadata: name: DB_CLUSTER_NAME namespace: NAMESPACE spec: databaseVersion: "18.3.0" primarySpec: adminUser: passwordRef: name: db-pw-DB_CLUSTER_NAME resources: cpu: 4 memory: 32Gi disks: - name: DataDisk size: 400Gi storageClass: STORAGE_CLASS_NAME - name: ObsDisk size: 10Gi storageClass: STORAGE_CLASS_NAME - name: BackupRepoDisk size: 600Gi storageClass: STORAGE_CLASS_NAME次のように置き換えます。
DB_CLUSTER_NAME: データベース クラスタの名前。例:my-db-clusterNAMESPACE: データベース クラスタの Namespace。STORAGE_CLASS_NAME: 永続ボリュームで使用される KubernetesStorageClassリソースの名前。例:standard-rwoクラスタの作成時にstorageClassフィールドを省略した場合は、Operator がクラスタのデフォルトのStorageClassを使用するように、引き続き省略できます。
更新された
DBClusterマニフェストを適用します。kubectl apply -f DB_CLUSTER_MANIFEST.yamlDB_CLUSTER_MANIFESTは、DBClusterマニフェスト ファイルのパスに置き換えます。PVC と
DBClusterのステータスに拡張されたサイズが反映されていることを確認します。kubectl get pvc -n NAMESPACEDBClusterリソースのallocatedResources.disksステータス フィールドを調べることもできます。kubectl get dbcluster DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.allocatedResources.disks}{"\n"}'次のように置き換えます。
NAMESPACE: データベース クラスタの Namespace。DB_CLUSTER_NAME: データベース クラスタの名前。
コンピューティング リソースとストレージ リソースのサイズ変更の詳細については、 Kubernetes ベースのデータベース クラスタのサイズを変更するをご覧ください。
次のステップ
- コンテナ オーケストレーターを使用して AlloyDB Omni をインストールする
- AlloyDB Omni を管理してモニタリングする
- ログ ローテーションを構成する
- Kubernetes でのバックアップと復元
- Kubernetes で高可用性を管理する
- Kubernetes に読み取りプール インスタンスを作成する