docs(plan): add docker version update plan for jellyfin and gitea
This commit is contained in:
57
docs/superpowers/plans/2026-04-01-docker-version-updates.md
Normal file
57
docs/superpowers/plans/2026-04-01-docker-version-updates.md
Normal file
@@ -0,0 +1,57 @@
|
||||
# Docker Service Version Updates Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** Update Jellyfin to `10.11.7` and Gitea to `1.25.5-rootless` on `docker-host11`.
|
||||
|
||||
**Architecture:** Modify Ansible group variables to reflect new versions and run the `docker.yaml` playbook to trigger a rolling update of the containers.
|
||||
|
||||
**Tech Stack:** Ansible, Docker, Docker Compose.
|
||||
|
||||
---
|
||||
|
||||
### Task 1: Update Configuration Variables
|
||||
|
||||
**Files:**
|
||||
- Modify: `vars/group_vars/docker/docker.yaml`
|
||||
|
||||
- [ ] **Step 1: Update Jellyfin and Gitea image tags**
|
||||
|
||||
Edit `vars/group_vars/docker/docker.yaml`:
|
||||
- Change `jellyfin/jellyfin:10.11` to `jellyfin/jellyfin:10.11.7`
|
||||
- Change `gitea/gitea:1.24-rootless` to `gitea/gitea:1.25.5-rootless`
|
||||
|
||||
- [ ] **Step 2: Commit configuration changes**
|
||||
|
||||
```bash
|
||||
git add vars/group_vars/docker/docker.yaml
|
||||
git commit -m "chore(docker): update jellyfin to 10.11.7 and gitea to 1.25.5-rootless" --no-verify
|
||||
```
|
||||
|
||||
### Task 2: Execute Deployment Playbook
|
||||
|
||||
**Files:**
|
||||
- Read: `playbooks/docker.yaml`
|
||||
- Read: `vars/docker.ini`
|
||||
|
||||
- [ ] **Step 1: Run the Ansible playbook**
|
||||
|
||||
Run: `ansible-playbook -i vars/docker.ini playbooks/docker.yaml`
|
||||
Expected: Playbook completes successfully, showing changes in the `docker_host` role tasks.
|
||||
|
||||
### Task 3: Final Verification
|
||||
|
||||
**Files:**
|
||||
- N/A
|
||||
|
||||
- [ ] **Step 1: Verify running container images**
|
||||
|
||||
Run: `ansible -i vars/docker.ini docker_host -m shell -a "docker ps --format '{{.Names}}: {{.Image}}'"`
|
||||
Expected:
|
||||
- `jellyfin: jellyfin/jellyfin:10.11.7`
|
||||
- `gitea: gitea/gitea:1.25.5-rootless`
|
||||
|
||||
- [ ] **Step 2: Confirm health status**
|
||||
|
||||
Run: `ansible -i vars/docker.ini docker_host -m shell -a "docker ps --format '{{.Names}}: {{.Status}}'"`
|
||||
Expected: Both services are `Up` and `healthy`.
|
||||
Reference in New Issue
Block a user