如何在Debian 9上安装Gitlab社区版CE 11.x

・10 分钟阅读

使用不同的系统?

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

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

前提条件

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

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

步骤1:执行托管GitLab CE的基本任务

启动一个SSH终端,并且以sudo用户身份登录你的Debian 9x64服务器实例。

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

当在有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

 

设置防火墙规则

设置合理的防火墙规则来运行网站:


sudo iptables -F
sudo iptables -X
sudo iptables -Z
sudo iptables -A INPUT -s $(echo $(w -h ${USER}) | cut -d"" -f3) -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -i lo -j ACCEPT
sudo iptables -A INPUT -d 127.0.0.0/8 -j REJECT
sudo iptables -A INPUT -p tcp ! --syn -m state --state NEW -j DROP
sudo iptables -A INPUT -p tcp --tcp-flags ALL NONE -j DROP
sudo iptables -A INPUT -p tcp --tcp-flags ALL ALL -j DROP
sudo iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -p icmp --icmp-type echo-request -j ACCEPT
sudo iptables -P INPUT DROP
sudo iptables -P OUTPUT ACCEPT
sudo iptables -P FORWARD DROP

以上所有设置将立即生效,使用以下命令列出它们以进行审阅:


sudo iptables -L -n

使用iptable-persistent工具将所有现有的iptables规则保存在一个文件/etc/iptables/rules.v4中,使所有iptables规则持久化:


sudo apt install -y iptables-persistent

在安装期间,会询问你是否要保存当前ipv4/ipv6规则,按两次ENTER键可将当前IPv4和IPv6规则同时保存到/etc/iptables/rules.v4/etc/iptables/rules.v6

如果稍后尝试更新IPv4规则,请使用以下选项保存更新:


sudo bash -c 'iptables-save > /etc/iptables/rules.v4'

更新系统


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

当系统再次运行,并且再次运行时,请以相同的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字段,输入服务器的FQDN,gitlab.example.com,然后按ENTER ,
  4. 如果出现其他屏幕,按ENTER键接受默认设置,

启动并启用Postfix服务:


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

修改Postfix的防火墙规则:


sudo iptables -A INPUT -i eth0 -p tcp --dport 25 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 143 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 993 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 110 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 995 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo bash -c 'iptables-save > /etc/iptables/rules.v4'

安装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