ubuntu gitlab使用教程大全 - 问答

Ubuntu 上 GitLab 使用教程大全

一环境准备与安装

系统要求与准备
- 推荐硬件：4GB 内存起步（建议 8GB+）、2 核 CPU（建议 4 核+）、10GB 磁盘（建议 20GB+）。
- 安装依赖：sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata perl。
- 防火墙放行：sudo ufw allow 80/tcp，443/tcp，22/tcp；如启用 UFW 需执行 sudo ufw enable。
Omnibus 安装（推荐）
- 添加仓库：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
- 安装 CE 版：sudo apt install gitlab-ce
- 首次配置：sudo gitlab-ctl reconfigure
- 访问地址：浏览器打开 http://<服务器IP或域名>

Docker 安装（可选）

运行容器：

docker run --detach \
  --hostname localhost \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

说明：将主机目录挂载到容器内以实现配置、日志、数据持久化。

二首次配置与登录

修改外部访问地址
- 编辑配置文件：sudo vim /etc/gitlab/gitlab.rb
- 设置 URL：external_url ‘http://your_server_ip_or_domain’
- 应用配置：sudo gitlab-ctl reconfigure
管理员登录与初始密码
- 默认管理员账号：root
- 初始密码文件：/etc/gitlab/initial_root_password（生成后 24 小时自动删除，请尽快登录并修改）
- 登录后建议立即修改密码并完善管理员资料

邮件通知（可选）

在 gitlab.rb 中启用 SMTP（示例为 QQ 邮箱）：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "你的邮箱@qq.com"
gitlab_rails['smtp_password'] = "授权码"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = :login
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = "你的邮箱@qq.com"

修改后执行：sudo gitlab-ctl reconfigure。

三日常使用与项目管理

创建项目与组
- 登录 Web 界面，点击 New project 创建项目；使用 Groups 管理团队与权限，将用户加入组并分配角色（Owner/Maintainer/Developer 等）。
克隆与推送代码
- HTTPS 克隆：git clone https://<IP或域名>/<组>/<项目>.git
- SSH 克隆：git clone git@<IP或域名>:<组>/<项目>.git（需配置 SSH 公钥）
- 常用命令：
```
git add .
git commit -m "feat: init project"
git push -u origin main
git pull
```
分支与合并请求
- 创建分支：git checkout -b feature/x
- 推送分支：git push -u origin feature/x
- 在 Web 界面创建 Merge Request 进行代码评审与合并
问题跟踪与看板
- 使用 Issues、Milestones、Kanban 进行任务管理与进度跟踪。

四运维与备份恢复

常用运维命令

启停与状态：

sudo gitlab-ctl start|stop|restart|status
sudo gitlab-ctl tail nginx    # 查看组件日志

备份与恢复
- 备份（会包含配置、数据库、仓库与上传等）：
```
sudo gitlab-backup create
```
- 恢复（先确保实例已安装且版本一致，将备份文件放到 /var/opt/gitlab/backups）：
```
sudo gitlab-backup restore BACKUP=<时间戳>
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart
```

重置管理员密码

进入控制台：sudo gitlab-rails console -e production

查找并修改密码（示例）：

user = User.where(id: 1).first
user.password = 'NewStrongPass!'
user.password_confirmation = 'NewStrongPass!'
user.save!

升级与迁移
- 升级：sudo apt update && sudo apt install gitlab-ce（小版本通常直接升级；跨大版本请先备份并阅读官方升级文档）
- 迁移：在新服务器安装同版本 GitLab，将备份文件拷贝至 /var/opt/gitlab/backups，执行恢复后 reconfigure。

五常见问题与优化

端口与访问
- 确保云服务器安全组与系统防火墙放行 80/443/22；如需使用域名，将 external_url 改为 https://your.domain 并配置有效证书。
性能与资源
- 建议内存 8GB+，并根据并发调整 Puma/Unicorn、Sidekiq 并发与数据库连接池；磁盘使用监控与日志轮转可降低风险。
日志与排错
- 组件日志：/var/log/gitlab/nginx、gitlab-rails、sidekiq 等；实时查看：sudo gitlab-ctl tail <组件名>
安全建议
- 启用 HTTPS、限制 root 直接登录、开启 2FA、定期升级、最小权限分配、备份定期演练。

0 赞

0 踩