feat(deployment): update semaphore configuration and deployment workflows

deployment/ansible/playbooks/deploy-update.yml

@@ -50,16 +50,21 @@
         group: "{{ ansible_user }}"
         mode: '0755'
 
+    - name: Determine application environment
+      set_fact:
+        application_environment: "{{ APP_ENV | default('production') }}"
+        application_compose_suffix: "{{ 'staging.yml' if application_environment == 'staging' else 'production.yml' }}"
+
     - name: Check if docker-compose.base.yml exists in application stack
       stat:
         path: "{{ app_stack_path }}/docker-compose.base.yml"
       register: compose_base_exists
       when: not (application_sync_files | default(false) | bool)
 
-    - name: Check if docker-compose.production.yml exists in application stack
+    - name: Check if docker-compose override file exists in application stack (production or staging)
       stat:
-        path: "{{ app_stack_path }}/docker-compose.production.yml"
-      register: compose_prod_exists
+        path: "{{ app_stack_path }}/docker-compose.{{ application_compose_suffix }}"
+      register: compose_override_exists
       when: not (application_sync_files | default(false) | bool)
 
     - name: Fail if docker-compose files don't exist
@@ -69,7 +74,7 @@
           
           Required files:
           - docker-compose.base.yml
-          - docker-compose.production.yml
+          - docker-compose.{{ application_compose_suffix }}
           
           The Application Stack must be deployed first via:
           ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
@@ -77,7 +82,7 @@
           This will create the application stack with docker-compose files and .env file.
       when:
         - not (application_sync_files | default(false) | bool)
-        - (not compose_base_exists.stat.exists or not compose_prod_exists.stat.exists)
+        - (not compose_base_exists.stat.exists or not compose_override_exists.stat.exists)
 
     - name: Create backup directory
       file:
@@ -94,10 +99,10 @@
       register: compose_base_check
       when: not (application_sync_files | default(false) | bool)
       
-    - name: Verify docker-compose.production.yml exists
+    - name: Verify docker-compose override file exists (production or staging)
       stat:
-        path: "{{ app_stack_path }}/docker-compose.production.yml"
-      register: compose_prod_check
+        path: "{{ app_stack_path }}/docker-compose.{{ application_compose_suffix }}"
+      register: compose_override_check
       when: not (application_sync_files | default(false) | bool)
 
     - name: Fail if docker-compose files don't exist
@@ -107,7 +112,7 @@
           
           Required files:
           - docker-compose.base.yml
-          - docker-compose.production.yml
+          - docker-compose.{{ application_compose_suffix }}
           
           The Application Stack must be deployed first via:
           ansible-playbook -i inventory/production.yml playbooks/setup-infrastructure.yml
@@ -115,12 +120,12 @@
           This will create the application stack with docker-compose files and .env file.
       when:
         - not (application_sync_files | default(false) | bool)
-        - (not compose_base_check.stat.exists or not compose_prod_check.stat.exists)
+        - (not compose_base_check.stat.exists or not compose_override_check.stat.exists)
 
     - name: Backup current deployment metadata
       shell: |
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.production.yml ps --format json 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/current_containers.json || true
-        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.production.yml config 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/docker-compose-config.yml || true
+        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.{{ application_compose_suffix }} ps --format json 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/current_containers.json || true
+        docker compose -f {{ app_stack_path }}/docker-compose.base.yml -f {{ app_stack_path }}/docker-compose.{{ application_compose_suffix }} config 2>/dev/null > {{ backups_path }}/{{ deployment_timestamp | regex_replace(':', '-') }}/docker-compose-config.yml || true
       args:
         executable: /bin/bash
       changed_when: false
@@ -128,7 +133,7 @@
       when: 
         - not (application_sync_files | default(false) | bool)
         - compose_base_exists.stat.exists | default(false)
-        - compose_prod_exists.stat.exists | default(false)
+        - compose_override_exists.stat.exists | default(false)
 
     - name: Login to Docker registry (if credentials provided)
       community.docker.docker_login:
@@ -167,9 +172,9 @@
         application_remove_orphans: false
       when: application_sync_files | default(false) | bool
 
-    - name: Update docker-compose.production.yml with new image tag (all services)
+    - name: Update docker-compose override file with new image tag (all services)
       replace:
-        path: "{{ app_stack_path }}/docker-compose.production.yml"
+        path: "{{ app_stack_path }}/docker-compose.{{ application_compose_suffix }}"
         # Match both localhost:5000 and registry.michaelschiemer.de (or any registry URL)
         regexp: '^(\s+image:\s+)(localhost:5000|registry\.michaelschiemer\.de|{{ docker_registry }})/{{ app_name }}:.*$'
         replace: '\1{{ app_image }}:{{ image_tag }}'

deployment/ansible/roles/application/defaults/main.yml

@@ -34,3 +34,13 @@ application_wait_interval: 5
 
 # Command executed inside the app container to run migrations
 application_migration_command: "php console.php db:migrate"
+
+# Environment (production, staging, local)
+# Determines which compose files to use and service names
+application_environment: "{{ APP_ENV | default('production') }}"
+
+# Compose file suffix based on environment
+application_compose_suffix: "{{ 'staging.yml' if application_environment == 'staging' else 'production.yml' }}"
+
+# Service names based on environment
+application_service_name: "{{ 'staging-app' if application_environment == 'staging' else 'php' }}"

deployment/ansible/roles/application/tasks/deploy.yml

@@ -10,7 +10,7 @@
 
 - name: Wait for application container to report Up
   shell: |
-    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.production.yml ps php | grep -Eiq "Up|running"
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} ps {{ application_service_name }} | grep -Eiq "Up|running"
   register: application_app_running
   changed_when: false
   until: application_app_running.rc == 0
@@ -20,7 +20,7 @@
 
 - name: Ensure app container is running before migrations
   shell: |
-    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.production.yml ps php | grep -Eiq "Up|running"
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} ps {{ application_service_name }} | grep -Eiq "Up|running"
   args:
     executable: /bin/bash
   register: application_app_container_running
@@ -30,7 +30,7 @@
 
 - name: Run database migrations
   shell: |
-    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.production.yml exec -T php {{ application_migration_command }}
+    docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} exec -T {{ application_service_name }} {{ application_migration_command }}
   args:
     executable: /bin/bash
   register: application_migration_result
@@ -43,7 +43,7 @@
     - application_app_container_running.rc == 0
 
 - name: Collect application container status
-  shell: docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.production.yml ps
+  shell: docker compose -f {{ application_stack_dest }}/docker-compose.base.yml -f {{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }} ps
   register: application_ps
   changed_when: false
   ignore_errors: yes

deployment/ansible/roles/application/tasks/sync.yml

@@ -80,11 +80,11 @@
   register: application_compose_base_src
   become: no
 
-- name: Check if application docker-compose.production.yml source exists locally
+- name: Check if application docker-compose override file exists locally (production or staging)
   stat:
-    path: "{{ application_stack_src }}/../../../docker-compose.production.yml"
+    path: "{{ application_stack_src }}/../../../docker-compose.{{ application_compose_suffix }}"
   delegate_to: localhost
-  register: application_compose_prod_src
+  register: application_compose_override_src
   become: no
 
 - name: Copy application docker-compose.base.yml to target host
@@ -96,14 +96,14 @@
     mode: '0644'
   when: application_compose_base_src.stat.exists
 
-- name: Copy application docker-compose.production.yml to target host
+- name: Copy application docker-compose override file to target host (production or staging)
   copy:
-    src: "{{ application_stack_src }}/../../../docker-compose.production.yml"
-    dest: "{{ application_stack_dest }}/docker-compose.production.yml"
+    src: "{{ application_stack_src }}/../../../docker-compose.{{ application_compose_suffix }}"
+    dest: "{{ application_stack_dest }}/docker-compose.{{ application_compose_suffix }}"
     owner: "{{ ansible_user }}"
     group: "{{ ansible_user }}"
     mode: '0644'
-  when: application_compose_prod_src.stat.exists
+  when: application_compose_override_src.stat.exists
 
 - name: Check if legacy docker-compose.yml exists (fallback)
   stat: