Skip to content

Commit ccb2fef

Browse files
committed
Update release notes for v5.0.0 launch
1 parent e15f4d4 commit ccb2fef

1 file changed

Lines changed: 33 additions & 31 deletions

File tree

.github/workflows/release.yml

Lines changed: 33 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -89,57 +89,59 @@ jobs:
8989
9090
# Generate release notes
9191
cat > release-notes.md << 'EOF'
92-
## 🔧 Patch Release: v2.4.1
92+
## 🚀 database-replicator v5.0.0
9393
94-
This patch release adds comprehensive automatic connection retry logic with exponential backoff to prevent failures during long-running operations when database connections drop unexpectedly.
94+
**Universal database-to-PostgreSQL replication CLI** - Now open source!
9595
96-
### 🐛 Bug Fixes
96+
This is the first public release of `database-replicator`, a command-line tool for replicating databases from multiple sources to PostgreSQL with zero downtime.
9797
98-
**Automatic Connection Retry for Direct Database Connections (#119)**
99-
- Database connections that drop during long operations now automatically retry instead of failing
100-
- Prevents "Connection error: connection closed" errors during `init`, filtered copy, and schema introspection
101-
- Applies to: database discovery, creation, filtered table copy, column queries, wal_level checks
102-
- Maximum 3 retry attempts with exponential backoff (1s, 2s, 4s delays)
103-
- Clear logging shows retry attempts and remaining retries
98+
### ✨ Features
10499
105-
**Technical Details (#119):**
106-
- Exported `connect_with_retry()` function from postgres module
107-
- Replaced `connect()` with `connect_with_retry()` in 9 critical locations
108-
- Uses existing exponential backoff implementation
100+
**Multi-Database Support:**
101+
- **PostgreSQL → PostgreSQL**: Zero-downtime replication with continuous sync via logical replication
102+
- **SQLite → PostgreSQL**: One-time replication with JSONB storage
103+
- **MongoDB → PostgreSQL**: One-time replication with JSONB storage and periodic refresh
104+
- **MySQL/MariaDB → PostgreSQL**: One-time replication with JSONB storage and periodic refresh
109105
110-
**Automatic Retry for External PostgreSQL Commands (#120)**
111-
- External subprocess commands (psql, pg_restore, pg_dump, pg_dumpall) now retry on connection failures
112-
- Prevents failures during long-running dump/restore operations (5+ minutes)
113-
- All dump and restore operations protected with retry logic
114-
- Database connections properly scoped to avoid idle timeouts during subprocess execution
115-
- Gracefully handles transient network issues, timeouts, and temporary server unavailability
106+
**Key Capabilities:**
107+
- Automatic source database type detection
108+
- Interactive mode for database/table selection
109+
- Selective replication with filtering support
110+
- Checkpointing for resume support on interruption
111+
- Data integrity verification with checksums
112+
- Parallel dump/restore operations
113+
- Real-time replication lag monitoring
116114
117-
**Technical Details (#120):**
118-
- Added `retry_subprocess_with_backoff()` utility function for subprocess retry
119-
- Wrapped all psql/pg_restore/pg_dump/pg_dumpall calls with retry logic
120-
- Maximum 3 retry attempts with exponential backoff (1s, 2s, 4s delays)
121-
- Properly scoped database connections to drop before long subprocess operations
115+
**SerenAI Cloud Execution:**
116+
- Run replications on SerenAI managed infrastructure (for SerenDB targets)
117+
- Use `--local` flag for local execution to any PostgreSQL target
122118
123-
### Installation
119+
### 📦 Installation
124120
125-
Download the appropriate binary for your platform:
121+
**From crates.io:**
122+
```bash
123+
cargo install database-replicator
124+
```
126125
126+
**Download binaries:**
127127
- **Linux (x64)**: `database-replicator-linux-x64-binary`
128128
- **macOS (Intel)**: `database-replicator-macos-x64-binary`
129129
- **macOS (Apple Silicon)**: `database-replicator-macos-arm64-binary`
130130
131-
Make the binary executable:
132-
133131
```bash
134132
chmod +x database-replicator-*-binary
135133
./database-replicator-*-binary --version
136134
```
137135
138-
### Upgrade Recommendation
136+
### 🔗 Links
137+
138+
- **Documentation**: https://github.com/serenorg/database-replicator#readme
139+
- **Crates.io**: https://crates.io/crates/database-replicator
140+
- **Issues**: https://github.com/serenorg/database-replicator/issues
139141
140-
**Recommended upgrade** for all users. This fix significantly improves reliability during long-running replications, especially over unstable network connections or when replicating large databases that may exceed connection timeouts.
142+
### License
141143
142-
**Full Changelog**: https://github.com/serenorg/database-replicator/compare/v4.2.3...${VERSION}
144+
Apache License 2.0
143145
EOF
144146
145147
# Create release with all binaries

0 commit comments

Comments
 (0)