Ubuntu 上 GitLab 安装扩展与集成的正确方式
一、先明确“插件”的类型
- 内置功能与集成：如 GitLab CI/CD、Webhooks、GitLab Runner、与 Prometheus/Grafana 的监控集成等，这些通常不需要安装传统意义上的“插件”，而是通过配置或安装组件实现。
- 官方应用与集成市场：通过 GitLab Marketplace 安装官方或第三方应用，增强项目与实例能力。
- 界面汉化：通过添加中文语言包并设置默认语言实现中文界面。
二、常见场景与操作步骤
- 安装并注册 GitLab Runner（CI/CD 执行器）
- 安装 Runner 软件包：
- curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
- sudo apt-get install gitlab-runner-ce
- 在 GitLab 项目或实例的 Settings → CI/CD → Runners 获取注册命令，在 Runner 主机上执行完成注册。
- 配置 Webhooks（项目级事件通知）
- 进入项目 Settings → Webhooks，填写目标 URL 与触发事件（如 Push、Merge Request 等），保存后可通过测试按钮校验。
- 使用 GitLab Marketplace 扩展功能
- 在 Admin Area → Applications 或项目/群组的 Settings → Integrations 中，从 GitLab Marketplace 选择并安装所需应用，按页面指引完成授权与配置。
- 安装 中文语言包（汉化界面）
- 下载中文语言包：
- sudo curl https://gitlab.com/xhang/gitlab/raw/master/locale/gitlab.zh_CN.yml -o /opt/gitlab/embedded/service/gitlab-rails/config/locales/gitlab.zh_CN.yml
- 修改 GitLab 配置：
- sudo vim /etc/gitlab/gitlab.rb
- 添加：gitlab_rails[‘default_locale’] = “zh-CN”
- 使配置生效：
- sudo gitlab-ctl reconfigure
- sudo gitlab-ctl restart。
三、安装后的验证与常见问题
- 验证 Runner：在项目 Settings → CI/CD → Runners 页面看到 Runner 处于 online 状态，并能成功执行流水线。
- 验证 Webhooks：在项目的 Webhooks 页面使用 Test 发送事件，目标服务应收到请求日志。
- 验证汉化：刷新页面或重新登录，界面应显示为中文；如未生效，检查语言包路径、文件权限及是否执行了 reconfigure/restart。
- 配置变更生效：凡修改 /etc/gitlab/gitlab.rb 后，需执行 sudo gitlab-ctl reconfigure；个别场景需要 sudo gitlab-ctl restart。
