如何在Ubuntu上自定义GitLab - 问答

如何在Ubuntu上自定义GitLab

在Ubuntu上自定义GitLab主要围绕基础配置、功能增强、界面优化及性能调整等方面展开，以下是具体步骤：

1. 基础环境准备

在安装GitLab前，需确保系统满足基本要求并安装依赖：

更新系统：sudo apt update && sudo apt upgrade -y
安装依赖：sudo apt install -y curl openssh-server ca-certificates postfix（安装过程中选择“Internet站点”配置Postfix，用于邮件通知）。

2. 安装GitLab社区版（CE）

添加GitLab软件源：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
安装GitLab：sudo apt install gitlab-ce（默认安装最新稳定版）。

3. 核心配置修改（关键自定义项）

配置文件路径为/etc/gitlab/gitlab.rb，修改后需执行sudo gitlab-ctl reconfigure使更改生效：

设置外部访问URL：修改external_url为服务器IP或域名（如external_url 'http://192.168.1.100'），若使用自定义端口（如9090），需同步修改nginx['listen_port']。

配置邮件服务（用于通知）：启用SMTP并填写服务商信息（以Gmail为例）：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.gmail.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "your-email@gmail.com"
gitlab_rails['smtp_password'] = "your-app-password"  # 需使用Gmail应用专用密码
gitlab_rails['smtp_domain'] = "smtp.gmail.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['gitlab_email_from'] = "your-email@gmail.com"
```。

修改默认端口：若需更改SSH（unicorn['port']）或HTTP（nginx['listen_port']）端口，直接在配置文件中调整对应值（如unicorn['port'] = 3001，nginx['listen_port'] = 3000），并同步修改防火墙规则。

4. 功能自定义

调整存储路径：修改仓库数据存储位置（默认/var/opt/gitlab/git-data），在gitlab.rb中添加：
```
git_data_dirs({ "default" => { "path" => "/mnt/data/git-data" } })
```
修改后需停止GitLab、迁移数据（rsync -av /var/opt/gitlab/git-data/repositories /mnt/data/git-data）、重新配置并启动。

配置HTTPS：通过Let’s Encrypt免费证书实现HTTPS，执行：
sudo gitlab-ctl reconfigure（自动申请证书），或手动指定证书路径：

nginx['ssl_certificate'] = "/etc/letsencrypt/live/your-domain.com/fullchain.pem"
nginx['ssl_certificate_key'] = "/etc/letsencrypt/live/your-domain.com/privkey.pem"
```。

5. 界面个性化

修改界面语言：登录GitLab后，点击右上角头像→“Settings”→“Preferences”→“Appearance”→选择“中文(简体)”→“Save changes”。
调整界面主题/布局：在“Appearance”选项卡中，选择预设主题（如“Light”“Dark”）或调整字体大小、颜色；也可通过第三方主题（如GitLab官方市场）进一步定制。
自定义首页：创建与账号同名的公开仓库（如username/username），上传包含自定义Markdown内容的README.md文件（如项目介绍、导航链接），作为GitLab首页。

6. 高级自定义

通过API定制：使用GitLab API编写脚本，实现自动化创建项目、用户、钩子（Hooks）等功能（如curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects" --form "name=my_project"）。
安装插件/集成：通过GitLab应用市场安装第三方插件（如Jenkins集成、SonarQube代码质量分析），或在gitlab.rb中启用相关功能（如gitlab_rails['omniauth_enabled'] = true集成GitHub登录）。

7. 常用维护命令

启动GitLab：sudo gitlab-ctl start
停止GitLab：sudo gitlab-ctl stop
重启GitLab：sudo gitlab-ctl restart
查看服务状态：sudo gitlab-ctl status
查看日志：sudo gitlab-ctl tail（查看所有日志）或sudo gitlab-ctl tail nginx/gitlab_access.log（查看Nginx访问日志）。

注意事项

修改配置文件前备份（如cp /etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb.bak），避免配置错误导致服务无法启动。
若使用自定义端口，需在Ubuntu防火墙（ufw）中开放对应端口（如sudo ufw allow 9090/tcp）。
首次登录GitLab需修改root用户密码（通过cat /etc/gitlab/initial_root_password查看初始密码）。

0 赞

0 踩