Merge pull request #25 from TheRefraction/config-migration

Migration Configuration and Scripts

Author: TheRefraction

.env.example

@@ -1,5 +1,13 @@
+# MySQL .env variables
+# Credentials to establish a connection to a given DB
 MYSQL_HOST=mysql
+MYSQL_PORT=3306
 MYSQL_DATABASE=efes_db
 MYSQL_USER=
 MYSQL_PASSWORD=
-MYSQL_ROOT_PASSWORD=
+MYSQL_ROOT_PASSWORD=
+
+# Docker ports
+DOCKER_PORT_MYSQL=3306
+DOCKER_PORT_PHP=8080
+DOCKER_PORT_PMA=8081

db/init/01_schema.sql

@@ -5,31 +5,55 @@ services:
     env_file:
       - .env
     ports:
-      - "3306:3306"
+      - "${DOCKER_PORT_MYSQL:-3306}:3306"
     volumes:
       - mysql_data:/var/lib/mysql
-      - ./db/init:/docker-entrypoint-initdb.d
+      #- ./db/init:/docker-entrypoint-initdb.d
+    healthcheck:
+      test: [ "CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}" ]
+      timeout: 20s
+      retries: 10
+      interval: 5s
+      start_period: 30s
 
   php:
     build: ./php
     restart: always
     ports:
-      - "8080:80"
+      - "${DOCKER_PORT_PHP:-8080}:80"
     volumes:
       - ./src:/var/www/html
     env_file:
       - .env
     depends_on:
-      - mysql
+      mysql:
+        condition: service_healthy
 
   phpmyadmin:
     image: phpmyadmin/phpmyadmin
     restart: always
     ports:
-      - "8081:80"
+      - "${DOCKER_PORT_PMA:-8081}:80"
     environment:
       PMA_HOST: mysql
       MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+    depends_on:
+      mysql:
+        condition: service_healthy
+
+  flyway:
+    image: flyway/flyway:latest
+    restart: no
+    environment:
+      FLYWAY_URL: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}?allowPublicKeyRetrieval=true&useSSL=false
+      FLYWAY_USER: ${MYSQL_USER}
+      FLYWAY_PASSWORD: ${MYSQL_PASSWORD}
+    command: migrate
+    volumes:
+      - ./db/migrations:/flyway/sql
+    depends_on:
+      mysql:
+        condition: service_healthy
 
 volumes:
-  mysql_data:
+  mysql_data:

db/init/02_triggers.sql

@@ -0,0 +1,135 @@
+# manage.ps1
+
+[CmdletBinding(DefaultParameterSetName='Action')]
+param(
+    [Parameter(Mandatory=$false, Position=0, ParameterSetName='Action')]
+    [ValidateSet('start','stop','destroy','build','force-build','backup','migrate')]
+    [string]$Action,
+
+    [Parameter(Mandatory=$false, ParameterSetName='Help')]
+    [switch]$Help
+)
+
+function Write-Color($color, $message) {
+    Write-Host $message -ForegroundColor $color
+}
+
+function Show-Help {
+    $helpText = @"
+Use: .\manage.ps1 [-Action] <action> [-Help]
+
+Available actions:
+    start         Start all services
+    stop          Stop all services
+    destroy       Delete services and volumes (data loss!)
+    build         Build services images
+    force-build   Build services images without using the cache
+    backup        Back the database up in a .sql file
+    migrate       Migrate the current database to a newer schema version
+
+Options:
+    -Help         Displays some help
+
+Examples:
+    .\manage.ps1 start
+    .\manage.ps1 backup
+    .\manage.ps1 -Action migrate
+"@
+    Write-Host $helpText
+}
+
+# Help or no action specified
+if ($Help -or [string]::IsNullOrEmpty($Action)) {
+    Show-Help
+    exit 0
+}
+
+function Test-DockerRunning {
+    try {
+        $output = docker info 2>&1
+        if ($LASTEXITCODE -eq 0) {
+            return $true
+        } else {
+            Write-Color Red "Docker cannot be accessed. Please ensure Docker Desktop has been started beforehand."
+            return $false
+        }
+    }
+    catch {
+        Write-Color Red "Could not run 'docker info' : $_"
+        return $false
+    }
+}
+
+# Check if Docker is running
+if (-not (Test-DockerRunning)) {
+    exit 1
+}
+
+# Load environment variables from .env
+if (Test-Path .env) {
+    Get-Content .env | ForEach-Object {
+        if ($_ -match '^([^#][^=]+)=(.*)$') {
+            [Environment]::SetEnvironmentVariable($matches[1], $matches[2], 'Process')
+        }
+    }
+} else {
+    Write-Color Red "Environment file .env has not been found!"
+    exit 1
+}
+
+switch ($Action) {
+    'start' {
+        Write-Color Green "Starting containers..."
+        docker-compose up -d
+    }
+    'stop' {
+        Write-Color Green "Stopping containers..."
+        docker-compose down
+    }
+    'destroy' {
+        Write-Color Red "Deletion of containers and volumes (all data will be lost!)"
+        $confirmation = Read-Host "Proceed? (y/N)"
+        if ($confirmation -eq 'y' -or $confirmation -eq 'Y') {
+            docker-compose down -v
+        } else {
+            Write-Host "Operation cancelled."
+        }
+    }
+    'build' {
+        Write-Color Green "Building services..."
+        docker-compose build
+    }
+    'force-build' {
+        Write-Color Green "Building services (no cache)..."
+        docker-compose build --no-cache
+    }
+    'backup' {
+        Write-Color Green "Database backup in progress..."
+
+	$backupDir = "db\backups"
+	if (-not (Test-Path $backupDir)) {
+	    New-Item -ItemType Directory -Path $backupDir -Force | Out-Null
+	}
+
+        $backupFile = "$backupDir\backup_$(Get-Date -Format 'yyyyMMdd_HHmmss').sql"
+        $mysqlContainer = docker-compose ps -q mysql
+        if (-not $mysqlContainer) {
+            Write-Color Red "MySQL service has not been found. Please ensure it has been started beforehand."
+            exit 1
+        }
+        docker exec $mysqlContainer mysqldump -u root -p"${env:MYSQL_ROOT_PASSWORD}" efes_db > $backupFile
+        if ($LASTEXITCODE -eq 0) {
+            Write-Color Green "Backup has been successful: $backupFile"
+        } else {
+            Write-Color Red "An error occurred!"
+        }
+    }
+    'migrate' {
+        Write-Color Green "Migrations are being applied..."
+        docker-compose run --rm flyway
+    }
+    default {
+        Write-Color Red "Unknown argument. Please use -Help for more info."
+        exit 1
+    }
+}