GitLab 配置与使用指南

本教程将引导您了解并设置 GitLab —— 一个开源的代码协作平台，提供版本控制、持续集成和许多其他特性。

1. 项目目录结构及介绍

在解压或克隆 gitlabhq 仓库后，您会看到以下主要目录：

1. app: 包含 Rails 应用程序的代码。
2. bin: 二进制脚本，用于启动和停止 GitLab 进程。
3. config: 存放所有配置文件的地方，包括数据库和环境设置。
4. db: 数据库迁移脚本位于此处。
5. doc: 提供官方文档和安装指南。
6. lib: 内部库和扩展。
7. log: 应用日志文件存储位置。
8. public: 静态资源和网站公共文件。
9. script: 启动脚本和其他辅助工具。
10. spec: RSpec 测试用例。
11. tmp: 存储临时文件的地方。
12. vendor: 第三方依赖包。

2. 项目启动文件介绍

GitLab 的启动通常通过 init.d 脚本或使用 OmniBus GitLab 包进行。以下是相关命令：

对于非 Omnibus GitLab 安装:

• 首先，确保所有依赖已正确安装并更新 (bundle install --without development test mysql aws).

• 使用 rake 命令初始化数据库：

  bundle exec rake db:create db:migrate
  

• 初始化 GitLab 的运行时目录：

  sudo -u gitlab mkdir -p /home/gitlab/data/{git-data,repos}
  

• 最后，启动 GitLab：

  bundle exec unicorn -E production -D
  

• 或者启动 Sidekiq（负责异步任务）：

  bundle exec sidekiq -e production -D
  

对于 Omnibus GitLab 安装:

• 配置完成后，可以通过以下单行命令启动所有服务：

  sudo systemctl start gitlab
  

• 或者分别启动：

  sudo systemctl start gitlab-runsvdir
  sudo systemctl start nginx
  sudo systemctl start gitaly
  sudo systemctl start postgresql
  

请注意，这些步骤适用于基本的本地安装。在生产环境中，建议参考 GitLab 官方文档以获取详细和安全的部署指南。

3. 项目的配置文件介绍

GitLab 的核心配置文件是 config/gitlab.yml，这里定义了应用的各种设置，如服务器地址、电子邮件通知、垃圾评论过滤等。配置文件分为几个部分：

• general: 包含全局设置，如主机名和外部 URL。
• repository: 管理 Git 仓库的参数，如大小限制和缓存策略。
• gitlab_shell: GitLab Shell 相关配置，用于 SSH 访问。
• gitlab_ci: 持续集成相关设置，包括 Runner 和构建限制。
• smtp (可选): 设置 SMTP 邮件服务器以发送通知邮件。

此外，还有针对特定服务的独立配置文件，例如：

• config/database.yml: 数据库存储连接信息。
• config/nginx.conf: Nginx 的自定义配置。
• config/unicorn.rb: Uniqorn（Web 服务器）配置。

修改配置文件后，通常需要重启 GitLab 才能使更改生效。

要了解更多详细的配置选项，请查阅官方配置文档。

---

希望这份指南对您成功安装和配置 GitLab 提供了帮助。在实际操作中，如果遇到任何问题，推荐查阅 GitLab 社区版 和 官方文档 获取最新支持和解决方案。祝您使用愉快！