如何在Linux系统上搭建GitLab服务器？

在Linux系统上搭建GitLab服务器是一个涉及多个步骤的过程，包括准备工作、安装依赖、配置服务器、下载并安装GitLab软件包、启动GitLab服务以及访问GitLab，以下是详细的步骤说明：

一、准备工作

在开始部署GitLab之前，请确保你已经准备好一台满足以下要求的Linux服务器：

操作系统：推荐使用Ubuntu或CentOS等主流Linux发行版。

内存：至少2GB RAM（推荐4GB或更多）。

存储空间：至少20GB的可用存储空间（根据需求可适当增加）。

你还需要拥有root或sudo权限，以便在服务器上执行命令。

二、安装依赖

在部署GitLab之前，需要安装一些必要的依赖项，对于不同的Linux发行版，安装命令可能有所不同。

Ubuntu服务器

在Ubuntu服务器上，你可以使用以下命令安装依赖：

sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates postfix

CentOS服务器

在CentOS服务器上，你可以使用以下命令安装依赖：

sudo yum install -y curl openssh-server postfix
sudo yum install -y https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

三、配置服务器

你需要配置服务器以满足GitLab的要求，设置服务器的主机名，并确保服务器的防火墙允许HTTP（80端口）和HTTPS（443端口）的访问。

设置主机名（以Ubuntu为例）

sudo hostnamectl set-hostname gitlab-server
echo "127.0.0.1 gitlab-server" | sudo tee -a /etc/hosts

配置防火墙（以Ubuntu为例）

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

四、下载并安装GitLab软件包

GitLab提供了官方Docker镜像，我们可以通过Docker来安装GitLab，确保已经安装了Docker（如前所述），拉取GitLab的Docker镜像：

sudo docker pull gitlab/gitlab-ce:latest

五、配置GitLab

创建一个名为gitlab.yml的配置文件，用于配置GitLab的各项参数，以下是一个示例配置：

gitlab.yml
gitlab:
  OMNIBUS_GITLAB_EXTERNAL_URL: 'http://your_server_ip'
  OMNIBUS_GITLAB_POSTGRES_DATA_DIR: "/var/opt/gitlab/postgresql/data"
  OMNIBUS_GITLAB_POSTGRES_HOST: "localhost"
  OMNIBUS_GITLAB_POSTGRES_PORT: "5432"
  OMNIBUS_GITLAB_POSTGRES_USERNAME: "gitlab"
  OMNIBUS_GITLAB_POSTGRES_PASSWORD: "your_password"

请根据你的实际情况修改OMNIBUS_GITLAB_EXTERNAL_URL为你的服务器IP或域名，并设置PostgreSQL数据库的用户名和密码。

六、启动GitLab服务

在服务器上执行以下命令，启动GitLab服务：

docker run --detach 
  --hostname gitlab.example.com 
  --publish 443:443 --publish 80:80 --publish 22:22 
  --name gitlab 
  --restart always 
  --volume $GITLAB_HOME/config:/etc/gitlab 
  --volume $GITLAB_HOME/logs:/var/log/gitlab 
  --volume $GITLAB_HOME/data:/var/opt/gitlab 
  --volume /etc/localtime:/etc/localtime:ro 
  gitlab/gitlab-ce:latest

这里的$GITLAB_HOME是你为GitLab配置的一个目录，用于存放配置、日志和数据文件，你可以根据实际情况修改这个目录的路径。

七、访问GitLab

在浏览器中输入你的服务器IP或域名，即可显示GitLab的界面，首次登录会强制用户修改密码，密码修改成功后，输入用户名和密码进行登录。

八、GitLab常用命令

GitLab提供了一些常用的命令来管理GitLab服务，如启动、停止、重启和查看服务状态等：

gitlab-ctl start启动所有GitLab组件。

gitlab-ctl stop停止所有GitLab组件。

gitlab-ctl restart重启所有GitLab组件。

gitlab-ctl status查看服务状态。

gitlab-ctl reconfigure重新加载配置文件（注意：此命令在业务环境中不可随意使用，因为它会还原一些过去的config，导致修改的端口和域名等失效）。

九、GitLab的备份与恢复

GitLab支持创建备份和从备份中恢复，你可以使用以下命令来创建和恢复备份：

创建备份，备份文件将默认保存在/var/opt/gitlab/backups目录下。

从备份中恢复，请将1520580592_2018_03_09_10.5.3替换为你的实际备份文件名。

十、FAQs

Q1: 如何更改GitLab的默认端口？

A1: 要更改GitLab的默认端口（如HTTP的80端口和HTTPS的443端口），你需要编辑/etc/gitlab/gitlab.rb文件，找到以下行并修改为你想要的端口号：

external_url 'http://your_server_ip:new_http_port'
nginx['listen_port'] = new_https_port
nginx['listen_addresses'] = ['*']

然后运行gitlab-ctl reconfigure命令使更改生效，这样做可能会影响已存在的Webhooks和其他依赖于默认端口的服务。

Q2: 如果忘记GitLab管理员密码怎么办？

A2: 如果你忘记了GitLab管理员密码，可以通过以下步骤重置密码：

1、登录到GitLab服务器。

2、停止GitLab服务：gitlab-ctl stop。

3、找到GitLab配置文件（通常位于/etc/gitlab/gitlab.rb），查找default['gitlab_rails']['initial_root_password']行，这里保存了初始的root密码，如果没有这一行，可能是在安装过程中设置了密码但未记录，在这种情况下，你可能需要重新安装GitLab并记录下初始密码。

4、使用初始密码登录GitLab，然后立即更改密码。

5、重启GitLab服务：gitlab-ctl start。