树莓派从零开始搭建Gitlab服务器_树莓派安装gitlab

提示：本文面向新手，可以放心阅读。

---

前言

如今树莓派价格居高不下，软路由流行是一个原因。更多是物联网，人工智能，物联网进入了各位技术爱好者的视野。从51单片机，Arduino，NodeMCU，再到树莓派，英伟达JETSON，阿里云IoT HaaS EDU等等。
本篇方向就不在IoT，AI，大数据方向展开，在树莓派搭建代码服务器GitLab-CE，实现居家的低功耗代码私服。

---

提示：以下操作均基于树莓派4B，系统基于官网的arm64位镜像:2022-01-28-raspios-bullseye-arm64-lite，其他版本的请自行类比型号和系统版本

一、安装树莓派系统

安装系统是基操，通过阅读本文，希望可以避免遇到奇怪的问题。

1. 下载64位系统

到官网的系统下载页，找到下方的“Raspberry Pi OS (64-bit)”，在右侧下载需要的系统版本，这里推荐Raspberry Pi OS Lite。

2. 下载烧录工具烧录系统

树莓派官方网站有提供烧录工具，这里推荐使用balenaEtcher，软件简介易用，属于新手福音。可以到官网下载免安装的版本直接运行。

开始烧录

1. 将插有tf卡的读卡器插到电脑上的USB口
2. 双击运行balenaEtcher
3. 选择下载好的固件2022-01-28-raspios-bullseye-arm64-lite.zip
4. 开始烧录

步骤通常是校验文件完整性，烧录，验证完整性，完成。这个过程的快慢取决于以下几个方面：

• 电脑USB口速度，usb3.0及以上更佳
• 读卡器USB口速度，支持USB3.0及以上更佳
• TF卡速度，u3及以上更佳，有条件直接买v30或v60或v90，会有惊喜
• 硬盘读写速度，以及当前系统的IO占用情况

以上都是说给新手听的，老手请无视。

无屏访问树莓派SSH

刚装完系统，有时我们没有合适的视频线，又或者microHDMI转HDMI线缆恰巧不在身边，访问系统有困难，如需实现在不插屏幕和键盘的情况下访问树莓派SSH终端，通常可以这样操作：

• 在烧录完成后，拔出读卡器重新插入电脑，让电脑可以识别出boot设备。
• 在根目录下创建文本文档，命名为ssh，注意不需要后缀名
• 在根目录下创建文本文档wpa_supplicant.conf，按以下内容进行编辑并保存
• 断电重启树莓派，稍等片刻在路由器中查看联网的树莓派设备
  以下是wpa_supplicant.conf配置文件的内容，用来自动连接无线网络，如果插上了有线网络，可忽略这步。

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=CN
 
network={
	ssid="无线信号名称，2.4G或5G均可"
	psk="无线连接的密码"
	key_mgmt=WPA-PSK
}
1
2
3
4
5
6
7
8
9

在路由器中找到raspberrypi的主机名（如果没有多个树莓派接入），通过ip地址，使用ssh客户端工具进行连接即可。

ssh pi@ip地址
#默认密码：raspberry
1
2

二、Docker环境的安装和镜像拉取

1.一键安装docker

建议使用root账户完成docker的安装：

sudo -i
# 输入树莓派密码，默认raspberry
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
# 静静等待安装完成，完成后如果想让pi用户也可以执行docker命令，可以继续执行
usermod -aG docker pi
1
2
3
4
5

2.拉取镜像

面向新手向，就不要自己编译镜像了，直接使用大神的公共镜像就行：

docker pull yrzr/gitlab-ce-arm64v8:latest
1

该镜像大小超过了1Gb，确保本地网络环境可以访问https://hub.docker.com/，网速越快越好。
拉取完成后，可以通过docker images查看镜像是否成功下载下来了

pi@raspberrypi:~ $ docker images
REPOSITORY               TAG       IMAGE ID       CREATED      SIZE
yrzr/gitlab-ce-arm64v8   latest    c935bfe114bf   5 days ago   2.41GB
1
2
3

三、配置并启动gitlab-ce

本文的主机名默认是git.cha1024.com，各位可以通过自己的实际情况进行配置主机名和域名。

1.创建宿主机目录

mkdir -p /opt/data/gitlab-ce/conf
mkdir -p /opt/data/gitlab-ce/logs
mkdir -p /opt/data/gitlab-ce/data
1
2
3

2.配置端口

由于树莓派启动了sshd服务，未配置的情况下，默认会占用22端口，为了gitlab访问地址的美观性，我们可以修改sshd的端口。

sudo vim /etc/ssh/sshd_config
# 找到#Port 22，另起一行，添加内容 
Port 2222
# 这样会将原来的22端口替换成2222端口，具体用什么端口合适，各位自行选择
# 按下ESC,直接输入:wq 进行保存操作即可
# 重启sshd服务
systemctl restart sshd
exit
1
2
3
4
5
6
7
8

这样配置之后，后续连接ssh终端务必使用新配置的端口。

3.启动容器

docker run \
  --detach \
  --name gitlab-ce \
  --restart always \
  --privileged \
  --memory 4096M \
  --publish 22:22 \
  --publish 80:80 \
  --publish 443:443 \
  --hostname git.cha1024.com \
  --volume /opt/data/gitlab-ce/conf:/etc/gitlab:z \
  --volume /opt/data/gitlab-ce/logs:/var/log/gitlab:z \
  --volume /opt/data/gitlab-ce/data:/var/opt/gitlab:z \
  yrzr/gitlab-ce-arm64v8:latest
1
2
3
4
5
6
7
8
9
10
11
12
13
14

以上配置映射了3个地址：

• /etc/gitlab : 配置文件目录，主要配置文件 gitlab.rb 保存在此
• /var/opt/gitlab ：运行和数据保存目录
• /var/log/gitlab : 日志目录

执行完毕后，可以使用docker ps查看运行的容器。
提示：由于树莓派的性能比常规服务器性能较弱，启动过程约耗时3分钟左右才能完成 ，需耐心等待

pi@raspberrypi:~ $ docker ps
CONTAINER ID   IMAGE                           COMMAND             CREATED       STATUS                       PORTS                                                                                                         NAMES
5b3698dff9d7   yrzr/gitlab-ce-arm64v8:latest   "/assets/wrapper"   4 mins ago   Up About an min (healthy)   0.0.0.0:22->22/tcp, :::22->22/tcp, 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   gitlab-ce
1
2
3

当看到类似上文的提示时，Gitlab服务已经启动完成。
可以打开浏览器访问：http://你的ip地址/，如果正常打开表示启动完成，如报错502，表示服务正在启动中，请稍后再试。

3.使用SSL证书，实现https访问

这个部分属于锦上添花的操作，对于一般的gitlab使用来说，上文就足够。

a.申请免费的ssl证书

自签名证书此处不展开，只说免费申请证书。
Let’s Encrypt
Let’s Encrypt的证书有效期90天，当然我不确定你在树莓派上能否使用这个gitlab达到90天，如果可以那就继续往下看。
你需要有一台有外网ip的服务器，如果已经有了，恭喜你可以白嫖。如果没有，可以按量付费创建一台云主机，预装lnmp环境有Let’s Encrypt插件的更好，如果没有可以安装宝塔，或者oneinstack等环境，均带有Let’s Encrypt插件，自行生成即可。生成后，创建网站，并使用Let’s Encrypt生成证书，证书包含一个pem和key文件。
DigiCert 免费版 SSL
DigiCert 免费版 SSL与很多云服务厂商有合作，例如阿里云。在阿里云后台，1个账号可以免费申请20个免费证书，每个证书有效期1年。操作比较人性化，当申请完成后，在列表右侧点击“下载”，选择nginx版本的证书即可。
这样你会得到1个压缩包，里面通常有2个文件，后缀分别是pem和key。

b.配置gitlab

可以在映射出来的conf文件夹中，找到gitlab.rb文件进行编辑。也可以进入容器，在容器中直接编辑gitlab.rb。
需要注意的是，启动过程中，我们publish了80和443端口，后文会基于这个配置进行说明。
打开gitlab.rb文件，找到以下配置处，解开配置修改，或另起一行进行配置。

external_url 'https://git.cha1024.com'
nginx['ssl_certificate'] = "/etc/ssl/git.cha1024.com.pem"
nginx['ssl_certificate_key'] = "/etc/ssl/git.cha1024.com.key"
nginx['redirect_http_to_https'] = true
1
2
3
4

以上配置gitlab.rb文件中的external_url为https地址，而且必需使用https，否则不会生效！同时还需要配置证书和https跳转才能完整体验SSL
配置完毕后，为了使配置生效，需要执行命令

docker exec -it [容器id或容器名] gitlab-ctl reconfigure
1

如果进入了容器内部，只需在内部执行gitlab-ctl reconfigure即可。
至此，配置ssl已经完成。基于本例的配置，在浏览器中访问 https://git.cha1024.com 即可访问，效果如下

---

总结

基于以上配置gitlab并运行，待机资源消耗cpu平均不超过5%，内存消耗3.55G。不建议4G及以下的树莓派做这个尝试。
如果有任何疑问，欢迎留言与我交流。