2021树莓派上使用 GitLab 搭建私有Git 服务

傷城~ 2022-11-16 04:59 136阅读 0赞

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70][]

**GitLab是一个专业的Git解决方案，功能强大，和GitHub类似，而且其Community Edition (CE)是免费的，完全可以胜任为中小团队提供专业代码托管服务的工作，当然更重要的是它可以在Raspberry Pi上部署运行。**

### 准备 ###

官网首页：[https://about.gitlab.com][https_about.gitlab.com]  
下载页：[https://packages.gitlab.com/gitlab/raspberry-pi2][https_packages.gitlab.com_gitlab_raspberry-pi2]  
下载地址（打开页面，点击右上角的Download按钮）：  
[https://packages.gitlab.com/gitlab/raspberry-pi2/packages/debian/jessie/gitlab-ce\_8.13.0-ce.0\_armhf.deb][https_packages.gitlab.com_gitlab_raspberry-pi2_packages_debian_jessie_gitlab-ce_8.13.0-ce.0_armhf.deb]  
下载得到gitlab-ce\_8.13.0-ce.0\_armhf.deb文件。  
注意版本要选择jessie，也就是Debian 8，因为现在的Raspbian是基于它打造的。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 1][]

官网给出了在线安装的方法，但是我试了几次，可能由于国内到GitLab下载服务器之间的网络状况不好，很难在线安装成功。所以这里给出先下载安装包，然后离线安装到Raspberry Pi上。

### 开始安装 ###

**1. 先安装一些必要的依赖包：**

sudo apt-get install curl openssh-server ca-certificates postfix apt-transport-https

安装postfix时，会弹出一些设置，这是和发邮件相关的，如果不需要邮件功能，这里的设置并不重要。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 2][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 3][]

**2. 等待上述依赖包安装完成后，把之前下载的安装包gitlab-ce\_8.13.0-ce.0\_armhf.deb上传到Raspberry Pi的文件系统里。**

![20210406142704707.png][]  
**3. 正式安装deb包**

sudo dpkg -i gitlab-ce_8.13.0-ce.0_armhf.deb

这个包有281MB，包含172357个文件，因此安装会有些慢，卡在下面这步是正常的，耐心等待一下

![2021040614274813.png][]

安装完成提示信息：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 4][]

**4. 根据提示，需要运行：**

sudo gitlab-ctl reconfigure

看到如下提示就配置完成了

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 5][]

**5. 修改服务端口**

默认使用80端口，如果需要修改，可以修改/etc/gitlab/gitlab.rb中如下图的2处地方，

第一处在最顶部，可以修改为'http://192.168.1.3:20060'

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 6][]

第二处在下半部分

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 7][]

两个地方都要修改。  
注意保存文件后，要运行如下命令使得配置生效：

sudo gitlab-ctl reconfigure

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 8][]

可以看到能使用20060端口访问了，Project path也是正确的。

**6. 设定完成后，用新密码登录root用户。**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 9][]

这是管理员用户，只用它来添加普通用户，在普通用户里新建仓库来托管代码。  
点击界面右上角的小扳手图标，进入Admin Area，这是管理员独有的区域。  
在user里新建一个普通用户。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 10][]

注意初始的Projects limit只有10，只能创建10个projects。如果觉得不够用，可以放宽一点限制。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 11][]创建好账号

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 12][]

普通用户的密码会发送到邮箱，如果之前邮箱没配置好，可能会收不到，或者如果是内网使用，邮件也无法发出。这个问题可以这样解决：点击上传的Edit.

管理员里可以用管理权限修改这个用户的密码，改完后告诉该用户这个密码，该用户在首次登录后，会被提示设置一个新密码。  
如果以后使用时该用户忘记了密码，管理员也可以登录Admin Area重置。  
这样就不需要邮件来重置密码，缺点是需要管理员介入，对于中小团队这样的管理方法是可取的（可以由项目组织者充当管理员）。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 13][]

另外在Admin Area界面右侧有个齿轮形状的图标，点击这里可以修改一些全局设定（包括前面初始的Projects limit等）， 根据提示修改就行了。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 14][]

使用root创建的wuzhao账号登录

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 15][]

到此树莓派上使用 GitLab 搭建专业 Git 服务结束。

一些实用的维护命令

#修改任何配置文件后都要输入如下命令使配置生效。
    sudo gitlab-ctl reconfigure
     
    #页面缓存清除：
    sudo gitlab-rake cache:clear RAILS_ENV=production
     
    #GitLab各组件启动：
    sudo gitlab-ctl start
     
    #GitLab各组件停止：
    sudo gitlab-ctl stop
     
    #GitLab各组件重启：
    sudo gitlab-ctl restart
     
    #禁用GitLab开机自启动：
    sudo systemctl disable gitlab-runsvdir
     
    #启用GitLab开机自启动：
    sudo systemctl enable gitlab-runsvdir

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70]: /images/20221022/51d71ca0df1c4667a52673bf1a8dc48c.png
[https_about.gitlab.com]: https://about.gitlab.com/
[https_packages.gitlab.com_gitlab_raspberry-pi2]: https://packages.gitlab.com/gitlab/raspberry-pi2
[https_packages.gitlab.com_gitlab_raspberry-pi2_packages_debian_jessie_gitlab-ce_8.13.0-ce.0_armhf.deb]: https://packages.gitlab.com/gitlab/raspberry-pi2/packages/debian/jessie/gitlab-ce_8.13.0-ce.0_armhf.deb
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 1]: /images/20221022/e70f65961579407da7def6b4fe3fbbf8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 2]: /images/20221022/499413667e694bdfad02505a6d4bedc2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 3]: /images/20221022/65647ec160c74c3b91ba504bffe96ae1.png
[20210406142704707.png]: /images/20221022/47e2ceb8f90c48f8974c63715594db38.png
[2021040614274813.png]: /images/20221022/5acfc10656a84418b33169168c7ce8d8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 4]: /images/20221022/baaf81ce7e704c2dbcdc40912f716a49.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 5]: /images/20221022/a78f6b0db0b24840909095495e54b8e8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 6]: /images/20221022/ce3670e141ac49189544870875b6034e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 7]: /images/20221022/096b500329d040b18181f859fa4fa6ed.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 8]: /images/20221022/e424503dc39d45f2808720d447e22dd0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 9]: /images/20221022/73da981b386e4b60bcfc129de2017036.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 10]: /images/20221022/8de1ea8ff00f429b99604245cc45b929.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 11]: /images/20221022/86228cfbe1ad4aeaaba5e3fce4fed073.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 12]: /images/20221022/6ef1434fb394478ca46bb3a09ce9da44.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 13]: /images/20221022/599c09eb174e45c5905171b246e16208.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 14]: /images/20221022/0bede895ea784154a1e99a1c55d16043.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d6X2NvbWluZw_size_16_color_FFFFFF_t_70 15]: /images/20221022/c5e18c5294d1424ba8f6b6aa131f2eb0.png