如何在Debian 9上安装GitLab社区版（CE）11.x

• 先决条件
• 步骤1：执行托管GitLab CE的基本任务
• 步骤2：安装所需的依赖项
• 步骤3：设置GitLab APT存储库，然后安装GitLab CE
• 步骤4：通过集成“加密我们的SSL”证书来启用HTTPS访问

自从GitHub被Microsoft收购以来，许多开发人员已计划将自己的代码存储库从github.com迁移到替代的自托管解决方案。GitLab社区版（CE）是最常见的选择。

作为一种复杂而灵活的解决方案，可以使用多种方法来部署GitLab CE，但是这里仅涵盖官方推荐的方法，即Omnibus软件包安装。

先决条件

• 至少具有4GB内存的新鲜Vultr Debian 9 x64服​​务器实例。建议为最多100个用户使用8GB或更多空间。假设其IPv4地址为203.0.113.1。
• 一个sudo的用户。
• 域gitlab.example.com指向上述实例。

注意： 在自己的服务器实例上进行部署时，请确保将所有示例值替换为实际值。

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

启动SSH终端，并以sudo用户身份登录到Debian 9 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 i\203.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. 按TAB以突出显示<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 。

注意： 除了上述说明以外，您还需要提交支持票证以取消SMTP端口25上Vultr的默认阻止。

另外，如果您要使用其他消息传递解决方案，只需跳过安装Postfix并选择在安装GitLab CE之后使用外部SMTP服务器。

步骤3：设置GitLab APT存储库，然后安装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

安装可能需要一段时间。

最后，将您喜欢的Web浏览器指向http://gitlab.example.com，然后根据提示提交新密码以完成安装。

从现在开始，使用下面的凭据以管理员身份登录：

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

步骤4：通过集成“加密我们的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'] = ['[email protected]']

保存并退出：

:wq!

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

sudo gitlab-ctl reconfigure

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

重新配置完成后，在访问GitLab站点时，所有用户将被迫使用HTTPS协议。

注意： 从HTTP切换到HTTPS后，旧版Cookie可能会导致GitLab 422错误。清除Cookie可解决此问题。