JiHu 版本

极狐GitLab 许可其技术给一个新的独立的中国公司，称为极狐。这个独立公司将帮助推动极狐GitLab 完整 DevOps 平台在中国的采用，并促进极狐GitLab 社区和开源贡献。

有关更多信息，请参阅常见问题解答。

前提条件#

在安装极狐GitLab 版之前，至关重要的是查看系统要求。系统要求包括支持极狐GitLab 的最低硬件、软件、数据库和其他要求的详细信息。

一旦您与极狐签订合同，极狐代表将联系您，并向您提供可以在安装过程中使用的许可证。

安装或更新极狐版软件包#

如果您是第一次安装，您必须传递 `EXTERNAL_URL=""` 变量以设置您的首选域名。安装会自动配置并在该 URL 启动极狐GitLab。启用 HTTPS 需要[额外配置](settings/nginx.md#enable-https)以指定证书。

请参阅极狐GitLab 版安装页面以获取有关安装或更新极狐版软件包的更多详细信息。

设置初始密码并应用许可证#

首次安装极狐GitLab 版时，您将被重定向到密码重置屏幕。提供初始管理员账户的密码，然后您将被重定向回登录屏幕。使用默认账户的用户名 root 登录。

有关详细说明，请参阅安装和配置。

此外，您可以导航到服务器的极狐GitLab 管理面板，并上传您的极狐版许可证文件。

更新极狐GitLab 企业版至极狐版#

要将使用 Linux 软件包安装的现有 GitLab 企业版 (EE) 服务器更新至极狐GitLab 版 (JH)，您需要在 EE 上安装极狐版 (JH) 软件包。

可用选项包括：

（推荐）从相同版本的 EE 更新到 JH。
从较低版本的 EE 更新到较高版本的 JH，前提是这是支持的升级路径（例如，EE 17.5.5 到 JH 18.1.3）。

在以下步骤中，我们假设您正在更新相同版本（例如，EE 17.5.5 到 JH 17.5.5）。

要更新 EE 到 JH：

如果您使用 deb/rpm 软件包安装 GitLab：
1. 创建一个备份。
2. 找到当前安装的 GitLab 版本：
  
  对于 Debian/Ubuntu
```
shell
sudo apt-cache policy gitlab-ee | grep Installed
```
  输出应类似于 Installed: 17.5.5-ee.0，因此安装的版本是 17.5.5-ee.0。
  
  对于 CentOS/RHEL
```
shell
sudo rpm -q gitlab-jh
```
  输出应类似于 gitlab-ee-17.5.5-ee.0.el8.x86_64，因此安装的版本是 17.5.5-ee.0。
3. 按照与安装极狐版软件包相同的步骤为您的操作系统进行安装，并确保选择与前一步中注意到的版本相同。将 <url> 替换为您的软件包 URL。
4. 重新配置极狐GitLab：
```
shell
sudo gitlab-ctl reconfigure
```
5. 转到服务器的极狐GitLab 管理面板 (/admin/application_settings/general#js-add-license-toggle) 并上传您的极狐版许可证文件。如果在更新到极狐之前已经安装了 EE 许可证，那么在安装 JH 时，EE 许可证会自动失效。
6. 确认极狐GitLab 运行正常，然后移除旧的企业版软件包库：
  
  对于 Debian/Ubuntu
```
shell
sudo rm /etc/apt/sources.list.d/gitlab-ee.list
```
  对于 CentOS/RHEL
```
shell
sudo rm /etc/yum.repos.d/gitlab-ee.repo
sudo dnf config-manager --disable gitlab-ee
```
如果您使用 Docker 安装极狐GitLab：
1. 按照Docker 更新指南进行操作，并将 gitlab/gitlab-ee:latest 替换为以下内容：
```
shell
registry.gitlab.com/gitlab-jh/omnibus-gitlab/gitlab-jh:<version>
```
  其中 <version> 是当前安装的极狐GitLab 版本，您可以使用以下命令找到：
```
shell
sudo docker ps | grep gitlab/gitlab-ee | awk '{print $2}'
```
  输出应类似于：gitlab/gitlab-jh:17.5.5-jh.0，因此在这种情况下，<version> 等于 17.5.5。
2. 转到服务器的极狐GitLab 管理面板 (/admin/application_settings/general#js-add-license-toggle) 并上传您的极狐版许可证文件。如果在更新到极狐之前已经安装了 EE 许可证，那么在安装 JH 时，EE 许可证会自动失效。

就是这样！您现在可以使用极狐GitLab 版了！要更新到较新版本，请参阅安装或更新极狐版软件包。