Debian环境下 GitLab 插件的安装与管理
一、概念澄清与总体思路
- GitLab 本体并不提供类似浏览器或 IDE 的“插件商店”。在 Debian 上，所谓“插件”通常分为三类：
- 系统级组件/Runner（如 GitLab Runner），通过 APT 安装，注册到实例后扩展 CI/CD 能力；
- 内置集成/Webhooks，在项目的 Settings → Webhooks 配置，用于与第三方系统联动；
- 内置集成/OAuth 等，在 Admin → Settings → Integrations 配置，用于与全局外部服务对接。
- 管理动作通常包括：安装、启用/禁用、更新、卸载与日志排查，必要时执行 gitlab-ctl reconfigure/restart 使配置生效。
二、系统级组件的安装与管理（以 GitLab Runner 为例）
- 安装 Runner（Debian 常用方式）：
- 安装依赖并添加仓库后，执行：
sudo apt-get install -y gitlab-runner
- 注册到 GitLab 实例：
- 执行：
sudo gitlab-runner register，按交互提示填写 GitLab 实例地址 与 Registration token（在项目或管理员页面获取），选择 executor（如 shell、docker 等）。
- 常用运维：
- 查看状态：
sudo gitlab-runner status
- 启动/停止/重启：
sudo gitlab-runner start|stop|restart
- 升级：当仓库有新版本时，
sudo apt-get update && sudo apt-get install --only-upgrade gitlab-runner
- 卸载：
sudo apt-get remove --purge gitlab-runner
- 说明：Runner 是 GitLab 官方推荐的“插件化”扩展方式之一，用于承载构建、测试、部署等流水线任务。
三、通过 Webhooks 与内置集成的安装与管理
- Webhooks（项目级集成）：
- 进入项目 → Settings → Webhooks，填写目标 URL 与触发事件（如 Push、Merge Request 等），可选择 Secret Token 做校验，保存后可通过“Test”验证。
- 内置集成（实例级）：
- 进入 Admin → Settings → Integrations，按需启用并配置与第三方服务的对接（如 JIRA、Slack、Kubernetes 等），保存后生效。
- 管理要点：
- 变更后通常即时生效；如涉及服务重启，按页面提示或执行
sudo gitlab-ctl restart。
- 排查建议：查看 /var/log/gitlab/ 下相关组件日志（如 gitlab-rails、sidekiq）。
四、日常运维与故障排查
- 配置生效与重启：
- 修改 /etc/gitlab/gitlab.rb 后执行：
sudo gitlab-ctl reconfigure；必要时 sudo gitlab-ctl restart。
- 日志与诊断：
- 统一日志目录：/var/log/gitlab/；组件日志、Nginx/Unicorn、Sidekiq 等均在此目录下，便于定位插件/集成问题。
- 备份与变更控制：
- 安装或升级前先备份：/etc/gitlab/gitlab.rb、/etc/gitlab/gitlab-secrets.json 与数据目录（默认 /var/opt/gitlab），变更失败可快速回滚。
