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>
This commit is contained in:
86
docs/01-overview.md
Normal file
86
docs/01-overview.md
Normal file
@@ -0,0 +1,86 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user