概述
GitLab 是我在日常工作中使用的代码仓库管理系统,它带有非常友好的 Web 界面,并且功能丰富。下面将介绍我在 CentOS 7 上搭建 GitLab 的步骤,以及遇到的一些问题。
关于不同 Git 仓库管理系统的对比,可参考这里,你会发现目前 GitLab 是最受欢迎的。
CentOS 7 搭建 GitLab
如果你使用的是 Windows 系统,可通过虚拟机 VMware 安装 CentOS,进而搭建 GitLab。
关于如何在 CentOS 7 上搭建 GitLab,官方教程在这里,下面是详细说明。
(一) SSH
安装 ssh
sudo yum install -y curl policycoreutils-python openssh-server
将 ssh 服务设为开机自启动
sudo systemctl enable sshd
开启 ssh 服务
sudo systemctl start sshd
(二) 防火墙
安装防火墙,如果已安装了防火墙,则可跳过这一步
yum install firewalld systemd -y
开启防火墙
service firewalld start
将 http 和 https 添加到防火墙,permanent 表示永久生效
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
重启防火墙
sudo systemctl reload firewalld
(三) Postfix
Postfix 用于发送通知邮件。如果你想使用其它方法来发送邮件,可以跳过这个步骤,在 GitLab 安装完成后配置 SMTP 服务。
以下分别是安装、设为自启动以及开启
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
(四) 安装 GitLab
wget 用于下载 GitLab 安装包,不过你也可以用其它方式下载
yum -y install wget
你可能还需要安装 vim,后面通过它来修改 GitLab 的配置文件
yum install vim -y
下载 GitLab 安装包,可以从官方提供的下载页面下载,也可以从清华大学开源软件镜像站下载,可能镜像站的下载速度会快点
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-11.11.8-ce.0.el7.x86_64.rpm
安装 GitLab
rpm -i gitlab-ce-11.11.8-ce.0.el7.x86_64.rpm
(五) 修改配置
等待安装完成后,终端界面会提示你修改 /etc/gitlab/gitlab.rb
文件,通过设置 external_url
l来配置你的 URL,通常情况下是你的服务器 ip 和端口号。
vim /etc/gitlab/gitlab.rb
终端界面还提示你通过下面的命令重新配置 GitLab
sudo gitlab-ctl reconfigure
到此为止,你在 CentOS 中的浏览器打开 http://localhost 或者 ip 及端口号,便可以看到 GitLab 的页面了。
常见问题
(一) 设置静态 IP
每次重启电脑之后,电脑在网络中的 IP 可能会发生变化,为此,我们需要设置一个静态 IP。
在 CentOS 7 中,通过以下命令编辑网络配置:
vim /etc/sysconfig/network-scripts/ifcfg-ens33
修改如下(仅供参考,根据你局域网的实际情况来配置),注意其中加注释的几处
PROXY_METHOD=none
BROWSER_ONLY=no
BOOTPROTO=static # 使用静态IP地址,默认是dhcp
IPADDR=192.168.5.122 # 设置的静态IP
NETMASK=255.255.255.0 # 子网掩码
GATEWAY=192.168.5.2 # 网关
DNS1=192.168.5.2 # DNS服务器
DEFROUTE=yes
IPV4_FAILURE_FATAL=no
IPV6INIT=yes
IPV6_AUTOCONF=yes
IPV6_DEFROUTE=yes
IPV6_FAILURE_FATAL=no
IPV6_ADDR_GEN_MODE=stable-privacy
NAME=ens33
UUID=8df5a6e0-cba0-4f89-b55c-319d2616a985
DEVICE=ens33
ONBOOT=yes
ZONE=public
重启网络服务使修改后的配置生效
service network restart
如果你使用的是 Windows系统 + VMware 虚拟机,并且网络适配器选择了“NAT模式”,那么需要配置网络端口转发,将主机的端口与虚拟机的端口关联起来,今后访问主机 IP 便可间接访问到虚拟机中的 GitLab。
(二) GitLab 中的时区不对
解决办法:参考这里。
(三) 如何汉化
解决办法:参考这里。
(四) Windows 系统 + VMware 相关
- 虚拟机无法开启,提示 VMware Workstation 15 与 Device/Credential Guard 不兼容。
解决办法:关闭 Hyper-V,参考这里。 - 局域网内其它电脑无法访问。
解决办法:可能需要开放 Windows端口,参考这里。
关于 Windows + Docker
我在网上搜寻在 Windows 中搭建 GitLab 的方法时,发现有使用 Docker 的方法,比如这篇:win10企业版在docker上部署gitlab,按照教程一步一步确实是可以运行 GitLab 并且可访问的。
首先安装 docker for windows,接下来在 Docker 中搭建 GitLab,参考这里。
然而,这种方式是存在风险的。GitLab 官方文档中并不推荐,主要因为存储权限和其它一些未知问题,最严重的是它不支持持久化存储,当你的服务器重启之后,所有数据都会丢失。
所以,这种方法目前可能是不可取的(也许有解决办法但是我不知道)。
参考文章
在写这篇教程时,参考了如下的一些文章: