feat: add stage deployment configuration and update README with staging details

README.md

@@ -87,6 +87,18 @@ Includes:
 - `deploy/deploy-prod.yaml`
 - `deploy/deploy-prod-rollback.yaml`
 
+### Stage Deployment
+
+Deployment to staging environment.
+
+The deployment uses [deployer](https://deployer.org/) and [deployer-tools](https://github.com/move-elevator/deployer-tools) as deployment base.
+
+Includes:
+- `deploy/deploy-stage.yaml`
+
+> [!NOTE]
+> Use this template if the project wants a simple stage deployment and doesn't need an advanced feature branch deployment. 
+
 ### Release
 
 Create a GitLab release with release notes.

deploy/deploy-stage.yaml

@@ -0,0 +1,25 @@
+# Purpose:
+#   Deploy an application on the stage system
+#
+deploy:stage:
+  extends:
+    - .ssh
+  needs:
+    - build:php
+    - build:node
+  stage: deploy
+  variables:
+    SSH_USER: ${SSH_USER_STAGE}
+    SSH_HOST: ${SSH_HOST_STAGE}
+    STAGE_TARGET_BRANCH: main
+  script:
+    - vendor/bin/dep deploy stage $DEPLOYER_CONFIG_ADDITIONAL_OPTION
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "schedule"
+      when: never
+    - if: $CI_PIPELINE_SOURCE == "pipeline"
+      when: never
+    - if: $CI_COMMIT_REF_NAME == $STAGE_TARGET_BRANCH
+      when: always
+    - when: never
+  allow_failure: false