Skip to content

Commit 02df09f

Browse files
committed
docs: Update DOCKER_README with tag strategy improvements and resilience notes
- Remove references to old master-YYYYMMDD-...sha tags - Add section explaining tag strategy optimization (October 2025) - Document why we use 3 tags instead of 4 (registry reliability) - Add note about infrastructure resilience for Docker Hub timeouts - Reference AWS outages as potential cause of transient API issues - Include guidance for users if they encounter Docker Hub issues Tag strategy now: latest (current production) v1.1.1 (semantic version) sha-9286931 (commit SHA, 12-char short) This reduces registry pressure and improves reliability during infrastructure issues like AWS outages or Docker Hub API limits.
1 parent e1338f6 commit 02df09f

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

DOCKER_README.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -76,21 +76,32 @@ cursor://anysphere.cursor-deeplink/mcp/install?name=PostgreSQL%20Enterprise%20MC
7676

7777
## 🐳 Docker Tags
7878

79-
We provide multiple tags for different use cases:
79+
We provide optimized tags for reliability and traceability:
8080

8181
| Tag | Description | Use Case |
8282
|-----|-------------|----------|
8383
| `latest` | Latest stable release | **Recommended for production** |
8484
| `v1.1.1` | Specific version | Pin to exact version |
85-
| `sha-abc1234` | Commit SHA | Development/testing |
86-
| `master-YYYYMMDD-HHMMSS-sha` | Timestamped | Audit trail |
85+
| `sha-9286931` | Commit SHA (12-char short) | Development/testing/traceability |
8786

8887
**Pull a specific version:**
8988

9089
```bash
9190
docker pull writenotenow/postgres-mcp-enhanced:v1.1.1
9291
```
9392

93+
**Tag Strategy Updates (October 2025)**
94+
95+
We've optimized our Docker tagging approach for improved reliability:
96+
97+
-**Streamlined to 3 essential tags** - Reduces Docker Hub API pressure during multi-platform builds
98+
-**Short SHA format** (e.g., `sha-9286931`) - Maintains commit traceability with 60% smaller payload
99+
- ⚠️ **Removed `master-YYYYMMDD-...` timestamps** - These redundant tags caused upload bottlenecks and registry timeouts
100+
- 📝 **Infrastructure resilience** - Optimized strategy reduces impact of temporary outages (e.g., AWS/Docker Hub API issues)
101+
- 🔄 **Consistent across all projects** - Same strategy now used in memory-journal-mcp and postgres-mcp-server
102+
103+
**If you encounter Docker Hub timeouts:** This is typically due to infrastructure issues (AWS outages, Docker Hub API limits). The optimizations above significantly reduce the impact of such incidents. Your images are fully deployed and available, even if description updates or metrics uploads experience delays.
104+
94105
---
95106

96107
## 🔧 Configuration

0 commit comments

Comments
 (0)