Help us learn about your current experience with the documentation. Take the survey.

在 Amazon Linux 2 上安装 Linux 包

版本：Free, Premium, Ultimate
提供方式：GitLab Self-Managed

查看 supported platforms 获取完整的支持的发行版和架构列表。

前提条件

操作系统要求：
- Amazon Linux 2
查看 installation requirements 了解最低硬件要求。
开始之前，请确保您已正确设置您的 DNS，并将 https://gitlab.example.com 更改为您希望访问 GitLab 实例的 URL。安装会自动在该 URL 配置并启动 GitLab。
对于 https:// URL，GitLab 会自动使用 Let’s Encrypt 请求证书，这需要入站 HTTP 访问和有效的主机名。您也可以使用您自己的证书，或者仅使用 http://（不带 s）作为未加密的 URL。

启用 SSH 并打开防火墙端口

为了打开所需的防火墙端口（80, 443, 22）并能够访问 GitLab：

启动并启用 OpenSSH 服务器守护进程：
```
sudo systemctl enable --now sshd
```

安装 firewalld 后，打开防火墙端口：

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

添加 GitLab 包仓库

要安装 GitLab，首先需要添加 GitLab 包仓库。

安装所需的包：
```
sudo yum install -y curl
```

使用以下脚本添加 GitLab 仓库（您可以将脚本的 URL 粘贴到浏览器中查看其功能，然后再通过管道传递给 bash）：

curl "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh" | sudo bash

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

安装包

使用系统的包管理器安装 GitLab。您可以通过在安装前配置环境变量来自定义初始设置。

如果在安装期间不自定义 root 凭据：

GitLab 会为 root 管理员账户生成一个随机密码和电子邮件地址。
密码会存储在 /etc/gitlab/initial_root_password 中 24 小时。
24 小时后，出于安全原因，该文件会被自动删除。

虽然您也可以通过设置 gitlab_rails['initial_root_password'] = "password" 来在 /etc/gitlab/gitlab.rb 中设置初始密码，但不推荐这样做。如果您使用此方法设置密码，请确保从 /etc/gitlab/gitlab.rb 中删除密码，因为它只在安装包后的第一次重新配置时被读取。

可用的环境变量

您可以通过设置以下可选的环境变量来自定义您的 GitLab 安装。 这些变量仅在第一次安装时有效，对后续的重新配置运行没有影响。对于现有安装，请使用 /etc/gitlab/initial_root_password 中的密码或重置 root 密码。

变量	用途	必需性	示例
`EXTERNAL_URL`	设置 GitLab 实例的外部 URL	推荐	`EXTERNAL_URL="https://gitlab.example.com"`
`GITLAB_ROOT_EMAIL`	root 管理员账户的自定义电子邮件	可选	`GITLAB_ROOT_EMAIL="[email protected]"`
`GITLAB_ROOT_PASSWORD`	root 管理员账户的自定义密码（至少 8 个字符）	可选	`GITLAB_ROOT_PASSWORD="strongpassword"`

如果在安装期间 GitLab 无法检测到有效的主机名，重新配置将不会自动运行。在这种情况下，将任何需要的环境变量传递给您的第一个 gitlab-ctl reconfigure 命令。

安装命令

选择您的 GitLab 版本，并使用上述环境变量进行自定义：

基本安装：

sudo EXTERNAL_URL="https://gitlab.example.com" yum install gitlab-ee

使用自定义 root 凭据：

sudo GITLAB_ROOT_EMAIL="[email protected]" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" yum install gitlab-ee

基本安装：

sudo EXTERNAL_URL="https://gitlab.example.com" yum install gitlab-ce

使用自定义 root 凭据：

sudo GITLAB_ROOT_EMAIL="[email protected]" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" yum install gitlab-ce

设置您的通信偏好

访问我们的邮件订阅偏好中心告诉我们何时与您联系。我们采用明确的邮件订阅政策，让您完全控制我们向您发送邮件的内容和频率。

每月两次，我们会发送您需要了解的 GitLab 新闻，包括新功能、集成、文档以及我们开发团队的幕后故事。有关与错误和系统性能相关的关键安全更新，请订阅我们的专门安全通讯。

如果您不订阅安全通讯，您将不会收到安全警报。