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>
87 lines
2.3 KiB
Markdown
87 lines
2.3 KiB
Markdown
# Migration Overview
|
|
|
|
**Document Version:** 1.0
|
|
**Created:** 2025-11-16T10:30:00Z
|
|
**Last Updated:** 2025-11-16T10:30:00Z
|
|
|
|
## Objective
|
|
|
|
Migrate Gitea service from photon.obnh.io to fry.obr.sh with zero data loss and minimal downtime.
|
|
|
|
## Infrastructure Details
|
|
|
|
### Source Server: photon.obnh.io
|
|
- **Role:** Legacy container host
|
|
- **Management:** Dockge WebUI
|
|
- **Services:** Gitea (gitea + gitea_postgres containers)
|
|
|
|
### Target Server: fry.obr.sh
|
|
- **IP:** 45.131.64.213
|
|
- **Role:** New container host
|
|
- **Management:** Dockge WebUI
|
|
- **Status:** Ready for deployment
|
|
|
|
## Critical Components
|
|
|
|
### Gitea Service
|
|
- **Container 1:** gitea (application)
|
|
- **Container 2:** gitea_postgres (database)
|
|
- **Database:** PostgreSQL with critical repository data
|
|
- **Volumes:** Git repository data, configs, database files
|
|
|
|
## Migration Strategy
|
|
|
|
1. **Backup-First Approach**
|
|
- Full PostgreSQL dump before any changes
|
|
- Volume snapshots where applicable
|
|
- Verify backup integrity
|
|
|
|
2. **Graceful Shutdown**
|
|
- Stop application container first
|
|
- Stop database container second
|
|
- Verify all processes stopped
|
|
|
|
3. **Data Transfer**
|
|
- Secure transfer of database dumps
|
|
- Transfer docker-compose configuration
|
|
- Preserve volume data
|
|
|
|
4. **Staged Deployment**
|
|
- Deploy database container first
|
|
- Restore database from dump
|
|
- Deploy application container
|
|
- Verify connectivity
|
|
|
|
5. **Verification**
|
|
- Browser-based functional testing
|
|
- DNS resolution verification
|
|
- Repository access testing
|
|
|
|
## Risk Mitigation
|
|
|
|
- **Database Corruption:** Full pg_dump before migration
|
|
- **Network Issues:** Local backups retained on source
|
|
- **Configuration Drift:** Exact docker-compose.yml export
|
|
- **Service Downtime:** Documented rollback procedure
|
|
|
|
## Success Criteria
|
|
|
|
- [ ] Gitea accessible via browser on fry.obr.sh
|
|
- [ ] All repositories intact and browsable
|
|
- [ ] User authentication functional
|
|
- [ ] Database queries responding correctly
|
|
- [ ] DNS routing verified (if applicable)
|
|
- [ ] All documentation committed to git
|
|
|
|
## Timeline
|
|
|
|
- **Preparation:** 30 minutes
|
|
- **Backup:** 15 minutes
|
|
- **Migration:** 45 minutes
|
|
- **Verification:** 30 minutes
|
|
- **Total:** ~2 hours
|
|
|
|
## Next Steps
|
|
|
|
Proceed to [02-gitea-migration.md](./02-gitea-migration.md) for detailed execution steps.
|