Развертывание страниц GitLab для разных веток

Каждый проект GitLab может иметь не более одного сайта Pages. Я не могу найти явную ссылку на это, но документация для .gitlab-ci.yml говорит:

Be aware that Pages are by default branch/tag agnostic and their deployment relies solely on what you specify in .gitlab-ci.yml. If you don’t limit the pages job with the only parameter, whenever a new commit is pushed to whatever branch or tag, the Pages will be overwritten.

Без параметра only обновления любой ветки публикуются на сайте такой же Pages, перезаписывая все, что там есть. С параметром only только указанная ветка будет запускать сборку Pages.

Я успешно использовал для этой цели доступные для просмотра артефакты. В вашем примере вы должны создать задание для своей ветки разработки и установить PUBLIC_URL путь к gitlab.io, где публикуются артефакты задания:

develop:
    artifacts:
        paths:
          - public

    environment:
        name: Develop
        url: "https://$CI_PROJECT_NAMESPACE.gitlab.io/-/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/public/index.html"

    script: |
        # whatever

    stage: deploy

    variables:
        PUBLIC_URL: "/-/$CI_PROJECT_NAME/-/jobs/$CI_JOB_ID/artifacts/public"

Установка environment, как указано, создает ссылку «Проверить приложение» в соответствующих мерж-реквестах, что позволяет вам добраться до артефактов одним щелчком мыши.

Примечание: если ваш репозиторий находится в подгруппа, вам нужно вставить имя подгруппы в двух местах выше между /-/ и $CI_PROJECT_NAME, чтобы результирующие URL-адреса работали.

Можно оставить несколько опубликованных страниц для разных пайплайнов/веток.

Для этого вам нужно скопировать содержимое ваших страниц (в основном тестовый отчет или что-то еще, что нужно опубликовать) в конкретный уникальный каталог в общей папке. Например, имя каталога может быть идентификатором конвейера (CI_PIPELINE_ID). Таким образом, путь к источникам страниц будет выглядеть как общедоступный/$CI_PIPELINE_ID/.

Затем вся общая папка должна быть определена как артефакты с конкретное уникальное имя (здесь снова можно использовать "$CI_PIPELINE_ID").

Уникальное имя для артефактов необходимо, чтобы не переопределять артефакты при следующем выполнении конвейера (если имя не указано, будет принято имя по умолчанию https://docs.gitlab.com/ee/ci/yaml/#artifactsимя).

Затем вы можете получить доступ к опубликованному отчету по ссылке:

https://yourGitlab/yourNamespace/yourProjectName/{CI_PIPELINE_ID}/index.html

, это означает, что вы можете получить доступ ко всем своим сохраненным отчетам, изменив идентификатор конвейера.

Мой пример:

stages:
  - publish

cache:
  # Required to keep artifacts from old builds, e.g. from master
  paths:
    - public

pages:
  stage: publish
  script:
    - mkdir -p public/$CI_PIPELINE_ID
    - cp target/site/allure-maven-plugin/* public/$CI_PIPELINE_ID/ -R
  artifacts:
    name: "$CI_PIPELINE_ID"
    paths:
      - public
    expire_in: 5 days
  when: always