141 lines
No EOL
3.3 KiB
Markdown
141 lines
No EOL
3.3 KiB
Markdown
# Migration Guide: Development Environment Workflow
|
|
|
|
**Status**: Active/Authoritative
|
|
**Last Updated**: April 5, 2025
|
|
**Scope**: Transition from old to new development environment workflow
|
|
|
|
This guide helps you transition from the old development environment workflow to the new backup-based workflow.
|
|
|
|
## Overview of Changes
|
|
|
|
The development environment workflow has been updated to use a backup-based approach:
|
|
|
|
### Old Workflow
|
|
```
|
|
setup-dev.sh → sync-production.sh → verify-dev.sh
|
|
```
|
|
|
|
### New Workflow
|
|
```
|
|
sync-production.sh → setup-from-backup.sh → verify-dev.sh
|
|
```
|
|
|
|
## Why the Change?
|
|
|
|
1. **More Reliable**: The new workflow uses existing backups, reducing the chance of errors during setup
|
|
2. **Faster Setup**: Setting up from a backup is faster than syncing directly from production
|
|
3. **Offline Support**: You can set up the environment without needing access to the production server
|
|
4. **Consistent Environment**: Everyone uses the same backup, ensuring consistent development environments
|
|
|
|
## Migration Steps
|
|
|
|
### Step 1: Update Your Repository
|
|
|
|
```bash
|
|
# Pull the latest changes
|
|
git pull
|
|
|
|
# Make sure you have the new scripts
|
|
ls -la bin/setup-from-backup.sh
|
|
```
|
|
|
|
### Step 2: Clean Up Your Current Environment (Optional)
|
|
|
|
If you want to start fresh:
|
|
|
|
```bash
|
|
# Stop and remove containers
|
|
docker-compose down
|
|
|
|
# Remove volumes (optional, will delete all data)
|
|
docker volume prune -f
|
|
```
|
|
|
|
### Step 3: Check for Existing Backups
|
|
|
|
```bash
|
|
# List available backups
|
|
ls -la backups/
|
|
```
|
|
|
|
If no backups are available, create one:
|
|
|
|
```bash
|
|
# Create a new backup from production
|
|
./bin/sync-production.sh
|
|
```
|
|
|
|
### Step 4: Set Up Using the New Workflow
|
|
|
|
```bash
|
|
# Set up from the latest backup
|
|
./bin/setup-from-backup.sh
|
|
|
|
# Verify the environment
|
|
./bin/verify-dev.sh
|
|
```
|
|
|
|
## Script Mapping
|
|
|
|
| Old Script | New Script | Notes |
|
|
|------------|------------|-------|
|
|
| `setup-dev.sh` | `setup-from-backup.sh` | New script uses existing backups |
|
|
| `sync-production.sh` | `sync-production.sh` | Same name, updated implementation |
|
|
| `verify-dev.sh` | `verify-dev.sh` | Same name, updated implementation |
|
|
| `sync-and-setup.sh` | Use both scripts separately | Split into two separate steps |
|
|
|
|
## Common Issues and Solutions
|
|
|
|
### "No backup found in backups/ directory!"
|
|
|
|
```bash
|
|
# Create a new backup from production
|
|
./bin/sync-production.sh
|
|
```
|
|
|
|
### "Cannot connect to production server"
|
|
|
|
You can still set up the environment if someone else has created a backup:
|
|
|
|
1. Get a backup from another developer
|
|
2. Place it in the `backups/` directory
|
|
3. Run `./bin/setup-from-backup.sh`
|
|
|
|
### "Database connection issues"
|
|
|
|
```bash
|
|
# Check database container
|
|
docker-compose ps | grep db
|
|
|
|
# Restart containers
|
|
docker-compose down && docker-compose up -d
|
|
|
|
# Verify database connection
|
|
./bin/verify-simple.sh
|
|
```
|
|
|
|
### "WordPress is not accessible"
|
|
|
|
```bash
|
|
# Check if WordPress container is running
|
|
docker-compose ps | grep wordpress
|
|
|
|
# Check WordPress logs
|
|
docker-compose logs wordpress
|
|
|
|
# Restart containers
|
|
docker-compose down && docker-compose up -d
|
|
```
|
|
|
|
## Additional Resources
|
|
|
|
- [README.md](README.md) - Updated documentation for the development environment
|
|
- [bin/obsolete/README.md](bin/obsolete/README.md) - Information about obsolete scripts
|
|
|
|
## Support
|
|
|
|
If you encounter any issues with the new workflow, please contact:
|
|
- Email: support@tealmaker.com
|
|
- Slack: #network-events-support
|
|
|
|
*Last Updated: March 26, 2025* |