GitLab 11 配置文档-DOKI SEKAI

GitLab 11 配置文档

1. GitLab 域名和端口配置

GitLab 允许通过配置文件 /etc/gitlab/gitlab.rb 来设置访问 GitLab 的域名和端口。以下是相关配置项的说明和操作步骤。

1.1 修改 `external_url` 配置

GitLab 的 external_url 配置项决定了 GitLab 的访问地址。该配置包括协议、域名/IP 和端口。

步骤：

打开 GitLab 配置文件：
```
sudo nano /etc/gitlab/gitlab.rb
```
找到 external_url 配置项并根据需要修改为你的域名和端口。以下是几种常见配置示例：
- 使用 HTTP 协议和域名（默认端口 80）：
```
external_url 'http://gitlab.yourdomain.com'
```
- 使用 HTTPS 协议和域名（默认端口 443）：
```
external_url 'https://gitlab.yourdomain.com'
```
- 使用自定义端口（如 8080）：
```
external_url 'http://gitlab.yourdomain.com:8080'
```
- 使用自定义端口和 HTTPS（如 4443）：
```
external_url 'https://gitlab.yourdomain.com:4443'
```
保存配置文件并退出编辑器。

1.2 配置端口

GitLab 使用以下默认端口：

HTTP: 80
HTTPS: 443
SSH: 22（用于 Git 克隆和推送）

如果需要修改端口，请在配置文件中进行相应更改。

步骤：

在 /etc/gitlab/gitlab.rb 中修改以下配置项：

设置 HTTP 和 HTTPS 端口：

nginx['listen_port'] = 8080   # 设置 HTTP 端口
nginx['listen_https'] = 4443  # 设置 HTTPS 端口

设置 GitLab SSH 端口（用于 Git 操作）：

gitlab_rails['gitlab_shell_ssh_port'] = 2222  # 修改 SSH 端口

保存并关闭文件。

2. 常用 GitLab 命令

GitLab 提供了多个命令行工具，用于管理和维护 GitLab 实例。以下是常用命令汇总。

2.1 重新配置 GitLab

配置文件修改后，需要执行此命令以应用新的配置。

sudo gitlab-ctl reconfigure

2.2 启动/停止/重启 GitLab 服务

启动 GitLab：
```
sudo gitlab-ctl start
```
停止 GitLab：
```
sudo gitlab-ctl stop
```
重启 GitLab：
```
sudo gitlab-ctl restart
```

2.3 检查 GitLab 服务状态

检查 GitLab 服务的运行状态，查看各个组件是否正常运行：

sudo gitlab-ctl status

2.4 查看 GitLab 日志

查看 GitLab 的日志文件以帮助诊断和排查问题。

查看 Nginx 错误日志：

sudo tail -f /var/log/gitlab/nginx/gitlab_error.log

查看 GitLab Rails 日志：

sudo tail -f /var/log/gitlab/gitlab-rails/production.log

查看后台作业日志：

sudo tail -f /var/log/gitlab/gitlab-rails/background_jobs.log

2.5 更新 GitLab

通过以下命令更新 GitLab 到最新版本：

sudo apt-get update
sudo apt-get install gitlab-ce

或使用 GitLab 内置的升级命令：

sudo gitlab-ctl upgrade

2.6 备份 GitLab 数据

创建 GitLab 的完整数据备份：

sudo gitlab-rake gitlab:backup:create

备份文件默认存储在 /var/opt/gitlab/backups/ 目录下。

2.7 恢复 GitLab 数据

恢复 GitLab 数据备份：

sudo gitlab-rake gitlab:backup:restore BACKUP=timestamp_of_backup

例如，恢复 1592398475 的备份：

sudo gitlab-rake gitlab:backup:restore BACKUP=1592398475

2.8 执行数据库迁移

当进行数据库修改时，需要执行数据库迁移命令：

sudo gitlab-rake db:migrate

2.9 清理 GitLab 缓存

清理 GitLab 的缓存，以确保配置和操作生效：

sudo gitlab-rake cache:clear

3. 配置文件修改后应用

在对 /etc/gitlab/gitlab.rb 配置文件进行修改后，必须重新应用配置，以使更改生效。执行以下命令：

sudo gitlab-ctl reconfigure

该命令会重新加载 GitLab 配置，并确保所有修改的配置项都被正确应用。

总结

本文档提供了 GitLab 11 版本的域名和端口配置方法，以及常用的管理命令。这些操作是配置 GitLab 实例的基本步骤。务必在修改配置文件后执行 gitlab-ctl reconfigure 以确保更改生效。如需执行复杂的管理任务，可参考相关命令以进行相应操作。

目录CONTENT

GitLab 11 配置文档