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

在 AlmaLinux 和 RHEL 兼容发行版上安装 Linux 包

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed

查看 支持的平台 以获取完整的支持发行版和架构列表。

先决条件

  • 操作系统要求：
    • AlmaLinux 8
    • AlmaLinux 9
    • Red Hat Enterprise Linux 8
    • Red Hat Enterprise Linux 9
    • Oracle Linux 8
    • Oracle Linux 9
    • 任何与支持的 Red Hat Enterprise Linux 版本兼容的发行版
  • 查看 安装要求 了解最低硬件要求。
  • 开始之前，请确保您已正确 设置您的 DNS， 并将 https://gitlab.example.com 更改为您希望访问 GitLab 实例的 URL。安装程序会自动在该 URL 配置并启动 GitLab。
  • 对于 https:// URL，GitLab 会自动 请求 Let’s Encrypt 证书， 这需要入站 HTTP 访问和有效的主机名。您也可以使用 您自己的证书， 或者仅使用 http://（不带 s）作为未加密的 URL。

启用 SSH 并打开防火墙端口

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

  1. 启动并启用 OpenSSH 服务器守护进程：

    sudo systemctl enable --now sshd

  2. 安装了 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 包仓库。

  1. 安装所需的包：

    sudo dnf install -y curl

  2. 使用以下脚本添加 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="admin@example.com"
GITLAB_ROOT_PASSWORD root 管理员账户的自定义密码（最少 8 个字符） 可选 GITLAB_ROOT_PASSWORD="strongpassword"

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

安装命令

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

基本安装：

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

使用自定义 root 凭据：

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" dnf install gitlab-ee

基本安装：

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

使用自定义 root 凭据：

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" dnf install gitlab-ce

设置您的通信偏好

访问我们的 电子邮件订阅偏好中心 告诉我们何时与您联系。我们采用明确的电子邮件选择加入政策，因此您可以完全控制我们向您发送邮件的内容和频率。

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

如果您不选择加入安全通讯，您将不会收到安全警报。

建议的后续步骤

完成安装后，请考虑 建议的后续步骤，包括身份验证选项和注册限制。