mirror of
https://github.com/uprightbass360/AzerothCore-RealmMaster.git
synced 2026-01-13 09:07:20 +00:00
feat: comprehensive module system and database management improvements
This commit introduces major enhancements to the module installation system, database management, and configuration handling for AzerothCore deployments. ## Module System Improvements ### Module SQL Staging & Installation - Refactor module SQL staging to properly handle AzerothCore's sql/ directory structure - Fix SQL staging path to use correct AzerothCore format (sql/custom/db_*/*) - Implement conditional module database importing based on enabled modules - Add support for both cpp-modules and lua-scripts module types - Handle rsync exit code 23 (permission warnings) gracefully during deployment ### Module Manifest & Automation - Add automated module manifest generation via GitHub Actions workflow - Implement Python-based module manifest updater with comprehensive validation - Add module dependency tracking and SQL file discovery - Support for blocked modules and module metadata management ## Database Management Enhancements ### Database Import System - Add db-guard container for continuous database health monitoring and verification - Implement conditional database import that skips when databases are current - Add backup restoration and SQL staging coordination - Support for Playerbots database (4th database) in all import operations - Add comprehensive database health checking and status reporting ### Database Configuration - Implement 10 new dbimport.conf settings from environment variables: - Database.Reconnect.Seconds/Attempts for connection reliability - Updates.AllowedModules for module auto-update control - Updates.Redundancy for data integrity checks - Worker/Synch thread settings for all three core databases - Auto-apply dbimport.conf settings via auto-post-install.sh - Add environment variable injection for db-import and db-guard containers ### Backup & Recovery - Fix backup scheduler to prevent immediate execution on container startup - Add backup status monitoring script with detailed reporting - Implement backup import/export utilities - Add database verification scripts for SQL update tracking ## User Import Directory - Add new import/ directory for user-provided database files and configurations - Support for custom SQL files, configuration overrides, and example templates - Automatic import of user-provided databases and configs during initialization - Documentation and examples for custom database imports ## Configuration & Environment - Eliminate CLIENT_DATA_VERSION warning by adding default value syntax - Improve CLIENT_DATA_VERSION documentation in .env.template - Add comprehensive database import settings to .env and .env.template - Update setup.sh to handle new configuration variables with proper defaults ## Monitoring & Debugging - Add status dashboard with Go-based terminal UI (statusdash.go) - Implement JSON status output (statusjson.sh) for programmatic access - Add comprehensive database health check script - Add repair-storage-permissions.sh utility for permission issues ## Testing & Documentation - Add Phase 1 integration test suite for module installation verification - Add comprehensive documentation for: - Database management (DATABASE_MANAGEMENT.md) - Module SQL analysis (AZEROTHCORE_MODULE_SQL_ANALYSIS.md) - Implementation mapping (IMPLEMENTATION_MAP.md) - SQL staging comparison and path coverage - Module assets and DBC file requirements - Update SCRIPTS.md, ADVANCED.md, and troubleshooting documentation - Update references from database-import/ to import/ directory ## Breaking Changes - Renamed database-import/ directory to import/ for clarity - Module SQL files now staged to AzerothCore-compatible paths - db-guard container now required for proper database lifecycle management ## Bug Fixes - Fix module SQL staging directory structure for AzerothCore compatibility - Handle rsync exit code 23 gracefully during deployments - Prevent backup from running immediately on container startup - Correct SQL staging paths for proper module installation
This commit is contained in:
@@ -45,10 +45,33 @@ DEFAULT_MOUNT_STORAGE_PATH=/mnt/azerothcore-data
|
||||
# =====================
|
||||
CONTAINER_DB_IMPORT=ac-db-import
|
||||
CONTAINER_DB_INIT=ac-db-init
|
||||
CONTAINER_DB_GUARD=ac-db-guard
|
||||
CONTAINER_BACKUP=ac-backup
|
||||
CONTAINER_MODULES=ac-modules
|
||||
CONTAINER_POST_INSTALL=ac-post-install
|
||||
|
||||
# =====================
|
||||
# Database Guard Defaults
|
||||
# =====================
|
||||
DB_GUARD_RECHECK_SECONDS=120
|
||||
DB_GUARD_RETRY_SECONDS=10
|
||||
DB_GUARD_WAIT_ATTEMPTS=60
|
||||
DB_GUARD_HEALTH_MAX_AGE=180
|
||||
DB_GUARD_HEALTHCHECK_INTERVAL=30s
|
||||
DB_GUARD_HEALTHCHECK_TIMEOUT=10s
|
||||
DB_GUARD_HEALTHCHECK_RETRIES=5
|
||||
DB_GUARD_VERIFY_INTERVAL_SECONDS=86400
|
||||
|
||||
# =====================
|
||||
# Module SQL staging
|
||||
# =====================
|
||||
MODULE_SQL_STAGE_PATH=${STORAGE_PATH_LOCAL}/module-sql-updates
|
||||
|
||||
# =====================
|
||||
# SQL Source Overlay
|
||||
# =====================
|
||||
AC_SQL_SOURCE_PATH=${STORAGE_PATH_LOCAL}/source/azerothcore-playerbots/data/sql
|
||||
|
||||
# =====================
|
||||
# Images
|
||||
# =====================
|
||||
@@ -129,6 +152,28 @@ DB_AUTH_NAME=acore_auth
|
||||
DB_WORLD_NAME=acore_world
|
||||
DB_CHARACTERS_NAME=acore_characters
|
||||
DB_PLAYERBOTS_NAME=acore_playerbots
|
||||
|
||||
# =====================
|
||||
# Database Import Settings
|
||||
# =====================
|
||||
# Database reconnection settings
|
||||
DB_RECONNECT_SECONDS=5
|
||||
DB_RECONNECT_ATTEMPTS=5
|
||||
|
||||
# Update settings
|
||||
DB_UPDATES_ALLOWED_MODULES=all
|
||||
DB_UPDATES_REDUNDANCY=1
|
||||
|
||||
# Database worker thread settings
|
||||
DB_LOGIN_WORKER_THREADS=1
|
||||
DB_WORLD_WORKER_THREADS=1
|
||||
DB_CHARACTER_WORKER_THREADS=1
|
||||
|
||||
# Database synchronous thread settings
|
||||
DB_LOGIN_SYNCH_THREADS=1
|
||||
DB_WORLD_SYNCH_THREADS=1
|
||||
DB_CHARACTER_SYNCH_THREADS=1
|
||||
|
||||
# =====================
|
||||
# Backups
|
||||
# =====================
|
||||
@@ -160,7 +205,9 @@ MODULES_REQUIRES_PLAYERBOT_SOURCE=0
|
||||
# =====================
|
||||
# Client Data Settings
|
||||
# =====================
|
||||
# This is automatically applied, fyi version must match tag exactly
|
||||
# Client data version is auto-detected from source when left blank (recommended)
|
||||
# Only set this if you need to override the auto-detected version
|
||||
# Example: v18.0, v17.0, etc.
|
||||
CLIENT_DATA_VERSION=
|
||||
|
||||
# =====================
|
||||
|
||||
Reference in New Issue
Block a user