OpenCode 中文社区

Appearance

5.15 GitLab 集成 ​

💡 一句话总结：配置 GitLab 集成，实现团队协作。

学完你能做什么 ​

  • 能连接 GitLab 项目
  • 能使用 GitLab 工具
  • 能配置 CI/CD 集成
  • 能处理 Merge Request

🎒 开始前的准备 ​

确保你已经完成以下事项：

  • [ ] 有 GitLab 账号
  • [ ] 有 GitLab Personal Access Token

配置 ​

基础配置 ​

yaml
gitlab:
  enabled: true
  
  auth:
    token: "${GITLAB_TOKEN}"
  
  url: "https://gitlab.com"
  
  default_group: "my-group"
  default_project: "my-project"

多实例配置 ​

yaml
gitlab:
  instances:
    - name: "gitlab-com"
      url: "https://gitlab.com"
      token: "${GITLAB_COM_TOKEN}"
    
    - name: "gitlab-org"
      url: "https://gitlab.my-company.com"
      token: "${GITLAB_ORG_TOKEN}"

工具 ​

项目操作 ​

bash
# 列出项目
/gitlab list-projects --group my-group

# 获取项目信息
/gitlab get-project --project my-group/my-project

# 创建项目
/gitlab create-project --name new-project --visibility private

文件操作 ​

bash
# 读取文件
/gitlab read-file --project my-group/my-project --path src/app.ts

# 创建/更新文件
/gitlab create-or-update-file \
  --project my-group/my-project \
  --file-path "src/new.ts" \
  --content "文件内容" \
  --commit-message "添加新文件"

Merge Request ​

bash
# 创建 MR
/gitlab create-mr \
  --project my-group/my-project \
  --title "功能更新" \
  --source-branch feature \
  --target-branch main

# 列出 MR
/gitlab list-mrs --project my-group/my-project --state opened

# 合并 MR
/gitlab merge-mr --project my-group/my-project --mr-number 123

CI/CD ​

bash
# 触发流水线
/gitlab trigger-pipeline \
  --project my-group/my-project \
  --ref main \
  --variables KEY1=VALUE1

# 获取流水线状态
/gitlab get-pipeline --project my-group/my-project --pipeline-id 456

自动化 ​

自动审查 ​

yaml
gitlab:
  automations:
    - name: "自动审查"
      trigger: "merge_request_opened"
      actions:
        - name: "运行测试"
          trigger: "my-group/my-project"
        
        - name: "代码审查"
          run: "make lint"

问题跟踪 ​

yaml
gitlab:
  automations:
    - name: "自动更新"
      trigger: "issue_closed"
      actions:
        - name: "记录完成"
          add_comment: "问题已关闭"

跟我做 ​

实战：配置 GitLab 集成 ​

  1. 创建 GitLab Token：
bash
# 在 GitLab 设置中创建
# User Settings > Access Tokens
  1. 配置 OpenCode：
yaml
gitlab:
  enabled: true
  auth:
    token: "${GITLAB_TOKEN}"
  
  url: "https://gitlab.com"
  default_group: "my-team"
  1. 测试集成：
列出 my-team 的所有项目

检查点 ✅ ​

全部通过才能继续

  • [ ] 能配置 GitLab
  • [ ] 能使用工具
  • [ ] 能配置 CI/CD
  • [ ] 能处理 MR

本课小结 ​

你学会了：

  1. GitLab 配置
  2. 项目操作
  3. 文件操作
  4. CI/CD 集成
  5. Merge Request

下一课预告 ​

下一课我们将学习会话分享。

📚 更多完整模板：Prompt 模板库

微信群