fengling-activity/scripts/EXAMPLES.md

Usage Examples

This document provides practical examples for using the infrastructure initialization scripts.

Quick Start Examples

Default Setup (MySQL + Redis + RabbitMQ)

# Using Docker Compose (Recommended)
docker compose up -d

# Using shell script (Linux/macOS)
./init-infrastructure.sh

# Using PowerShell (Windows)
.\init-infrastructure.ps1

Different Database Options

# Use PostgreSQL instead of MySQL
docker compose --profile postgres up -d

# Use SQL Server instead of MySQL  
docker compose --profile sqlserver up -d

# With PowerShell
.\init-infrastructure.ps1 -Postgres
.\init-infrastructure.ps1 -SqlServer

Different Message Queue Options

# Use Kafka instead of RabbitMQ
docker compose --profile kafka up -d

# With PowerShell
.\init-infrastructure.ps1 -Kafka

Cleanup Examples

# Stop services, keep data
docker compose down
./clean-infrastructure.sh
.\clean-infrastructure.ps1

# Stop services and remove all data
docker compose down -v
./clean-infrastructure.sh --volumes  
.\clean-infrastructure.ps1 -Volumes

Development Workflow

Typical Development Session

# 1. Start infrastructure
cd scripts
docker compose up -d

# 2. Develop your application
cd ../src/Fengling.Activity.Web
dotnet run

# 3. Run tests
cd ../../
dotnet test

# 4. Stop infrastructure (keep data)
cd scripts
docker compose down

Clean Development Environment

# Clean slate - remove everything including data
cd scripts  
docker compose down -v

# Start fresh
docker compose up -d

Troubleshooting

Check Service Status

# List running containers
docker ps

# Check specific service logs
docker logs netcorepal-mysql
docker logs netcorepal-redis
docker logs netcorepal-rabbitmq

# Check service health
docker compose ps

Common Issues

Port Already in Use

# Find what's using the port
netstat -tulpn | grep :3306  # Linux
netstat -ano | findstr :3306  # Windows

# Stop conflicting services
sudo systemctl stop mysql  # Linux
net stop mysql80           # Windows

Container Won't Start

# Remove problematic container and restart
docker rm -f netcorepal-mysql
docker compose up -d mysql

Data Corruption

# Remove data volumes and start fresh
docker compose down -v
docker compose up -d

Connection Strings for Development

Update your appsettings.Development.json with these connection strings:

{
  "ConnectionStrings": {
    "Redis": "localhost:6379,defaultDatabase=0",
    "MySql": "Server=localhost;Port=3306;Database=abctemplate;Uid=root;Pwd=123456;",
    "SqlServer": "Server=localhost,1433;Database=abctemplate;User Id=sa;Password=Test123456!;TrustServerCertificate=true;",
    "PostgreSQL": "Host=localhost;Port=15432;Database=abctemplate;Username=postgres;Password=123456;"
  },
  "RabbitMQ": {
    "HostName": "localhost",
    "Port": 5672,
    "UserName": "guest",
    "Password": "guest",
    "VirtualHost": "/"
  },
  "Kafka": {
    "BootstrapServers": "localhost:9092"
  }
}