sam
e24925e1ed
- 新增 .dockerignore 文件，忽略多种临时及中间文件 - 新增 .gitattributes 文件，配置文本文件换行及合并行为 - 新增详细的 .gitignore 文件，排除多种开发及生成文件 - 新增 VS Code C# 代码片段，提升开发效率 - 添加 Directory.Build.props，统一 MSBuild 配置和代码分析规则 - 添加空的 Directory.Build.targets，预留构建任务扩展位置 - 添加 Directory.Packages.props，实现依赖包版本集中管理和声明
151 lines
3.0 KiB
Markdown
151 lines
3.0 KiB
Markdown
# Usage Examples
|
|
|
|
This document provides practical examples for using the infrastructure initialization scripts.
|
|
|
|
## Quick Start Examples
|
|
|
|
### Default Setup (MySQL + Redis + RabbitMQ)
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Use Kafka instead of RabbitMQ
|
|
docker compose --profile kafka up -d
|
|
|
|
# With PowerShell
|
|
.\init-infrastructure.ps1 -Kafka
|
|
```
|
|
|
|
### Cleanup Examples
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 1. Start infrastructure
|
|
cd scripts
|
|
docker compose up -d
|
|
|
|
# 2. Develop your application
|
|
cd ../src/Fengling.Backend.Web
|
|
dotnet run
|
|
|
|
# 3. Run tests
|
|
cd ../../
|
|
dotnet test
|
|
|
|
# 4. Stop infrastructure (keep data)
|
|
cd scripts
|
|
docker compose down
|
|
```
|
|
|
|
### Clean Development Environment
|
|
```bash
|
|
# Clean slate - remove everything including data
|
|
cd scripts
|
|
docker compose down -v
|
|
|
|
# Start fresh
|
|
docker compose up -d
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Check Service Status
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Remove problematic container and restart
|
|
docker rm -f netcorepal-mysql
|
|
docker compose up -d mysql
|
|
```
|
|
|
|
#### Data Corruption
|
|
```bash
|
|
# 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:
|
|
|
|
```json
|
|
{
|
|
"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=5432;Database=abctemplate;Username=postgres;Password=123456;"
|
|
},
|
|
"RabbitMQ": {
|
|
"HostName": "localhost",
|
|
"Port": 5672,
|
|
"UserName": "guest",
|
|
"Password": "guest",
|
|
"VirtualHost": "/"
|
|
},
|
|
"Kafka": {
|
|
"BootstrapServers": "localhost:9092"
|
|
}
|
|
}
|
|
``` |