Initial migration guide structure

- Created repository layout (docs, screenshots, backups, docker-configs) - Added comprehensive README with project overview - Created 01-overview.md with migration strategy - Created 02-gitea-migration.md execution template - Defined success criteria and risk mitigation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-16 10:39:49 +00:00
commit 6bbbb65238
3 changed files with 336 additions and 0 deletions
--- a/docs/02-gitea-migration.md
+++ b/docs/02-gitea-migration.md
@@ -0,0 +1,188 @@
+# Gitea Migration - Detailed Execution Log
+
+**Service:** Gitea (Git hosting)
+**Started:** 2025-11-16T10:30:00Z
+**Status:** In Progress
+
+## Pre-Migration Checklist
+
+- [ ] Dockge WebUI accessible on photon.obnh.io
+- [ ] Both containers (gitea + gitea_postgres) visible
+- [ ] Screenshots captured
+- [ ] Database backup created
+- [ ] Backup verified and transferred
+
+## Step 1: Pre-Migration Backup
+
+### Actions Required
+1. Access photon.obnh.io Dockge WebUI
+2. Identify gitea_postgres container
+3. Execute pg_dump command
+4. Save backup to `/home/olaf/dockge-migration-guide/backups/`
+5. Verify backup file integrity
+
+### Commands
+```bash
+# Database dump (to be executed on photon)
+docker exec gitea_postgres pg_dump -U gitea gitea > gitea_db_backup_$(date +%Y%m%d_%H%M%S).sql
+
+# Verify backup
+ls -lh gitea_db_backup_*.sql
+```
+
+### Evidence
+- Screenshot: `screenshots/01-photon-dockge-containers.png`
+- Backup file: `backups/gitea_db_backup_TIMESTAMP.sql`
+
+---
+
+## Step 2: Screenshot Documentation
+
+### Dockge Container View
+- [ ] Screenshot showing both gitea containers
+- [ ] Container status visible (running/stopped)
+- [ ] File: `screenshots/01-photon-dockge-containers.png`
+
+---
+
+## Step 3: Stop Gitea Service
+
+### Procedure
+1. Navigate to Dockge WebUI on photon
+2. Stop gitea container (application first)
+3. Screenshot the stop action
+4. Stop gitea_postgres container (database second)
+5. Screenshot the stop action
+6. Verify both containers stopped
+
+### Evidence
+- Screenshot: `screenshots/02-stop-gitea-container.png`
+- Screenshot: `screenshots/03-stop-postgres-container.png`
+- Screenshot: `screenshots/04-both-containers-stopped.png`
+
+---
+
+## Step 4: Export Docker Compose Configuration
+
+### Actions
+1. Open Dockge WebUI on photon
+2. Navigate to Gitea stack
+3. Copy entire docker-compose.yml content
+4. Save to `docker-configs/gitea-compose-photon.yml`
+5. Screenshot the configuration view
+
+### Evidence
+- Config file: `docker-configs/gitea-compose-photon.yml`
+- Screenshot: `screenshots/05-docker-compose-export.png`
+
+---
+
+## Step 5: Database Transfer
+
+### Actions
+1. Transfer database dump to fry.obr.sh
+2. Verify file integrity (checksum)
+3. Prepare for restore
+
+### Commands
+```bash
+# Transfer to fry
+scp gitea_db_backup_*.sql root@fry.obr.sh:/tmp/
+
+# Verify on fry
+ssh root@fry.obr.sh "md5sum /tmp/gitea_db_backup_*.sql"
+```
+
+---
+
+## Step 6: Deploy on Fry
+
+### Procedure
+1. Access Dockge WebUI on fry.obr.sh
+2. Create new stack named "gitea"
+3. Paste docker-compose.yml content
+4. Start postgres container first
+5. Restore database
+6. Start gitea container
+7. Screenshot each step
+
+### Database Restore
+```bash
+# Restore database (execute on fry)
+docker exec -i gitea_postgres psql -U gitea gitea < /tmp/gitea_db_backup_*.sql
+```
+
+### Evidence
+- Screenshot: `screenshots/06-fry-dockge-new-stack.png`
+- Screenshot: `screenshots/07-fry-compose-paste.png`
+- Screenshot: `screenshots/08-fry-postgres-started.png`
+- Screenshot: `screenshots/09-fry-gitea-started.png`
+
+---
+
+## Step 7: Browser Verification
+
+### Playwright Automation
+- [ ] Navigate to git.photon.obnh.io (should resolve to fry)
+- [ ] Verify login page loads
+- [ ] Test repository browsing
+- [ ] Screenshot successful access
+
+### Verification Points
+1. DNS resolution (should point to 45.131.64.213)
+2. HTTPS certificate valid
+3. Login page renders
+4. Repository list accessible
+5. Git operations functional
+
+### Evidence
+- Screenshot: `screenshots/10-browser-login-page.png`
+- Screenshot: `screenshots/11-browser-repo-list.png`
+
+---
+
+## Step 8: Final Verification
+
+### Checklist
+- [ ] Gitea accessible via browser
+- [ ] All repositories visible
+- [ ] User authentication working
+- [ ] Git clone/push operations tested
+- [ ] DNS routing verified
+
+---
+
+## Post-Migration
+
+### Actions
+- [ ] Commit all screenshots to git
+- [ ] Update this document with timestamps
+- [ ] Tag git commit: `gitea-migration-complete`
+- [ ] Archive backups
+
+### Rollback Procedure (if needed)
+1. Stop containers on fry
+2. Restart containers on photon
+3. Verify service restoration
+4. Document incident
+
+---
+
+## Timeline
+
+| Step | Started | Completed | Duration | Status |
+|------|---------|-----------|----------|--------|
+| Pre-Migration Backup | | | | Pending |
+| Screenshot Documentation | | | | Pending |
+| Stop Gitea Service | | | | Pending |
+| Export Configuration | | | | Pending |
+| Database Transfer | | | | Pending |
+| Deploy on Fry | | | | Pending |
+| Browser Verification | | | | Pending |
+| Git Commit | | | | Pending |
+
+---
+
+## Notes
+
+*This document will be updated in real-time as the migration progresses.*