GitLab Pages 是什么
GitLab Pages 用流水线里的 pages 作业发布静态站点：作业把产物放到约定的 public 目录并声明为 artifacts，由 Pages 服务托管，适合文档站、演示站点与前端预览。发布通常只在默认分支或受保护分支进行；静态产物是公开可访问的文件，敏感信息绝不能进入产物。
基本信息
| 产物 | 名为 pages 的作业产出 public/ 目录并声明 artifacts |
|---|---|
| 分支 | 通常只在默认分支或受保护分支发布 |
| 域名 | 支持默认域名与自定义域名 |
| 预览 | 可按分支发布预览站点 |
| 权限 | 站点访问控制视版本与套餐而定 |
| 注意 | 产物即公开内容，敏感值不能入产物 |
| 触发 | 用 rules 限定允许发布的条件 |
Pages 作业示例
Pages 作业示例
pages:
stage: deploy
script:
- mkdir -p public # 产物目录
- cp -r dist/* public/ # 放入站点文件
artifacts:
paths: [public] # 声明发布目录
rules:
- if: '$CI_COMMIT_BRANCH == "main"' # 仅主干发布典型使用场景
- 文档站：产品文档与内部手册随仓库更新自动发布
- 演示站点：每次合并后更新静态演示
- 前端产物预览：构建结果部署给产品同学验收
- 分支预览：按分支发布预览站点做评审
- 活动页：低成本的临时静态页面托管
- 多版本文档：按目录发布版本化文档
作业要素与注意
| 要素 | 作用 | 注意 |
|---|---|---|
| 作业名 pages | 触发 Pages 发布 | 改名后不再发布 |
| artifacts public | 上传站点产物 | 路径写错站点会 404 |
| rules | 控制发布分支 | 不限制则任意分支可发布 |
| 自定义域名 | 绑定品牌域名 | 证书与解析要配套 |
| 访问控制 | 限制站点可见性 | 能力视版本与套餐 |
发布目录与站点路径要对齐：产物路径写错时站点 404，但流水线显示成功。
把 secrets 打进静态产物：前端构建的环境变量要区分公开与敏感，产物是公开文件。
发布限制在受保护分支或收窄 rules：避免任何分支都能覆写线上站点。
预览站点要定期清理：分支删除后预览长期残留会造成误导。