Skip to content

docs: update gap analysis — 5 gaps resolved (PRs #126-#130) #132

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
eightynine01 merged 1 commit into from
May 26, 2026
Merged

docs: update gap analysis — 5 gaps resolved (PRs #126-#130) #132

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/gap-analysis/GAP-ANALYSIS.ja.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,21 +23,21 @@ keiailab/postgres-operator v0.3.0-alpha.18の機能を比較します。

| # | ギャップ | CNPG相当 | 工数 | スプリント |
|---|---------|---------|------|-----------|
| 1 | WALアーカイブ + オブジェクトストア | barmanObjectStore | 2週間 | S3 |
| 1 | WALアーカイブ + オブジェクトストア | barmanObjectStore | ✅ Done (#127) | S3 |
| 2 | オブジェクトストアからPITR | spec.backup.recovery | 1週間 | S4 |
| 3 | TLS Phase 3 (マウント + ssl=on) | デフォルト動作 | 3日 | S1 |
| 4 | postgresql.confホットリロード | pg_reload_conf() | 2日 | S2 |
| 5 | バックアップ保持クリーンアップ | retentionPolicy | 3日 | S5 |
| 4 | postgresql.confホットリロード | pg_reload_conf() | ✅ Done (#126) | S2 |
| 5 | バックアップ保持クリーンアップ | retentionPolicy | ✅ Done (#130) | S5 |

### P1 — 運用信頼性

| # | ギャップ | CNPG相当 | 工数 | スプリント |
|---|---------|---------|------|-----------|
| 6 | Switchover | cnpg promote | 3日 | S5 |
| 6 | Switchover | cnpg promote | ✅ Done (#130) | S5 |
| 7 | Fencing | cnpg fencing | 3日 | S6 |
| 8 | 同期レプリケーション | syncReplicas | 2日 | S6 |
| 9 | pg_hba.confリロード | Configリロード | 1日 | S2 |
| 10 | カスタムPGパラメータ | spec.postgresql.parameters | 2日 | S2 |
| 9 | pg_hba.confリロード | Configリロード | ✅ Done (#126) | S2 |
| 10 | カスタムPGパラメータ | spec.postgresql.parameters | ✅ Done (#126) | S2 |

---

Expand Down
12 changes: 6 additions & 6 deletions docs/gap-analysis/GAP-ANALYSIS.ko.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,21 +23,21 @@ keiailab/postgres-operator v0.3.0-alpha.18의 기능을 비교합니다.

| # | 격차 | CNPG 해당 기능 | 소요 | 스프린트 |
|---|------|---------------|------|----------|
| 1 | WAL 아카이빙 + 오브젝트 스토어 | barmanObjectStore + CNPG-I | 2주 | S3 |
| 1 | WAL 아카이빙 + 오브젝트 스토어 | barmanObjectStore + CNPG-I | ✅ Done (#127) | S3 |
| 2 | 오브젝트 스토어 PITR | spec.backup.recovery | 1주 | S4 |
| 3 | TLS Phase 3 (마운트 + ssl=on) | 기본 동작 | 3일 | S1 |
| 4 | postgresql.conf 핫 리로드 | pg_reload_conf() | 2일 | S2 |
| 5 | 백업 보존 정리 | retentionPolicy | 3일 | S5 |
| 4 | postgresql.conf 핫 리로드 | pg_reload_conf() | ✅ Done (#126) | S2 |
| 5 | 백업 보존 정리 | retentionPolicy | ✅ Done (#130) | S5 |

### P1 — 운영 신뢰성

| # | 격차 | CNPG 해당 기능 | 소요 | 스프린트 |
|---|------|---------------|------|----------|
| 6 | Switchover | cnpg promote | 3일 | S5 |
| 6 | Switchover | cnpg promote | ✅ Done (#130) | S5 |
| 7 | Fencing | cnpg fencing on/off | 3일 | S6 |
| 8 | 동기 복제 | syncReplicas | 2일 | S6 |
| 9 | pg_hba.conf 리로드 | Config 리로드 | 1일 | S2 |
| 10 | 커스텀 PG 파라미터 | spec.postgresql.parameters | 2일 | S2 |
| 9 | pg_hba.conf 리로드 | Config 리로드 | ✅ Done (#126) | S2 |
| 10 | 커스텀 PG 파라미터 | spec.postgresql.parameters | ✅ Done (#126) | S2 |

### P2 — 개선 (교체 비차단)

Expand Down
16 changes: 8 additions & 8 deletions docs/gap-analysis/GAP-ANALYSIS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,10 +60,10 @@ All assessments based on source code audit (2026-05-25).
| TLS | 🟡 Partial | Certificate CR generation; STS mounts pending |
| Router | 🟡 Partial | Resources created; image placeholder |
| Backup Store | ❌ Missing | Plugin interface only; zero store code |
| WAL Archiving | ❌ Missing | archive_mode=on but archive_command empty |
| WAL Archiving | ✅ Complete | archive_command wired to pgbackrest archive-push (PR #127) |
| PITR (full) | ❌ Missing | targetTime only; no object store restore |
| Retention Cleanup | ❌ Missing | Records but never deletes old backups |
| Config Hot-Reload | ❌ Missing | No pg_reload_conf() trigger |
| Retention Cleanup | ✅ Complete | enforceRetention() deletes old BackupJobs exceeding keepFull (PR #130) |
| Config Hot-Reload | ✅ Complete | pg_reload_conf() on ConfigMap change (PR #126) |
| Volume Snapshots | ❌ Missing | No VolumeSnapshot integration |
| Major Upgrade | ❌ Missing | No pg_upgrade orchestration |

Expand All @@ -75,20 +75,20 @@ All assessments based on source code audit (2026-05-25).

| # | Gap | CNPG Equivalent | Effort | Sprint |
|---|-----|-----------------|--------|--------|
| 1 | WAL archiving + object store | barmanObjectStore + CNPG-I | 2 weeks | S3 |
| 1 | WAL archiving | ~~barmanObjectStore~~ | ✅ Done (PR #127) | S3 |
| 2 | PITR from object store | spec.backup.recovery | 1 week | S4 |
| 3 | TLS Phase 3 (mounts + ssl=on) | Default behavior | 3 days | S1 |
| 4 | postgresql.conf hot-reload | pg_reload_conf() on change | 2 days | S2 |
| 5 | Backup retention cleanup | retentionPolicy | 3 days | S5 |
| 4 | postgresql.conf hot-reload | ~~pg_reload_conf()~~ | ✅ Done (PR #126) | S2 |
| 5 | Backup retention cleanup | ~~retentionPolicy~~ | ✅ Done (PR #130) | S5 |

### P1 — Operational Confidence

| # | Gap | CNPG Equivalent | Effort | Sprint |
|---|-----|-----------------|--------|--------|
| 6 | Switchover | cnpg promote | 3 days | S5 |
| 6 | Switchover | ~~cnpg promote~~ | ✅ Done (PR #129) | S5 |
| 7 | Fencing | cnpg fencing on/off | 3 days | S6 |
| 8 | Synchronous replication | syncReplicas | 2 days | S6 |
| 9 | pg_hba.conf reload | Config reload | 1 day | S2 |
| 9 | pg_hba.conf reload | ~~Config reload~~ | ✅ Done (PR #126) | S2 |
| 10 | Custom PG parameters | spec.postgresql.parameters | 2 days | S2 |

### P2 — Enhancement (not blocking)
Expand Down
12 changes: 6 additions & 6 deletions docs/gap-analysis/GAP-ANALYSIS.zh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,21 +23,21 @@ keiailab/postgres-operator v0.3.0-alpha.18的功能。

| # | 差距 | CNPG等价 | 工作量 | Sprint |
|---|------|---------|--------|--------|
| 1 | WAL归档 + 对象存储 | barmanObjectStore | 2周 | S3 |
| 1 | WAL归档 + 对象存储 | barmanObjectStore | ✅ Done (#127) | S3 |
| 2 | 对象存储PITR | spec.backup.recovery | 1周 | S4 |
| 3 | TLS Phase 3 (挂载 + ssl=on) | 默认行为 | 3天 | S1 |
| 4 | postgresql.conf热重载 | pg_reload_conf() | 2天 | S2 |
| 5 | 备份保留清理 | retentionPolicy | 3天 | S5 |
| 4 | postgresql.conf热重载 | pg_reload_conf() | ✅ Done (#126) | S2 |
| 5 | 备份保留清理 | retentionPolicy | ✅ Done (#130) | S5 |

### P1 — 运营可靠性

| # | 差距 | CNPG等价 | 工作量 | Sprint |
|---|------|---------|--------|--------|
| 6 | Switchover | cnpg promote | 3天 | S5 |
| 6 | Switchover | cnpg promote | ✅ Done (#130) | S5 |
| 7 | Fencing | cnpg fencing | 3天 | S6 |
| 8 | 同步复制 | syncReplicas | 2天 | S6 |
| 9 | pg_hba.conf重载 | Config重载 | 1天 | S2 |
| 10 | 自定义PG参数 | spec.postgresql.parameters | 2天 | S2 |
| 9 | pg_hba.conf重载 | Config重载 | ✅ Done (#126) | S2 |
| 10 | 自定义PG参数 | spec.postgresql.parameters | ✅ Done (#126) | S2 |

---

Expand Down