6bbbb65238
- 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>
189 lines
4.5 KiB
Markdown
189 lines
4.5 KiB
Markdown
# 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.*
|