GitLab在CentOS上的使用疑难解答

在CentOS上安装和配置GitLab是一个相对复杂的过程，但以下步骤可以帮助你顺利完成安装。

安装GitLab的步骤

1. 安装依赖包：

sudo yum update
sudo yum install -y curl policycoreutils-python openssh-server openssh-client postfix wget vim

2. 设置SSH服务：

sudo systemctl enable sshd
sudo systemctl start sshd

3. 配置防火墙：

sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

4. 添加GitLab镜像源并安装：

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
sudo yum install gitlab-ce

5. 配置并启动GitLab：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

6. 访问GitLab：

在浏览器中输入服务器的IP地址，你应该能够看到GitLab的登录页面。使用默认的管理员账户（root）登录，并设置新密码。

常见问题及解决方法

• 端口冲突：如果在安装过程中遇到端口冲突，可以修改GitLab的默认端口。编辑 /etc/gitlab/gitlab.rb 文件，找到以下行并修改为所需的端口号：

  gitlab_rails['gitlab_shell_ssh_port'] = 1234
  

  然后重新配置并启动GitLab：

  sudo gitlab-ctl reconfigure
  sudo gitlab-ctl restart
  

• 邮件服务配置：确保Postfix邮件服务已正确配置。编辑 /etc/postfix/main.cf 文件，设置正确的主机名和域名。然后启动并启用Postfix服务：

  sudo systemctl start postfix
  sudo systemctl enable postfix
  

• 防火墙设置：确保防火墙允许GitLab使用的端口（默认为80和443）。使用以下命令打开端口：

  sudo firewall-cmd --permanent --zone=public --add-port=80/tcp
  sudo firewall-cmd --permanent --zone=public --add-port=443/tcp
  sudo firewall-cmd --reload
  

• 修改外部URL：如果需要修改GitLab的外部URL，编辑 /etc/gitlab/gitlab.rb 文件，找到以下行并修改为所需的主机名和端口：

  external_url 'http://your_server_ip:port'
  

  然后重新配置并启动GitLab：

  sudo gitlab-ctl reconfigure
  sudo gitlab-ctl restart
  

• SSH密钥配置：为了使用SSH方式访问GitLab，需要在本地生成SSH密钥，并将公钥添加到GitLab。使用以下命令生成SSH密钥：

  ssh-keygen -t rsa -C "your_email@example.com"
  

  将生成的公钥（~/.ssh/id_rsa.pub）添加到GitLab的SSH密钥管理中。

配置中文界面

1. 登录GitLab：使用管理员账户登录GitLab。
2. 设置语言：点击右上角的用户头像，选择“Settings”（设置）。
3. 本地化设置：在左侧菜单栏中选择“Preferences”，然后在“Localization”（本地化）区域，将“English”选项改为“中文（简体）”，然后点击“Save changes”（保存更改）。

使用Docker安装GitLab

如果你希望使用Docker来安装GitLab，可以按照以下步骤进行：

1. 拉取GitLab镜像：

docker pull gitlab/gitlab-ce:latest

2. 配置挂载目录：创建并挂载所需的目录：

mkdir /usr/local/gitlab
mkdir /usr/local/gitlab/config
mkdir /usr/local/gitlab/logs
mkdir /usr/local/gitlab/data

3. 创建并运行容器：

docker run --detach \
  --hostname gitlab.example.com \
  --publish 8929:8929 \
  --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /usr/local/gitlab/config:/etc/gitlab \
  --volume /usr/local/gitlab/logs:/var/log/gitlab \
  --volume /usr/local/gitlab/data:/var/opt/gitlab \
  --shm-size 256m \
  gitlab/gitlab-ce:latest

4. 访问GitLab：在浏览器中输入 http://gitlab.example.com:8929，使用默认的管理员账户（root）登录，并设置新密码。

通过以上步骤，你应该能够在CentOS上成功安装和配置GitLab。如果在安装过程中遇到任何问题，请参考GitLab的官方文档或相关的技术论坛寻求帮助。