02ade71ecd
- Create comprehensive README with migration overview - Add MIGRATION_STATUS.md for progress tracking - Set up directory structure for screenshots, docs, verification - Document migration methodology and requirements Generated with AI orchestration
116 lines
4.2 KiB
Markdown
116 lines
4.2 KiB
Markdown
# Dockge Migration Guide
|
|
|
|
Complete step-by-step guide for migrating all services from **photon.obnh.io** to **fry.obr.sh** using Dockge WebUI with comprehensive screenshot documentation.
|
|
|
|
## Migration Overview
|
|
|
|
**Source Server:** photon.obnh.io (95.217.133.54)
|
|
**Target Server:** fry.obr.sh (45.131.64.213)
|
|
**Method:** Docker Compose migration with Dockge WebUI management
|
|
**Documentation:** AI-annotated screenshots at every step
|
|
|
|
## Services to Migrate
|
|
|
|
Migration follows strict dependency order:
|
|
|
|
1. **[Traefik](docs/01-traefik-migration.md)** - CRITICAL FIRST (reverse proxy)
|
|
2. **[photon-default-page](docs/02-photon-default-page-migration.md)** - Simple test service
|
|
3. **[Gitea](docs/03-gitea-migration.md)** - Git hosting + PostgreSQL database
|
|
4. **[Mastodon (bern.social)](docs/04-mastodon-migration.md)** - Complex (5 containers)
|
|
|
|
## Repository Structure
|
|
|
|
```
|
|
/
|
|
├── README.md # This file
|
|
├── docs/ # Step-by-step migration guides
|
|
│ ├── 01-traefik-migration.md
|
|
│ ├── 02-photon-default-page-migration.md
|
|
│ ├── 03-gitea-migration.md
|
|
│ ├── 04-mastodon-migration.md
|
|
│ └── 99-troubleshooting.md
|
|
├── screenshots/ # All screenshots
|
|
│ ├── original/ # Original unmodified screenshots
|
|
│ └── annotated/ # AI-annotated with markup
|
|
├── compose-files/ # Docker compose configurations
|
|
├── verification/ # Browser verification results
|
|
└── MIGRATION_STATUS.md # Current migration progress
|
|
```
|
|
|
|
## Migration Methodology
|
|
|
|
### Pre-Migration Checklist
|
|
- [ ] Backup all data on source server
|
|
- [ ] Verify DNS records
|
|
- [ ] Test SSH access to both servers
|
|
- [ ] Verify Dockge running on both servers
|
|
- [ ] Document current service status
|
|
|
|
### Migration Steps (Per Service)
|
|
1. **Screenshot & Document** - Capture current state in Dockge WebUI
|
|
2. **Stop Service** - Gracefully stop on source server
|
|
3. **Export Configuration** - Copy docker-compose.yml and environment
|
|
4. **Transfer Data** - Migrate volumes, databases, persistent data
|
|
5. **Deploy on Target** - Apply configuration on fry.obr.sh
|
|
6. **Verify Running** - Check service health in Dockge
|
|
7. **Browser Verification** - Test via automated browser checks
|
|
8. **Update DNS** - Point domain to new server (when ready)
|
|
|
|
### Screenshot Documentation
|
|
- **Tool:** Playwright browser automation
|
|
- **AI Analysis:** google/gemini-2.5-flash-image via openrouter.ai
|
|
- **Annotations:** Arrows, circles, labels showing exact actions
|
|
- **Storage:** Both original and annotated versions in git
|
|
|
|
### Verification Requirements
|
|
Each migrated service must pass:
|
|
- HTTP 200 OK response
|
|
- Correct response headers (fry.obr.sh IP: 45.131.64.213)
|
|
- Service-specific health checks
|
|
- Browser screenshot proof
|
|
|
|
## Current Status
|
|
|
|
See [MIGRATION_STATUS.md](MIGRATION_STATUS.md) for real-time progress tracking.
|
|
|
|
## Tools & Technologies
|
|
|
|
- **Dockge:** WebUI for Docker Compose management (port 5001)
|
|
- **Docker Compose:** Container orchestration
|
|
- **Traefik:** Reverse proxy and SSL termination
|
|
- **Playwright:** Browser automation for verification
|
|
- **OpenRouter.AI:** Image analysis with Gemini 2.5 Flash
|
|
- **Gitea:** Documentation repository hosting
|
|
|
|
## Important Notes
|
|
|
|
⚠️ **Migration Order is Critical**
|
|
Traefik MUST be migrated first as it provides reverse proxy for all other services.
|
|
|
|
⚠️ **Downtime Expectations**
|
|
Each service will have brief downtime during migration. Plan accordingly.
|
|
|
|
⚠️ **DNS Propagation**
|
|
DNS changes can take 5-60 minutes to propagate globally.
|
|
|
|
⚠️ **Backup First**
|
|
All services have been backed up before migration begins.
|
|
|
|
## Support & Troubleshooting
|
|
|
|
See [docs/99-troubleshooting.md](docs/99-troubleshooting.md) for common issues and solutions.
|
|
|
|
## Generated Documentation
|
|
|
|
This guide was created using AI-assisted migration orchestration with:
|
|
- Multi-agent coordination for complex tasks
|
|
- Automated screenshot capture and analysis
|
|
- Browser-based verification
|
|
- Real-time documentation generation
|
|
|
|
---
|
|
|
|
**Migration Start Date:** 2025-11-16
|
|
**Estimated Completion:** TBD
|
|
**Repository:** https://git.proton.obr.sh/olaf/dockge-migration-guide
|