在Ubuntu 18.04上,如何安装GitLab Community Edition (CE )11.x

・7 分钟阅读

使用不同的系统?

由于GitHub被微软收购,不少开发人员计划将他们自己的代码库从github.com迁移到另一种自托管解决方案。GitLab社区版(CE )是最常见的选择。

作为一种复杂而灵活的解决方案,GitLab CE可以使用各种方法进行部署,但是,我们在此处介绍的,只有官方推荐的方法--即Omnibus软件包安装。

前提条件

  • 全新Ubuntu 18.04的x64服务器实例,有至少4GB内存,建议使用8GB或更大容量,最多可为100个用户提供服务,它的IPv4地址是203.0.113.1 ,
  • 一个sudo用户
  • 指向上面提到的实例的域gitlab.example.com

注意:在自己的服务器实例上部署时,请务必将所有示例值替换为实际值。

步骤1:执行承载Gitlab CE的基本任务

启动SSH终端,并以sudo用户身份登录到Ubuntu 18.04的x64服务器实例。

添加交换分区并调整swappiness设置

当在有4GB内存的计算机上部署GitLab CE 11.x时,需要设置4GB交换分区以便平稳运行:


sudo dd if=/dev/zero of=/swapfile count=4096 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
free -m

注意:如果使用的服务器大小不同,交换分区的大小可能会有所不同。

出于系统性能目的,建议将内核的swappiness设置配置为低值,如10:


echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
cat /proc/sys/vm/swappiness

cat命令的输出为10

设置机器主机名和完全限定域名(FQDN )

使用以下命令设置主机的主机名gitlab和FQDN gitlab.example.com


sudo hostnamectl set-hostname gitlab
sudo sed -i"1 i203.0.113.1 gitlab.example.com gitlab" /etc/hosts

你可以确认结果:

 
hostname
hostname -f

 

修改防火墙规则

允许入站SSH,HTTP和HTTPS通信


sudo ufw allow OpenSSH
sudo ufw allow http
sudo ufw allow https
sudo ufw enable

更新系统


sudo apt update
sudo apt upgrade -y && sudo shutdown -r now

在升级期间,可能会被告知当前已安装的grub配置文件的版本已经在本地修改过,因为实际上没有修改,使用向上箭头突出显示install the package maintainer's version 选项,然后按ENTER键。

当系统再次运行,并且再次运行时,请以相同的sudo用户身份重新登录以继续。

步骤2:安装所需的依赖项

安装GitLab CE之前,需要安装所需的依赖项:


sudo apt install -y curl openssh-server ca-certificates

此外,如果要使用Postfix发送通知消息,则需要安装Postfix :


sudo apt install -y postfix

在安装过程中,可能会出现配置屏幕:

  1. 在第一个屏幕上按下<OK>按钮,然后按ENTER键,
  2. 选择Internet Site,并且按ENTER键,
  3. 对于mail name字段,输入服务器gitlab.example.com的FQDN,并且按ENTER ,
  4. 如果出现其他屏幕,按ENTER键接受默认设置,

启动并启用Postfix服务:


sudo systemctl enable postfix.service
sudo systemctl start postfix.service

修改Postfix的防火墙规则:


sudo ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

安装Postfix后,需要按照你的实际服务器设置编辑它主配置文件/etc/postfix/main.cf来配置Postfix 。

或者,如果你想使用另一个消息传递解决方案,只需跳过安装Postfix,并且在安装GitLab CE后使用外部SMTP服务器。

步骤3:设置GitLab APT repo,然后安装GitLab CE

在你的系统上设置GitLab CE APT库:


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

接下来,安装GitLab CE 11.x :


sudo EXTERNAL_URL="http://gitlab.example.com" apt install -y gitlab-ce

安装可能需要一段时间。

最后,将你喜爱的网页浏览器指向http://gitlab.example.com,然后提交一个新密码,提示你完成安装。

从现在开始,使用以下凭据以管理员身份登录:

  • 用户名:root
  • 密码:<your-new-password>

步骤4:通过集成let'sencrypt SSL证书启用HTTPS访问

目前,你已经在服务器实例上成功安装了GitLab CE 11.x,用户已经可以使用HTTP协议访问该站点了,为了安全起见,它建议通过集成let's Encrypt SSL证书来启用对GitLab服务器的HTTPS访问。

使用vi编辑器打开GitLab CE配置文件:


sudo vi /etc/gitlab/gitlab.rb

查找以下两行:


external_url 'http://gitlab.example.com'
# letsencrypt['contact_emails'] = [] # This should be an array of email addresses to add as contacts

相应地替换它们:


external_url 'https://gitlab.example.com'
letsencrypt['contact_emails'] = ['admin@example.com']

保存和退出:

 
:wq

 
!

使用更新的设置重新配置GitLab CE :


sudo gitlab-ctl reconfigure

重新配置可能需要一段时间。

完成重新配置后,所有用户在访问GitLab站点时都会被强制使用HTTPS协议。

注意:从HTTP切换到HTTPS后旧cookie可能会导致GitLab 422错误,,清除Cookies修复此问题。

Zuoxiaojuan profile image