如何免构建与CI/CD将静态HTML发布到GitLab Pages？及排障

能否绕过CI/CD直接发布？ #

GitLab Pages目前必须依赖CI/CD流水线完成部署，无法像GitHub Pages那样直接上传文件发布。但可以配置一个极简的流水线，只做静态文件复制操作，完全不需要在GitLab runner上运行耗时的snakemake工作流。

仅复制现有静态文件的.gitlab-ci.yml配置 #

这是实现需求的最简配置，直接复制仓库里的index.html到指定的public目录即可：

pages:
  stage: deploy
  script:
    - mkdir -p public
    - cp index.html public/
  artifacts:
    paths:
      - public
  only:
    - main  # 替换成你的项目默认分支名，比如master

关键说明：

• pages是GitLab Pages专用的job名称，必须严格使用这个名称
• mkdir -p public确保目标目录存在，避免复制时因目录不存在报错
• artifacts指定GitLab需要部署的目录为public，这是Pages的强制要求
• only限定仅在指定分支触发流水线，避免无关分支误触发

复制操作失败的常见原因 #

• 未提前创建public目录，导致cp命令因目标路径不存在报错
• index.html不在仓库根目录，复制时路径写得不对
• 配置里的分支名和项目实际默认分支不匹配，流水线根本没触发

查看流水线错误日志的步骤 #

1. 打开你的GitLab项目主页
2. 左侧菜单栏点击CI/CD → 流水线
3. 找到状态为失败的流水线，点击进入详情页
4. 点击失败的pages任务，即可查看完整的脚本执行日志，日志里会明确标注错误原因（比如文件找不到、目录不存在等）

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