GitLab CI/CD流水线中如何持久化更新仓库txt文件？

问题场景 #

尝试通过GitLab CI/CD流水线任务更新仓库内的status.txt文件来保存状态，流水线配置与PowerShell脚本如下：

流水线配置（.gitlab-ci.yml） #

stages:
  - check_url

standardCheck:
  stage: check_url
  image: mcr.microsoft.com/powershell:latest 
  script:
    - pwsh -File ./variable.ps1

PowerShell脚本（variable.ps1） #

# 读取初始状态（文件初始值为"true"）
$status = Get-Content -Path "status.txt"
Write-Host "current Status: $status"

# 尝试将状态改为"false"
Set-Content -Path ".\status.txt" -Value "false" -Force

Write-Host "当前工作目录: $(Get-Location)"
Write-Host "修改后状态: $(Get-Content -Path "status.txt")"

仓库包含.gitlab-ci.yml、status.txt、variable.ps1三个文件。脚本在任务执行时能读取到修改后的status.txt值，但仓库中的文件始终保持初始值"true"，未被持久化更新。尝试使用CI全局变量也无法永久覆盖其值。

核心疑问 #

1. 为何上述代码无法实现仓库文件的持久化更新？
2. 在GitLab实例中，还有哪些方式可实现状态的持久化存储？

解答 #

1. 仓库文件无法持久化更新的原因 #

GitLab CI/CD的Runner每次执行任务时，会从仓库拉取一个独立的临时工作副本，所有文件修改都只发生在这个临时目录中。任务执行完成后，Runner会自动销毁该临时环境，不会将修改自动同步回远程仓库。如果要更新仓库文件，必须手动添加Git提交、推送的步骤，同时需要确保Runner拥有仓库的推送权限（如使用CI_JOB_TOKEN或部署密钥）。

2. GitLab中实现状态持久化的可行方式 #

以下是几种适合GitLab环境的状态持久化方案：

• 项目/组变量（动态更新）：对于简单键值对状态，可使用GitLab项目或组变量。若需动态更新，可在流水线中调用GitLab API修改变量值，需配置具备API权限的访问令牌。
• 环境级变量：如果状态与特定部署环境绑定，可将状态存储为对应环境的变量，通过API更新。
• CI制品（Artifacts）：将状态文件作为制品上传，后续流水线可下载该制品读取状态。注意制品有默认保存期限，适合短期状态传递。
• 自定义项目属性：通过GitLab API设置项目的自定义属性来存储状态值，适合长期保存简单键值对。
• 提交到仓库文件（需手动推送）：若坚持用仓库文件存储状态，需在脚本中添加Git操作步骤，示例：

  # 配置Git用户信息
  git config --global user.name "GitLab CI/CD"
  git config --global user.email "gitlab-ci@example.com"
  # 提交修改
  git add status.txt
  git commit -m "Update status via CI [ci skip]"
  # 推送到远程仓库（使用CI_JOB_TOKEN授权）
  git push https://gitlab-ci-token:$CI_JOB_TOKEN@$CI_REPOSITORY_URL HEAD:$CI_COMMIT_BRANCH
  

  注：提交信息中加入[ci skip]可避免触发新的流水线循环，同时需确保Runner拥有仓库推送权限。
• 外部存储集成：自托管GitLab可集成Redis、数据库等外部存储服务，通过流水线脚本读写状态，适合复杂或大规模的状态存储需求。

内容的提问来源于stack exchange，提问作者ng-User