Update .gitlab-ci.yml file

.gitlab-ci.yml

+# This GitLab CI/CD pipeline is designed to run the complete Moodle
+# automation script in a single, manually triggered job.
+
+# Use the official Docker image to enable Docker-in-Docker (dind).
+# This allows us to run docker-compose inside the CI job.
 image: docker:20.10.16
 
 services:
   - name: docker:20.10.16-dind
-    alias: docker
+    alias: docker # This alias is important for the runner to find the Docker daemon.
 
 stages:
-  - full_test
+  - full_test # A single stage for our end-to-end test.
 
 variables:
+  # This tells docker-compose how to connect to the Docker-in-Docker service.
   DOCKER_HOST: tcp://docker:2375
+  # This disables TLS, which is often required for dind inside GitLab CI.
   DOCKER_TLS_CERTDIR: ""
+  # Provides default values for the variables in your docker-compose.yml.
   EUSER: "1000"
   EGID: "1000"
-  MOODLE_URL: "http://docker:8080"
-  BACKEND_URL: "http://docker:8081"
+  # This is the URL Moodle's entrypoint script will use for its wwwroot.
+  MOODLE_WWWROOT: "http://docker:8080"
 
 run_full_automation:
   stage: full_test
+  # 'when: manual' means this job will ONLY run when you click the
+  # "play" button for it in the GitLab CI/CD > Pipelines view.
   when: manual
+
   before_script:
+    # Install the necessary tools inside the Docker runner.
     - apk add --no-cache curl docker-compose bash jq
-    - until docker info > /dev/null 2>&1; do echo "Waiting for Docker..."; sleep 3; done
+    # A simple loop to wait until the Docker daemon is ready.
+    - until docker info > /dev/null 2>&1; do echo "Waiting for Docker daemon..."; sleep 3; done
+
   script:
+    # 1. Start all the services defined in your docker-compose.yml file.
+    # The '-d' runs them in the background.
     - echo "Starting Docker environment..."
     - docker-compose up -d
-    - echo "Waiting for Moodle..."
+
+    # 2. Wait for the Moodle container to fully initialize and run its entrypoint script.
+    # This is a simple but effective way to wait for the installation to finish.
+    - echo "Waiting 2 minutes for Moodle to install and start..."
     - sleep 120
+
+    # 3. Make your main script executable.
+    # !!! IMPORTANT: Replace 'your_main_script.sh' with the actual filename. !!!
     - chmod +x test-moodle.sh
+
+    # 4. Run the entire script from top to bottom.
+    - echo "Executing the main automation script..."
     - ./test-moodle.sh
+
   after_script:
+    # It's good practice to clean up the environment after the test.
+    # The '-v' flag removes the volumes, ensuring the next run is completely clean.
     - echo "Tearing down Docker environment..."
     - docker-compose down -v
\ No newline at end of file