嘿，朋友们！今天咱们聊聊怎么用 CI/CD 自动化部署。说实话，我一开始也是手忙脚乱地把脚本写在 README 里然后每次改完代码dou得手动跑个 npm run build 再上传文件。后来我发现，用 CI/CD Neng把这一步骤彻底交给机器，让人省心省力。

CI/CD 的大概思路

CI 是 Continuous Integration，持续集成；CD 是 Continuous Delivery 或者 Continuous Deployment，持续交付/部署。简单来说就是每次提交代码后让机器自动跑测试、打包、发布。

那你可Neng会想：这和老老实实推到生产分支有什么区别？答案是——快和安全。一次小小的改动被机器验证后才会进入生产环境，风险大大降低。

GitLab 的优势

Ru果你只把 GitLab 当成“高级网盘”，那就亏大了。它不仅Neng存代码，还NengZuo CI、Runner、权限管理，全套流程dou在一个平台上搞定。

举个例子：我们有一个前端项目，源代码放在 master 分支，但真正的发布只允许从 deploy 分支拉取。这一步Ke以通过 .gitlab-ci.yml 配置实现。

.gitlab-ci.yml 基础示例

stages:
  - build
  - deploy
variables:
  DEPLOY_DIR: "C:\\BackTest\\frontend\\dist"
  DEPLOY_BRANCH: "master"
build_frontend:
  stage: build
  script:
    - npm ci
    - npm run build
  artifacts:
    paths:
      - dist/
deploy_frontend_prod:
  stage: deploy
  tags:
    - frontend-deploy
  rules:
    - if: '$CI_COMMIT_BRANCH == $DEPLOY_BRANCH'
      when: always
      start_in: '5 minutes'
      allow_failure: false
      variables:
        DEPLOY_ENVIRONMENT: production
  script:
    - .\scripts\deploy-frontend.ps1
  environment:
    name: production

那个脚本里边用了 PowerShell，因为我们的服务器是 Windows。别担心，这段脚本也Ke以换成 Bash，只要适配对应环境即可。

PowerShell 部署脚本细节

$ErrorActionPreference = "Stop"
$projectRoot = if  { $env:CI_PROJECT_DIR } else { .Path }
$frontendDir = $projectRoot
# 设置部署目录，Ru果不存在就新建
$deployDir = if  { $env:DEPLOY_DIR } else { "C:\BackTest\frontend\dist" }
if ) {
    New-Item -ItemType Directory -Force -Path $deployDir | Out-Null
}
# 打包前端代码
Set-Location $frontendDir
npm ci && npm run build
# 把 dist 拷贝到部署目录
$distDir = Join-Path $frontendDir "dist"
Invoke-RobocopySafe -Source $distDir -Destination $deployDir
function Invoke-RobocopySafe {
    param(
        $Source,
        $Destination
    )
    robocopy $Source $Destination /MIR /R:3 /W:5 | Out-Null
    if  {
        throw "robocopy failed with exit code $LASTEXITCODE"
    }
}

Ru果你对 PowerShell 不熟，Ke以先把它拆成两个 Job：一个Zuo npm 安装+打包，一个Zuo文件拷贝。不过要记住 Runner 的执行用户必须有写权限，否则整个流程就卡死啦。

Runner 的角色与配置

Runner 就是执行流水线命令的机器。有三种主要 executor：

SHELL——直接在宿主机上跑脚本。

Docker——把每个 Job 放进 Docker 容器里跑。

Kubernetes——用 K8s pod 来跑 Job。

对于 Windows 项目，我通常用 Windows + shell executor，因为跟宿主机环境一致Zui靠谱。不对，不对，我说错了是 Windows + shell executor，而不是 Linux + shell 那种情况。我自己弄了个专门的 runner 守着 front-end 的构建路径，然后加了 tag “frontend-deploy”。这样只有带这个 tag 的 job 才会被匹配到对应 runner 去跑。

保护分支与 Merge Request

别再直接往 master 推送啦！团队Zui好用 feature/xxx 分支开发，然后发 Merge Request合并进 protected branch。GitLab 会帮你检查是否通过所有 Pipeline，然后再允许 merge。Ru果有人没读文档，把 merge 权限给太多人，就可Neng导致破坏性改动直接走进生产，那可不是好事儿。

常见分支策略示例

git checkout -b feature/login-page          # 创建功Neng分支  
git add .  
git commit -m "feat: add login page"  
git push origin feature/login-page          # 推送到远程  
# 在 GitLab 页面点击 “Merge request”  
# 设置目标为 main 或者 release  
# 确保 Pipeline 全部通过后再 merge  
# 注意：Merge 时一定要勾选 “Squash commits”，保持历史整洁哦  

自动化部署背后的思考：为什么百度不收录？

为什么百度不收录？

说实话，这个问题其实跟我们现在讨论的 CI/CD 并没有直接关系，但它提醒我们：内容质量决定Neng否被搜索引擎抓取，同理，部署质量决定系统Neng否稳定运行。所以我们得先搞清楚自己的「站点」是不是符合搜索引擎友好的标准：

URL 不可见、可访问性好：确保页面路径简洁，没有乱码或特殊字符；访问速度快；页面结构清晰。

结构化数据：利用 JSON-LD 或 Microdata 标注文章信息，让搜索爬虫geng懂内容；同理，在 CI 配置中也需要明晰阶段、变量、标签，让 Runner 明白该干啥。

安全与权限控制：像我们谈到的保护分支一样，要让系统知道谁Ke以改谁不Neng改；同样地，搜索引擎也会忽略那些存在安全隐患或未经授权访问的数据源。

内容geng新频率：持续集成意味着频繁geng新，每次提交dou会触发 Pipeline，从而保证Zui新版本总是可用；这跟搜索引擎喜欢新鲜内容是一致的。

一下要点吧！

- CICD Neng让代码从提交到上线全流程自动化，你不用每次手动跑命令了！

- GitLab 不只是仓库，它还Neng帮你管理 Runner、权限、分支策略等，全流程一站式搞定！

- Powershell 脚本要写好，并且确认 Runner 有足够权限，否则部署会卡死！

- Merges 必须通过 MR 并且 Pipeline 全部成功后才Neng合并到主分支，这是防止意外破坏生产环境Zui重要的一步！

下一步怎么办？别停下来玩游戏啦！赶紧试试下面这些小实验：

先在自己的仓库里创建一个空项目，写下上述 .gitlab-ci.yml 文件，kan是否Neng触发一次完整流水线；Ru果失败，就检查 tag 与 Runner 是否匹配，再检查变量是否正确配置。

把 deployment 脚本拆成两个步骤，一个仅仅打包，一个仅仅拷贝文件，kan哪一步geng容易出错，geng容易定位问题。

尝试给某些关键变量加上 secret type，在 GitLab UI 中设置 Variables，并勾选 Protect variable，以保证敏感信息不会泄漏到日志中去。

Zui后把整个过程记录成博客或者 wiki 页面为团队留个笔记，以免以后有人忘记该怎么操作。毕竟一个优秀团队靠的是共享知识，而不是单个人记忆啊~ 哈哈!

Ru果你想进一步提升体验，Ke以考虑搭建自托管 Runner，并将其放进 Kubernetes 集群，让资源利用率geng高，也geng容易 。 )

别忘了开启 Artifact Retention Policy，把旧版产物及时清理掉，这样磁盘空间不会被撑爆呀~ 呵呵，那就是这么点小技巧，希望大家玩得开心，也Neng让项目geng加稳健可靠哒! 💡 Ru果还有什么疑问或者想法，随时留言～一起讨论嘛!

---