gitlab的ci/cd变量如何批量添加

GitLab 自带的 Web UI 里 不能一次性批量输入多个 CI/CD 变量，它是一个一个添加的。

不过有几种变通方式可以实现“批量添加”：

---

1. 用 GitLab API 批量创建
GitLab 提供了 CI/CD Variables API，可以用脚本循环调用，比如：

#!/bin/bash
# 批量添加项目变量
GITLAB_URL="https://gitlab.example.com"
PROJECT_ID="12345"
TOKEN="your_access_token"declare -A vars=(["VAR1"]="value1"["VAR2"]="value2"["VAR3"]="value3"
)for key in "${!vars[@]}"; docurl --request POST \--header "PRIVATE-TOKEN: $TOKEN" \--form "key=$key" \--form "value=${vars[$key]}" \"$GITLAB_URL/api/v4/projects/$PROJECT_ID/variables"
done

这样可以一次性批量导入几十上百个变量。

---

2. 用 GitLab Terraform Provider
如果你公司 CI/CD 基础设施用 IaC（Infrastructure as Code），可以在 .tf 里声明所有变量，然后一次性 terraform apply。这样版本可控，也方便批量修改。

---

3. 用 .gitlab-ci.yml + .env 文件间接加载
虽然这不是直接往 GitLab 存变量，但可以把变量放在仓库的加密文件中，然后在 job 开始时读取：

variables:VAR_FILE: ".ci/env.list"job_name:script:- export $(cat $VAR_FILE | xargs)

不过这种方式变量会在 pipeline log 中出现（需要注意敏感信息泄露风险）。

---

一个Python 脚本，可以批量导入 GitLab 项目的 CI/CD 变量（用 API 实现），支持从 CSV 文件读取变量。

假设 CSV 文件格式如下（无表头）：

VAR1,value1
VAR2,value2
VAR3,value3

---

Python 批量导入脚本

import csv
import requests# ==== 配置区 ====
GITLAB_URL = "https://gitlab.example.com"  # GitLab 地址
PROJECT_ID = 12345                         # 项目 ID
PRIVATE_TOKEN = "your_access_token"        # GitLab Personal Access Token
CSV_FILE = "variables.csv"                 # 变量文件路径
PROTECTED = False                          # 是否保护变量（True/False）
MASKED = False                             # 是否隐藏变量值（True/False）
# ==============API_URL = f"{GITLAB_URL}/api/v4/projects/{PROJECT_ID}/variables"
HEADERS = {"PRIVATE-TOKEN": PRIVATE_TOKEN}def add_variable(key, value, protected=False, masked=False):data = {"key": key,"value": value,"protected": protected,"masked": masked}resp = requests.post(API_URL, headers=HEADERS, data=data)if resp.status_code == 201:print(f"[OK] Added variable: {key}")elif resp.status_code == 400 and "key" in resp.json().get("message", {}):print(f"[SKIP] Variable '{key}' already exists.")else:print(f"[ERROR] Failed to add {key}: {resp.status_code}, {resp.text}")def main():with open(CSV_FILE, newline='', encoding="utf-8") as csvfile:reader = csv.reader(csvfile)for row in reader:if len(row) < 2:continuekey, value = row[0].strip(), row[1].strip()if key and value:add_variable(key, value, PROTECTED, MASKED)if __name__ == "__main__":main()

---

使用方法

1. 创建 Access Token

   • 进入 GitLab → 用户设置 → Access Tokens
   • 选中 api 权限，生成 token，填到 PRIVATE_TOKEN

2. 准备 CSV 文件

   • 文件名默认为 variables.csv（可修改脚本配置）
   • 每行 KEY,value，不加引号，值里如果有逗号用引号包起来

3. 运行脚本

   pip install requests
   python3 import_variables.py
   

---

批量导出一个项目的ci变量再批量导入另一个：

1. 导出：调用 GET /projects/:id/variables 把源项目的所有 CI/CD 变量拉下来并保存到 JSON 或 CSV
2. 导入：读取这个文件，再调用 POST /projects/:id/variables 写入目标项目

这样就能批量迁移。

---

示例 Python 脚本：批量迁移 CI/CD 变量

import requests
import json# ==== 配置 ====
GITLAB_URL = "https://gitlab.example.com"  # GitLab 地址
PRIVATE_TOKEN = "your_access_token"        # 需要有 API 权限
SOURCE_PROJECT_ID = 12345                   # 源项目 ID
TARGET_PROJECT_ID = 67890                   # 目标项目 ID
EXPORT_FILE = "ci_vars.json"                # 临时保存变量的文件
# ==============HEADERS = {"PRIVATE-TOKEN": PRIVATE_TOKEN}def export_variables(project_id, file_path):url = f"{GITLAB_URL}/api/v4/projects/{project_id}/variables"resp = requests.get(url, headers=HEADERS)resp.raise_for_status()vars_list = resp.json()with open(file_path, "w", encoding="utf-8") as f:json.dump(vars_list, f, ensure_ascii=False, indent=2)print(f"[OK] Exported {len(vars_list)} variables from project {project_id} to {file_path}")def import_variables(project_id, file_path):url = f"{GITLAB_URL}/api/v4/projects/{project_id}/variables"with open(file_path, "r", encoding="utf-8") as f:vars_list = json.load(f)for var in vars_list:data = {"key": var["key"],"value": var["value"],"protected": var.get("protected", False),"masked": var.get("masked", False),"environment_scope": var.get("environment_scope", "*")}resp = requests.post(url, headers=HEADERS, data=data)if resp.status_code == 201:print(f"[OK] Added {var['key']} to project {project_id}")elif resp.status_code == 400 and "key" in resp.json().get("message", {}):print(f"[SKIP] {var['key']} already exists in target project")else:print(f"[ERROR] Failed to add {var['key']}: {resp.status_code} {resp.text}")if __name__ == "__main__":# 1. 导出源项目变量export_variables(SOURCE_PROJECT_ID, EXPORT_FILE)# 2. 导入到目标项目import_variables(TARGET_PROJECT_ID, EXPORT_FILE)

---

用法

1. 生成 Access Token

   • 用户 → Access Tokens → 勾选 api 权限

2. 修改脚本里的配置（URL、Token、源项目 ID、目标项目 ID）

3. 运行

   pip install requests
   python3 migrate_ci_vars.py
   

---

⚠️ 注意事项

• 如果目标项目已有同名变量，脚本会跳过（可改成先删除再添加）
• API 会导出变量值（如果是 Masked 变量也能获取），所以文件要妥善保管
• 变量的 environment_scope 也会保留

---