cloudnative-pg / cloudnative-pg/plugin-barman-cloud

OCI Object Storage as an S3-compatible backup destination

オープン
#1,055 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
documentation
主要言語
Go
スター
191
フォーク
72
平均マージ
2日 21時間
マージ済み PR(30日)
21

説明

## Summary

I would like to contribute documentation for using Oracle Cloud Infrastructure
(OCI) Object Storage as an S3-compatible backup destination with the Barman
Cloud CNPG-I plugin.

This is a documentation/configuration contribution. It does not add a native
OCI-specific provider implementation.

## What was validated

- Continuous WAL archiving
- On-demand physical backup
- Scheduled backups
- Backup object validation in OCI Object Storage
- Restore/bootstrap of a new CloudNativePG cluster from the stored backup
- Recovery readiness / WAL replay

## OCI configuration

- OCI Object Storage S3 Compatibility API
- Endpoint pattern:
`https://.compat.objectstorage..oci.customer-oci.com`
- OCI Customer Secret Key used as S3 access key and secret key
- Explicit OCI region configured for request signing
- Unique destination path per PostgreSQL cluster

## Validated versions

| Component | Validated version / image |
|---|---|
| CloudNativePG Operator | 1.29.1 |
| Operator image | `ghcr.io/cloudnative-pg/cloudnative-pg:1.29.1` |
| PostgreSQL | 18.3 |
| PostgreSQL image | `ghcr.io/cloudnative-pg/postgresql:18.3-system-trixie` |
| PostgreSQL build | `postgres (PostgreSQL) 18.3 (Debian 18.3-1.pgdg13+1)` |
| Barman Cloud Plugin | 0.12.0 |
| Plugin image | `ghcr.io/cloudnative-pg/plugin-barman-cloud:v0.12.0` |
| Detected cluster plugin | `barman-cloud.cloudnative-pg.io`, version `0.12.0` |

## Proposed documentation

I can submit a concise OCI Object Storage provider guide containing:

1. OCI prerequisites and IAM guidance
2. Kubernetes Secret example using placeholders
3. `ObjectStore` manifest
4. Cluster WAL-archiving configuration
5. On-demand and scheduled backup examples
6. Recovery example
7. OCI-specific troubleshooting and security notes

Reference implementation and test details:
https://medium.com/oracledevs/cloudnativepg-oci-object-storage-a-practical-backup-and-restore-guide-98d35c204b55

Could you please confirm whether an OCI Object Storage configuration guide would be welcome as part of the Barman Cloud Plugin documentation?

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

まず、既存の Barman Cloud Plugin ドキュメントの構成と、この issue で説明されている検証済みの OCI 構成を確認します。前提条件、Secret と ObjectStore の例、WAL アーカイブ、バックアップ、リカバリ、トラブルシューティング、セキュリティに関する注意事項を含む簡潔なプロバイダーガイドを追加します。完了の条件は、ドキュメント化されたワークフローが一覧にある検証済みシナリオと一致することです。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
kubernetes, postgresql
領域
cloud, databases, documentation
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
静か
明瞭さ
おおむね明確
初心者へのやさしさ
68/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。