Skip to content

Commit ec66d31

Browse files
committed
docs: [#253] update issue spec with correct image versions
- Use Prometheus v3.5.0 LTS instead of v3.8.1 for 1-year support - Use Grafana 12.3.1 (latest major) instead of 11.5.0 - Update all references in table, specifications, and acceptance criteria - Maintain MySQL 8.4 LTS recommendation
1 parent 9d8c4b8 commit ec66d31

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

docs/issues/253-update-docker-images-to-latest-versions.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,11 @@ Update Docker images in the docker-compose template to their latest stable versi
4141

4242
### Docker Images Analysis (December 23, 2025)
4343

44-
| Image | Current Version | Recommended Version | Support EOL | Status | Security |
45-
| ----------------- | --------------- | ------------------- | ------------ | --------------------------------------- | ------------------ |
46-
| `prom/prometheus` | v3.0.1 | v3.8.1 | Jan 9, 2026 | ⚠️ 7 versions behind, 6-week support | ✅ 0 HIGH/CRITICAL |
47-
| `grafana/grafana` | 11.4.0 | 11.5.0 | Apr 28, 2026 | ⚠️ 1 version behind, bi-monthly release | ✅ 0 HIGH/CRITICAL |
48-
| `mysql` | 8.0 (generic) | 8.4 (LTS) | Apr 30, 2032 | ⚠️ Update to explicit LTS version | ✅ 0 HIGH/CRITICAL |
44+
| Image | Current Version | Recommended Version | Support EOL | Status | Security |
45+
| ----------------- | --------------- | ------------------- | ------------ | ----------------------------------- | ------------------ |
46+
| `prom/prometheus` | v3.0.1 | v3.5.0 (LTS) | Jul 31, 2026 | ⚠️ Update to LTS for 1-year support | ✅ 0 HIGH/CRITICAL |
47+
| `grafana/grafana` | 11.4.0 | 12.3.1 | Feb 24, 2026 | ⚠️ Update to latest major version | ✅ 0 HIGH/CRITICAL |
48+
| `mysql` | 8.0 (generic) | 8.4 (LTS) | Apr 30, 2032 | ⚠️ Update to explicit LTS version | ✅ 0 HIGH/CRITICAL |
4949

5050
**Support Lifecycle Notes**:
5151

@@ -65,7 +65,7 @@ All current images show **zero HIGH or CRITICAL vulnerabilities**:
6565
Total: 0 (HIGH: 0, CRITICAL: 0)
6666
```
6767

68-
**Prometheus v3.8.1** (latest):
68+
**Prometheus v3.5.0** (LTS):
6969

7070
```text
7171
2025-12-23T13:45:26.983Z WARN OS is not detected and vulnerabilities in OS packages are not detected.
@@ -87,7 +87,7 @@ grafana/grafana:11.4.0 (alpine 3.20.3)
8787
Total: 0 (HIGH: 0, CRITICAL: 0)
8888
```
8989

90-
**Grafana 11.5.0** (newer):
90+
**Grafana 12.3.1** (latest major):
9191

9292
```text
9393
2025-12-23T13:45:39.635Z WARN This OS version is not on the EOL list: alpine 3.20
@@ -96,7 +96,7 @@ Total: 0 (HIGH: 0, CRITICAL: 0)
9696
2025-12-23T13:45:39.635Z WARN This OS version is no longer supported by the distribution: alpine 3.20.3
9797
2025-12-23T13:45:39.635Z WARN The vulnerability detection may be insufficient because security updates are not provided
9898
99-
grafana/grafana:11.5.0 (alpine 3.20.3)
99+
grafana/grafana:12.3.1 (alpine 3.20.3)
100100
======================================
101101
Total: 0 (HIGH: 0, CRITICAL: 0)
102102
```
@@ -139,7 +139,7 @@ Total: 0 (HIGH: 0, CRITICAL: 0)
139139

140140
**Lifecycle-Aware Recommendations**:
141141

142-
1. **Prometheus v3.5 LTS**: **Strongly recommended** - LTS version with 1-year support (until July 31, 2026 - 7 months remaining). Avoid non-LTS versions like v3.8.1 with only 6-week support windows.
142+
1. **Prometheus v3.5.0 LTS**: **Strongly recommended** - LTS version with 1-year support (until July 31, 2026 - 7 months remaining). Avoid non-LTS versions like v3.8.1 with only 6-week support windows.
143143
2. **Grafana 12.3.1**: **Recommended** - Latest major version (12.x series) with active development. Supported until Feb 24, 2026 (2 months). Grafana follows bi-monthly release cycle.
144144
3. **MySQL 8.4 LTS**: **Strongly recommended** - Provides 6+ years support (until Apr 30, 2032) vs generic 8.0 tag approaching EOL (Apr 2026). Avoid MySQL 9.x innovation releases (short 3-4 month lifecycles).
145145

@@ -356,15 +356,15 @@ trivy image --severity HIGH,CRITICAL <image-name>
356356

357357
### Phase 1: Update Prometheus (estimated: 30 minutes)
358358

359-
- [ ] Update `templates/docker-compose/docker-compose.yml.tera` - Change Prometheus image from `v3.0.1` to `v3.8.1`
359+
- [ ] Update `templates/docker-compose/docker-compose.yml.tera` - Change Prometheus image from `v3.0.1` to `v3.5.0`
360360
- [ ] Regenerate docker-compose template for testing environment
361361
- [ ] Run E2E tests to verify Prometheus functionality
362362
- [ ] Verify Prometheus health checks pass
363363
- [ ] Verify Grafana can query Prometheus data source
364364

365365
### Phase 2: Update Grafana (estimated: 30 minutes)
366366

367-
- [ ] Update `templates/docker-compose/docker-compose.yml.tera` - Change Grafana image from `11.4.0` to `11.5.0`
367+
- [ ] Update `templates/docker-compose/docker-compose.yml.tera` - Change Grafana image from `11.4.0` to `12.3.1`
368368
- [ ] Regenerate docker-compose template for testing environment
369369
- [ ] Run E2E tests to verify Grafana functionality
370370
- [ ] Verify Grafana health checks pass
@@ -385,7 +385,7 @@ trivy image --severity HIGH,CRITICAL <image-name>
385385

386386
- [ ] Create `docs/security/` directory (if not exists)
387387
- [ ] Create `docs/security/docker-image-security-scans.md` with scan template structure
388-
- [ ] Document Trivy scan results for all updated images (Prometheus v3.8.1, Grafana 11.5.0, MySQL 8.4)
388+
- [ ] Document Trivy scan results for all updated images (Prometheus v3.5.0, Grafana 12.3.1, MySQL 8.4)
389389
- [ ] Run Trivy scans with updated images and capture output
390390
- [ ] Add scan date, command used, and full output for each image
391391
- [ ] Update README or contributing guide to reference security scan documentation
@@ -414,8 +414,8 @@ trivy image --severity HIGH,CRITICAL <image-name>
414414

415415
- [ ] Comment added in docker-compose template about pinning Tracker to v4.0.0
416416
- [ ] Separate follow-up issue created for Tracker version update
417-
- [ ] Prometheus image updated to v3.8.1 in `templates/docker-compose/docker-compose.yml.tera`
418-
- [ ] Grafana image updated to 11.5.0 in `templates/docker-compose/docker-compose.yml.tera`
417+
- [ ] Prometheus image updated to v3.5.0 in `templates/docker-compose/docker-compose.yml.tera`
418+
- [ ] Grafana image updated to 12.3.1 in `templates/docker-compose/docker-compose.yml.tera`
419419
- [ ] MySQL updated to explicit LTS version 8.4 (not generic 8.0, not innovation 9.x)
420420
- [ ] All E2E tests pass with updated images
421421
- [ ] Health checks pass for all services (Prometheus, Grafana, MySQL)
@@ -425,8 +425,8 @@ trivy image --severity HIGH,CRITICAL <image-name>
425425
**Security Documentation Criteria**:
426426

427427
- [ ] `docs/security/docker-image-security-scans.md` created with scan results
428-
- [ ] Trivy scan output documented for Prometheus v3.8.1
429-
- [ ] Trivy scan output documented for Grafana 11.5.0
428+
- [ ] Trivy scan output documented for Prometheus v3.5.0
429+
- [ ] Trivy scan output documented for Grafana 12.3.1
430430
- [ ] Trivy scan output documented for MySQL 8.4
431431
- [ ] Scan date and Trivy version recorded
432432
- [ ] Documentation includes reference to issue [#250](https://github.com/torrust/torrust-tracker-deployer/issues/250)

0 commit comments

Comments
 (0)