From 54ba69726609375dce62acaf8d87e12177f32d39 Mon Sep 17 00:00:00 2001
From: Daniel Speicher <daniel.speicher@lakedrops.com>
Date: Tue, 23 Jul 2024 13:21:02 +0200
Subject: [PATCH] Document stages and jobs.

---
 docs/gitlab/drupal/index.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/docs/gitlab/drupal/index.md b/docs/gitlab/drupal/index.md
index 33c8a90..5a18cc5 100644
--- a/docs/gitlab/drupal/index.md
+++ b/docs/gitlab/drupal/index.md
@@ -175,7 +175,7 @@ that we setup our own `LakeDrops` tools by `composer lakedrops:scaffold` and
 `composer lakedrops:docker4drupal`.
 
 The next step is to pull all required [Docker](https://www.docker.com/) images 
-with [Docker Compose](https://docs.docker.com/compose/) adn start the services.
+with [Docker Compose](https://docs.docker.com/compose/) and start the services.
 
 After everything has started, we create some directories, e.g. for styles, logs and JavaScript.
 
@@ -371,6 +371,34 @@ The following jobs must run before successfully:
 - [Build Prod Site NG](#build-prod-site-ng)
 - [Build Theme](#build-theme)
 
+First we have to do some preparation. This is done in the `before_script` section.
+
+- [.prepareaccess](#prepareaccess)
+
+This job does not use [Ansible](https://www.ansible.com/). A lot of commands are executed in the script section.
+Here is a summary:
+
+- create the directories, where the site gets deployed to:
+    - app
+    - db
+    - files
+    - redis
+    - backup
+- sets the ownership and permissions of these files
+- start all the docker service with [Docker Compose](https://docs.docker.com/compose/)
+- execute several `drush` commands
+- create config auto export directory
+- restart cron jobs
+
+To see all the commands, visit
+[test_deploy.yml](https://gitlab.lakedrops.com/gitlab-ci-cd/drupal/-/blob/main/test-and-deploy.yml?ref_type=heads).
+
+Rules, when the job must not run:
+
+- `$DISABLE_DEPLOYMENT` != "0"
+- `$CI_COMMIT_BRANCH` != "main" && `$ENFORCE_DEPLOYMENT` != "1"
+
+
 ### Internal Stages
 
 Here we have some internal stages, which cannot be executed alone. The purpose is to
-- 
GitLab