GitLab中Pages部署任务如何重命名为documentation？

为什么直接改任务名不行 #

GitLab Pages服务必须识别名为pages的CI/CD任务，只有这个任务上传的public目录工件会被自动部署为静态站点。直接将任务名改为documentation后，平台无法识别该任务用于Pages部署，因此会失效。

两种可行的重命名方案 #

方案一：拆分构建与部署任务 #

保留pages任务作为部署触发点，新增documentation任务负责构建静态文件，让pages依赖documentation的工件完成部署：

# 负责构建文档的任务，显示名称为documentation
documentation:
  image: maven:3.9.5-sapmachine-21
  stage: build
  script:
    - mvn clean install site
    - mkdir public
    - mv target/site/* public/
  artifacts:
    paths:
      - public

# 保留pages任务，仅依赖documentation的工件完成部署
pages:
  stage: pages
  dependencies:
    - documentation
  script:
    - echo "部署来自documentation任务的文档内容"
  artifacts:
    paths:
      - public

方案二：使用任务显示别名（GitLab CI 14.0+） #

利用GitLab CI的name字段给pages任务设置显示别名，既满足平台对任务ID的要求，又能在CI界面显示自定义名称：

pages:
  # 设置任务在CI界面的显示名称为documentation
  name: documentation
  image: maven:3.9.5-sapmachine-21
  stage: pages
  script:
    - mvn clean install site
    - mkdir public
    - mv target/site/* public/
  artifacts:
    paths:
      - public

方案对比 #

• 方案一适合需要将构建、部署步骤拆分的场景，权限控制或流程拆分更灵活；
• 方案二更简洁，仅修改任务显示名称，无需额外任务配置。

内容的提问来源于stack exchange，提问作者PatPanda