You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.8 KiB
1.8 KiB
LY.MicroService.Applications.Single.DbMigrator
Single application database migration tool for automatically executing database migrations and initializing data.
Features
- Automatic database migration execution
- Multi-environment configuration support
- Integrated Serilog logging
- Data migration environment configuration support
- Automatic database migration check and application
- Console application, easy to integrate into CI/CD pipelines
Configuration
{
"ConnectionStrings": {
"Default": "your-database-connection-string"
},
"Serilog": {
"MinimumLevel": {
"Default": "Information",
"Override": {
"Microsoft": "Warning",
"Volo.Abp": "Warning"
}
}
}
}
Basic Usage
-
Configure Database Connection
- Configure database connection string in appsettings.json
- Use appsettings.{Environment}.json for different environment configurations
-
Run Migration Tool
dotnet run -
View Migration Logs
- Console output
- Logs/migrations.txt file
Environment Variables
ASPNETCORE_ENVIRONMENT: Set runtime environment (Development, Staging, Production, etc.)DOTNET_ENVIRONMENT: Same as above, for compatibility
Notes
- Ensure database connection string includes sufficient permissions
- Recommended to backup database before executing migrations
- Check migrations.txt log file for migration details
- If migration fails, check error messages in logs
Development and Debugging
-
Set Environment Variables
export ASPNETCORE_ENVIRONMENT=Development -
Debug with Visual Studio or Visual Studio Code
- Set breakpoints
- View detailed migration process
-
Customize Migration Logic
- Modify SingleDbMigrationService class
- Add new data seeds