gitlab-projects-settings 5.3.0__tar.gz → 5.4.0__tar.gz

{gitlab_projects_settings-5.3.0 → gitlab_projects_settings-5.4.0}/.cz.yaml

@@ -133,18 +133,18 @@ commitizen:
       - type: input
         name: scope
         message: 'Scope of the change :'
-        filter: 'lambda text: commitizen.cz.utils.required_validator(text, msg="! Error: Scope is required")'
+        filter: 'required_validator_scope'
         default: ''
       - type: input
         name: subject
         message: 'Title of the commit (starting in lower case and without period) :'
-        filter: 'lambda text: commitizen.cz.utils.required_validator(text.strip(".").strip(), msg="! Error: Title is required")'
+        filter: 'required_validator_title_strip'
         default: ''
       - type: input
         name: body
         message: 'Additional contextual message (Empty to skip) :'
         default: 'Issue: #...'
-        filter: 'commitizen.cz.utils.multiple_line_breaker'
+        filter: 'multiple_line_breaker'
       - type: input
         name: footer
         message: 'Footer information and references (Empty to skip) :'

gitlab_projects_settings-5.4.0/.gitignore

@@ -0,0 +1,30 @@
+# Build intermediates
+/build
+
+# Compiled intermediates
+*.pyc
+__pycache__/
+
+# Coverage intermediates
+coverage-reports/
+
+# Distribution intermediates
+.eggs/
+*.egg-info/
+dist/
+
+# Documentation intermediates
+/docs/.serve.pid
+/docs/about
+/docs/assets/stylesheets/variables.scss
+/docs/index.md
+/public
+
+# SonarQube intermediates
+.scannerwork/
+.sonar/
+
+# Temporary intermediates
+.*.swp
+.tmp/
+.tmp.*

{gitlab_projects_settings-5.3.0 → gitlab_projects_settings-5.4.0}/.gitlab-ci.yml

@@ -1,10 +1,11 @@
 include:
-  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@2.0.0
+  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@3.0.0
     inputs:
       stage: prepare
 
 stages:
   - development
+  - registry
   - prepare
   - build
   - test
@@ -19,7 +20,10 @@ variables:
 .local:
   engine: docker,auto
   real_paths: true
-  version: 9.0
+  sockets: true
+  version: 11.0
+  volumes:
+    - ${HOME}/.docker/config.json:/root/.docker/config.json:ro
 
 # =============================================================================
 # Stage: development
@@ -48,22 +52,22 @@ changelog:
     - |
       echo -n " > Current commit : "
       git describe --always
-      echo ''
+      echo ' '
       if [ ! -z "${RELEASE_TAG:-}" ]; then
         tag="${RELEASE_TAG}"
       else
         read -p " > Release tag : " -r tag
       fi
-      echo ''
+      echo ' '
     # Generate changelog
     - |
       git tag -f -m "${tag}" "${tag}"
       ./.tmp/git-cliff --no-exec --config ./config/cliff.toml --output ./CHANGELOG.md
       sed -i "s#raw/[^/]*/docs#raw/${tag}/docs#g" ./README.md
       git add -v ./CHANGELOG.md ./README.md
-      echo ''
+      echo ' '
       git commit -m "docs(changelog): regenerate release tag changes history" -s
-      echo ''
+      echo ' '
     # Create release tag
     - git tag -f -m "${tag}" "${tag}"
   rules:
@@ -76,9 +80,9 @@ hooks:
     # Refresh configurations
     - pre-commit-crocodile --configure
     # Stash local changes
-    - echo ''
+    - echo ' '
     - echo ' [INFO] Use "s" to split hunks and "y" to remove changes you do not want, "n" otherwise'
-    - echo ''
+    - echo ' '
     - sleep 2
     - git stash -p
     # Stage changes
@@ -92,72 +96,277 @@ hooks:
   rules:
     - if: $CI_LOCAL
 
-images:
-  stage: development
-  image: local:silent
+# =============================================================================
+# Stage: registry
+
+.registry:
+  image: docker:27-cli
+  services:
+    - docker:dind
+  before_script:
+    # Configure registry
+    - |
+      if [ ! -z "${CI_REGISTRY}" ]; then
+        docker login -u gitlab-ci-token -p "${CI_JOB_TOKEN}" "${CI_REGISTRY}"
+      fi
+  script:
+    # Prepare container image
+    - export base="${REGISTRY_HOST:?}/${REGISTRY_NAMESPACE:?}/${REGISTRY_PROJECT:?}/${BASEIMAGE_NAME}"
+    - export image="${REGISTRY_HOST:?}/${REGISTRY_NAMESPACE:?}/${REGISTRY_PROJECT:?}/${REGISTRY_PROJECT:?}:${CONTAINER_IMAGE_TAG:?}"
+    # Detect local image
+    - |
+      base_local='false'
+      image_local='false'
+      if docker images -q "${base}" 2>/dev/null | grep -q '.'; then
+        base_local='true'
+      fi
+      if docker images -q "${image}" 2>/dev/null | grep -q '.'; then
+        image_local='true'
+      fi
+    # Pull images
+    - |
+      echo ' '
+      echo " [INFO] Pull: ${image}"
+      echo ' '
+      docker pull "${base}" || true
+      docker pull "${image}" || true
+    # Build image
+    - |
+      docker buildx build \
+          --build-arg "IMAGE_BASE=${base}" \
+          --build-context 'requirements=./requirements' \
+          --cache-from "${image}" \
+          --pull \
+          --tag "${image}" \
+          "./containers/${CONTAINER_FOLDER}/"
+    # Cleanup intermediates
+    - docker system prune --force
+    # Show images
+    - docker images
+    # Push image
+    - |
+      if [ ! -z "${CI_COMMIT_TAG}" ] || [ "${CI_COMMIT_REF_NAME}" = "${CI_DEFAULT_BRANCH:-undefined}" ] || [ "${PUSH_IMAGES:-false}" = 'true' ]; then
+        echo ' '
+        echo " [INFO] Push: ${image}"
+        echo ' '
+        docker push "${image}"
+      fi
+    # Cleanup images
+    - |
+      if [ ! -z "${CI_LOCAL:-}" ] && [ "${base_local}" = 'false' ]; then
+        docker rmi "${base}" >/dev/null || true
+      fi
+      if [ ! -z "${CI_LOCAL:-}" ] && [ "${image_local}" = 'false' ]; then
+        docker rmi "${image}" >/dev/null || true
+      fi
+  after_script:
+    # Cleanup intermediates
+    - docker system prune --force
+  variables:
+    DOCKER_DRIVER: overlay2
+
+registry:rehost:
+  stage: registry
+  extends:
+    - .registry
+  needs: []
   script:
     # Rehost standard images
     - |
-      for base_rename in \
-          'python:3.8' \
-          'python:3.12' \
-          'python:3.12-alpine' \
-          'sonarsource/sonar-scanner-cli:latest' \
-          'tobix/pywine:3.10' \
-      ; do
-        base=$(echo "${base_rename}" | cut -d'|' -f1 | tr -d ' ')
-        rename=$(echo "${base_rename}" | cut -d'|' -f2 | tr -d ' ')
+      set +x
+      for base_rename in $(cat ./containers/rehost/images.txt); do
+        base=$(echo "${base_rename}" | cut -d'|' -f1)
+        rename=$(echo "${base_rename}" | cut -d'|' -f2)
         image="${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${rename:-${base}}"
         if [ -z "${IMAGE}" ] || echo "${image}" | grep -q "${IMAGE}"; then
-          echo ''
+          base_local='false'
+          image_local='false'
+          if docker images -q "${base}" 2>/dev/null | grep -q '.'; then
+            base_local='true'
+          fi
+          if docker images -q "${image}" 2>/dev/null | grep -q '.'; then
+            image_local='true'
+          fi
+          echo ' '
           echo " [INFO] Pull: ${base}"
-          echo ''
+          echo ' '
           docker pull "${base}" || true
           docker tag "${base}" "${image}"
-          echo ''
+          echo ' '
           echo " [INFO] Push: ${image}"
-          echo ''
-          docker push "${image}" || true
-          docker rmi "${base}" >/dev/null || true
-        fi
-      done
-    # Prepare project images
-    - |
-      for name_base_container in \
-          'build                 | python:3.12-alpine | build' \
-          'codestyle             | python:3.12-alpine | codestyle' \
-          'deploy                | python:3.12-alpine | deploy' \
-          'test-coverage-linux   | python:3.12        | test-coverage-linux' \
-          'test-coverage-windows | tobix/pywine:3.10  | test-coverage-windows' \
-          'test-oldest           | python:3.8         | test-linux' \
-          'test-latest           | python:3.12        | test-linux' \
-      ; do
-        name=$(echo "${name_base_container}" | cut -d'|' -f1 | tr -d ' ')
-        base=$(echo "${name_base_container}" | cut -d'|' -f2 | tr -d ' ')
-        container=$(echo "${name_base_container}" | cut -d'|' -f3 | tr -d ' ')
-        base="${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${base}"
-        image="${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${REGISTRY_PROJECT}/${REGISTRY_PROJECT}:${name}"
-        if [ -z "${IMAGE}" ] || echo "${image}" | grep -q "${IMAGE}"; then
-          echo ''
-          echo " [INFO] Pull: ${image}"
-          echo ''
-          docker pull "${base}" || true
-          docker pull "${image}" || true
-          docker build \
-              --build-arg "IMAGE_BASE=${base}" \
-              --build-context 'requirements=./requirements' \
-              --cache-from "${image}" \
-              --pull \
-              --tag "${image}" \
-              "./containers/${container}/"
-          echo ''
-          echo " [INFO] Push: ${image}"
-          echo ''
+          echo ' '
           docker push "${image}" || true
+          if [ ! -z "${CI_LOCAL:-}" ] && [ "${base_local}" = 'false' ]; then
+            docker rmi "${base}" >/dev/null || true
+          fi
+          if [ ! -z "${CI_LOCAL:-}" ] && [ "${image_local}" = 'false' ]; then
+            docker rmi "${image}" >/dev/null || true
+          fi
         fi
       done
   rules:
-    - if: $CI_LOCAL
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/rehost/images.txt
+
+registry:build:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.12-alpine'
+    CONTAINER_FOLDER: build
+    CONTAINER_IMAGE_TAG: build
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/build/Dockerfile
+        - containers/rehost/images.txt
+        - requirements/build.txt
+        - requirements/runtime.txt
+
+registry:codestyle:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.12-alpine'
+    CONTAINER_FOLDER: codestyle
+    CONTAINER_IMAGE_TAG: codestyle
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/codestyle/Dockerfile
+        - containers/rehost/images.txt
+        - requirements/quality.txt
+        - requirements/runtime.txt
+        - requirements/tests.txt
+
+registry:deploy:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.12-alpine'
+    CONTAINER_FOLDER: deploy
+    CONTAINER_IMAGE_TAG: deploy
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/deploy/Dockerfile
+        - containers/rehost/images.txt
+        - requirements/deploy.txt
+
+registry:pages:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.12-slim'
+    CONTAINER_FOLDER: pages
+    CONTAINER_IMAGE_TAG: pages
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/pages/Dockerfile
+        - containers/rehost/images.txt
+        - requirements/pages.txt
+
+registry:test-coverage-linux:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.12'
+    CONTAINER_FOLDER: test-coverage-linux
+    CONTAINER_IMAGE_TAG: test-coverage-linux
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/rehost/images.txt
+        - containers/test-coverage-linux/Dockerfile
+        - requirements/coverage.txt
+        - requirements/runtime.txt
+        - requirements/tests.txt
+
+registry:test-coverage-windows:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'tobix/pywine:3.10'
+    CONTAINER_FOLDER: test-coverage-windows
+    CONTAINER_IMAGE_TAG: test-coverage-windows
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/rehost/images.txt
+        - containers/test-coverage-windows/Dockerfile
+        - requirements/coverage.txt
+        - requirements/runtime.txt
+        - requirements/tests.txt
+
+registry:test-oldest:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.8'
+    CONTAINER_FOLDER: test-linux
+    CONTAINER_IMAGE_TAG: test-oldest
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/rehost/images.txt
+        - containers/test-linux/Dockerfile
+        - requirements/tests.txt
+
+registry:test-latest:
+  stage: registry
+  extends:
+    - .registry
+  needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
+  variables:
+    BASEIMAGE_NAME: 'python:3.12'
+    CONTAINER_FOLDER: test-linux
+    CONTAINER_IMAGE_TAG: test-latest
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+      changes:
+        - containers/rehost/images.txt
+        - containers/test-linux/Dockerfile
+        - requirements/tests.txt
 
 # =============================================================================
 # Stage: prepare
@@ -165,11 +374,17 @@ images:
 codestyle:
   stage: prepare
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:codestyle
-  needs: []
+  needs:
+    - job: registry:codestyle
+      artifacts: false
+      optional: true
   script:
     - yapf -i ./src/*.py ./src/*/*.py ./setup.py
-    - echo '' && git diff --name-status
-    - git diff --quiet
+    - echo ' ' && git diff --name-status
+    - |
+      if [ -z "${CI_LOCAL:-}" ] || [ ! -z "${PRE_COMMIT}" ]; then
+        git diff --quiet
+      fi
   rules:
     - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
       changes:
@@ -183,7 +398,10 @@ codestyle:
 lint:
   stage: prepare
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:codestyle
-  needs: []
+  needs:
+    - job: registry:codestyle
+      artifacts: false
+      optional: true
   script:
     - pylint --errors-only ./src/ ./setup.py
     - pylint --disable=missing-docstring --load-plugins=pylint.extensions.no_self_use ./src/ ./setup.py
@@ -200,7 +418,10 @@ lint:
 typings:
   stage: prepare
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:codestyle
-  needs: []
+  needs:
+    - job: registry:codestyle
+      artifacts: false
+      optional: true
   variables:
     MYPY_CACHE_DIR: /dev/null
     MYPY_FORCE_COLOR: 1
@@ -230,6 +451,9 @@ build:
   stage: build
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:build
   needs:
+    - job: registry:build
+      artifacts: false
+      optional: true
     - job: codestyle
       artifacts: false
       optional: true
@@ -306,7 +530,7 @@ readme:
         }; /${tail}/p; d }"  ./README.md | head -n 100
     - rm -f ./.tmp/README.help.tmp
     - |
-      git -c color.diff=always --no-pager diff ./README.md | grep --color=never '.' && echo ''
+      git -c color.diff=always --no-pager diff ./README.md | grep --color=never '.' && echo ' '
       echo  ' > README: Updated successfully'
       git diff --quiet ./README.md
   rules:
@@ -348,16 +572,16 @@ readme:
   script:
     # Prepare tests
     - export SUITE=$(echo "${SUITE}" | sed 's/,/\\|/g')
-    - if [ ! -z "${SUITE}" ]; then ls -1d ./tests/* | grep -q "\/\(${SUITE}\)" || (set +x; echo ''; echo -e '\033[1;31m[ERROR] The requested SUITE filter does not match any suite\033[0m'; echo ''; exit 1); fi
+    - if [ ! -z "${SUITE}" ]; then ls -1d ./tests/* | grep -q "\/\(${SUITE}\)" || (set +x; echo ' '; echo -e '\033[1;31m[ERROR] The requested SUITE filter does not match any suite\033[0m'; echo ' '; exit 1); fi
     # Run tests
     - for path in $(ls -1d ./tests/* | grep "\/\(${SUITE}\)"); do (cd "${path}/" && time sh ./test.sh 2>&1); done
     # Finish tests
     - |
       (
         set +x
-        echo ''
+        echo ' '
         echo ' [INFO] Unit tests finished successfully'
-        echo ''
+        echo ' '
       )
 
 .coverage-template:
@@ -417,7 +641,10 @@ coverage:linux:
   extends:
     - .coverage-template
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:test-coverage-linux
-  needs: []
+  needs:
+    - job: registry:test-coverage-linux
+      artifacts: false
+      optional: true
   variables:
     COVERAGE_FILE: ${CI_PROJECT_DIR}/coverage-reports/.coverage-linux
     COVERAGE_XML: ${CI_PROJECT_DIR}/coverage-reports/coverage-linux.xml
@@ -428,7 +655,10 @@ coverage:windows:
   extends:
     - .coverage-template
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:test-coverage-windows
-  needs: []
+  needs:
+    - job: registry:test-coverage-windows
+      artifacts: false
+      optional: true
   variables:
     COVERAGE_FILE: ${CI_PROJECT_DIR}/coverage-reports/.coverage-windows
     COVERAGE_XML: ${CI_PROJECT_DIR}/coverage-reports/coverage-windows.xml
@@ -465,6 +695,9 @@ sonarcloud:
     name: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/sonarsource/sonar-scanner-cli:latest
     entrypoint: ['']
   needs:
+    - job: registry:rehost
+      artifacts: false
+      optional: true
     - job: coverage:linux
     - job: coverage:windows
   variables:
@@ -478,6 +711,15 @@ sonarcloud:
     # Configure Git securities
     - git config --global --add safe.directory "${CI_PROJECT_DIR}"
   script:
+    # Prevent local usage
+    - |
+      if [ ! -z "${CI_LOCAL:-}" ] && [ -z "${SONAR_HOST_URL:-}" ]; then
+        set +x
+        echo ' '
+        echo ' [ERROR] SonarCloud quality job is meant for CI executions only...'
+        echo ' '
+        exit 1
+      fi
     # Scan with SonarCloud
     - sonar-scanner -Dsonar.projectVersion=$(git describe --always) -Dsonar.branch.name=${CI_COMMIT_REF_NAME}
   rules:
@@ -490,6 +732,8 @@ sonarcloud:
       when: always
     - if: $CI_COMMIT_REF_NAME == "main"
       when: always
+    - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
+      when: always
     - when: never
   allow_failure: true
 
@@ -500,6 +744,9 @@ deploy:release:
   stage: deploy
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:deploy
   needs:
+    - job: registry:deploy
+      artifacts: false
+      optional: true
     - job: build
     - job: coverage:linux
       artifacts: false
@@ -547,6 +794,9 @@ deploy:trial:
   stage: deploy
   image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:deploy
   needs:
+    - job: registry:deploy
+      artifacts: false
+      optional: true
     - job: build
     - job: coverage:linux
       artifacts: false
@@ -564,3 +814,93 @@ deploy:trial:
   rules:
     - if: $CI_LOCAL
   when: manual
+
+.pages:
+  rules:
+    changes:
+      - '.gitlab-ci.yml'
+      - 'CHANGELOG.md'
+      - 'mkdocs.yml'
+      - 'LICENSE'
+      - 'README.md'
+      - 'docs/**/*'
+      - 'requirements/**/*'
+
+pages:
+  stage: deploy
+  image: registry.gitlab.com/radiandevcore/tools/gitlab-projects-settings/gitlab-projects-settings:pages
+  needs:
+    - job: registry:pages
+      artifacts: false
+      optional: true
+    - job: build
+      artifacts: false
+      optional: true
+    - job: coverage:linux
+      artifacts: false
+      optional: true
+    - job: coverage:windows
+      artifacts: false
+      optional: true
+    - job: py3.8
+      artifacts: false
+      optional: true
+    - job: py3.12
+      artifacts: false
+      optional: true
+  variables:
+    CI_LOCAL_NETWORK: 'host'
+    MKDOCS_EXPORTER_PDF_ENABLED: 'true'
+  script:
+    # Fetch all tags
+    - |
+      if [ -z "${CI_LOCAL:-}" ]; then
+        git fetch --tags --unshallow || true
+      fi
+    # Prepare documentation
+    - |
+      if [ ! -z "${CI_LOCAL:-}" ]; then
+        find ./config/* ./docs/* ./mkdocs.yml ./README.md -not -path ./docs/assets/stylesheets/variables.scss -type f | entr -n sh ./docs/prepare.sh &
+        echo -n "${!}" >./docs/.serve.pid
+        sleep 2
+      else
+        sh ./docs/prepare.sh
+      fi
+    # Generate documentation
+    - |
+      if [ ! -z "${CI_LOCAL:-}" ]; then
+        network_ip=$(hostname -I | cut -d' ' -f1)
+        mkdocs serve --dev-addr "${network_ip}:8001" --clean --config-file ./mkdocs.yml --verbose
+      else
+        mkdocs build --clean --config-file ./mkdocs.yml --verbose
+      fi
+  after_script:
+    # Cleanup documentation
+    - |
+      if [ -e ./docs/.serve.pid ]; then
+        cat ./docs/.serve.pid | xargs -r kill >/dev/null 2>&1 || true
+      fi
+    - sh ./docs/prepare.sh --clean
+  artifacts:
+    expire_in: 1 hour
+    paths:
+      - public
+  rules:
+    - if: $CI_COMMIT_TAG || $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+      changes: !reference [.pages, rules, changes]
+    - if: $CI_COMMIT_BRANCH && $CI_COMMIT_REF_PROTECTED
+      changes: !reference [.pages, rules, changes]
+      when: manual
+
+pdf:
+  extends:
+    - pages
+  stage: deploy
+  artifacts:
+    expire_in: 1 hour
+    paths:
+      - public/documentation.pdf
+  rules:
+    - if: $CI_COMMIT_TAG
+    - if: $CI_COMMIT_BRANCH
+      changes: !reference [.pages, rules, changes]