如何阻止GitLab Runner在受保护分支上自动屏蔽变量？

问题原因 #

GitLab Runner在受保护分支的流水线中，有内置安全机制：会自动识别并屏蔽符合UUID格式（如79c14111-6272-4222-ba15-0abbb96efbc2这类8-4-4-4-12字符结构）的字符串，哪怕你没在变量设置里勾选「屏蔽」复选框，也会被替换成[MASKED]。

解决办法 #

• 修改变量值格式：给APP_ID的实际值添加前缀或后缀，比如改成APP_79c14111-6272-4222-ba15-0abbb96efbc2，这样就不会被识别为UUID。使用时在脚本里去除前缀/后缀即可：

  app_store_connect_api_key(
     app_id: ENV['APP_ID'].delete_prefix('APP_'),
  )
  

• 用文件存储变量内容：把APP_ID的值存入项目内的文件（比如config/app_id.txt），流水线执行时读取文件内容，这种方式不会触发自动屏蔽：

  app_store_connect_api_key(
     app_id: File.read('config/app_id.txt').strip,
  )
  

• 取消分支保护（谨慎使用）：如果该分支不需要受保护，可以从GitLab项目的「受保护分支」列表中移除它，Runner就不会启用自动屏蔽机制。但此操作会降低分支的安全性，仅在必要时使用。

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