linux-tutorial/docs/linux/soft/gitlab-ops.md

# Gitlab 运维

## 一、gitlab 安装

### Gitlab 的普通安装

#### 下载

进入官方下载地址：https://about.gitlab.com/install/ ，如下图，选择合适的版本。

![img](http://dunwu.test.upcdn.net/snap/20190129155838.png!zp)

以 CentOS7 为例：

#### 安装和配置必要依赖

在系统防火墙中启用 HTTP 和 SSH

```
sudo yum install -y curl policycoreutils-python openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo systemctl reload firewalld
```

安装 Postfix ，使得 Gitlab 可以发送通知邮件

```
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
```

#### 添加 Gitlab yum 仓库并安装包

添加 Gitlab yum 仓库

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

通过 yum 安装 gitlab-ce

```
sudo EXTERNAL_URL="http://gitlab.example.com" yum install -y gitlab-ce
```

安装完成后，即可通过默认的 root 账户进行登录。更多细节可以参考：[documentation for detailed instructions on installing and configuration](https://docs.gitlab.com/omnibus/README.html#installation-and-configuration-using-omnibus-package)

### Gitlab 的 Docker 安装

拉取镜像

```
docker pull docker.io/gitlab/gitlab-ce
```

启动

```
docker run -d \
    --hostname gitlab.zp.io \
    --publish 8443:443 --publish 80:80 --publish 2222:22 \
    --name gitlab \
    --restart always \
    --volume $GITLAB_HOME/config:/etc/gitlab \
    --volume $GITLAB_HOME/logs:/var/log/gitlab \
    --volume $GITLAB_HOME/data:/var/opt/gitlab \
    gitlab/gitlab-ce
```

![img](http://dunwu.test.upcdn.net/snap/20190131150515.png!zp)

### 自签名证书

首先，创建认证目录

```
sudo mkdir -p /etc/gitlab/ssl
sudo chmod 700 /etc/gitlab/ssl
```

（1）创建 Private Key

```
sudo openssl genrsa -des3 -out /etc/gitlab/ssl/gitlab.domain.com.key 2048
```

会提示输入密码，请记住

（2）生成 Certificate Request

```
sudo openssl req -new -key /etc/gitlab/ssl/gitlab.domain.com.key -out /etc/gitlab/ssl/gitlab.domain.com.csr
```

根据提示，输入信息

```
Country Name (2 letter code) [XX]:CN
State or Province Name (full name) []:JS
Locality Name (eg, city) [Default City]:NJ
Organization Name (eg, company) [Default Company Ltd]:xxxxx
Organizational Unit Name (eg, section) []:
Common Name (eg, your name or your server's hostname) []:gitlab.xxxx.io
Email Address []:

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:
```

（3）移除 Private Key 中的密码短语

```
sudo cp -v /etc/gitlab/ssl/gitlab.domain.com.{key,original}
sudo openssl rsa -in /etc/gitlab/ssl/gitlab.domain.com.original -out /etc/gitlab/ssl/gitlab.domain.com.key
sudo rm -v /etc/gitlab/ssl/gitlab.domain.com.original
```

（4）设置文件权限

```
sudo chmod 600 /etc/gitlab/ssl/gitlab.domain.com.*
```

## 二、gitlab-ci-multi-runner 安装

> 参考：https://docs.gitlab.com/runner/install/

### 常规安装 gitlab-ci-multi-runner

#### 下载

```
sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
```

#### 配置执行权限

```
sudo chmod +x /usr/local/bin/gitlab-runner
```

#### 如果想使用 Docker，安装 Docker（可选的）

```
curl -sSL https://get.docker.com/ | sh
```

#### 创建 CI 用户

```
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
```

#### 安装并启动服务

```
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start
```

#### 注册 Runner

（1）执行命令：

```
sudo gitlab-runner register
```

（2）输入 Gitlab URL 和 令牌

URL 和令牌信息在 Gitlab 的 Runner 管理页面获取：

![img](http://dunwu.test.upcdn.net/snap/20190129163100.png!zp)

```
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com )
https://gitlab.com

Please enter the gitlab-ci token for this runner
xxx
```

（3）输入 Runner 的描述

```
 Please enter the gitlab-ci description for this runner
 [hostame] my-runner
```

（4）输入 Runner 相关的标签

```
 Please enter the gitlab-ci tags for this runner (comma separated):
 my-tag,another-tag
```

（5）输入 Runner 执行器

```
 Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell:
 docker
```

如果想选择 Docker 作为执行器，你需要指定默认镜像（ `.gitlab-ci.yml` 中没有此配置）

```
 Please enter the Docker image (eg. ruby:2.1):
 alpine:latest
```

### Docker 安装 gitlab-ci-multi-runner

拉取镜像

```
docker pull docker.io/gitlab/gitlab-runner
```

启动

```
docker run -d --name gitlab-runner --restart always \
   -v /srv/gitlab-runner/config:/etc/gitlab-runner \
   -v /var/run/docker.sock:/var/run/docker.sock \
   gitlab/gitlab-runner:latest
```

## 三、gitlab 配置

### 基本配置

```
sudo vim /etc/gitlab/gitlab.rb
external_url 'https://gitlab.domain.com'
```

#### gitlab 网站 https：

```
nginx['redirect_http_to_https'] = true
```

#### gitlab ci 网站 https：

```
ci_nginx['redirect_http_to_https'] = true
```

#### 复制证书到 gitlab 目录：

```
sudo cp /etc/gitlab/ssl/gitlab.domain.com.crt /etc/gitlab/trusted-certs/
```

#### gitlab 重新配置+更新：

```
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart
```

### 创建你的 SSH key

1. 使用 Gitlab 的第一步是生成你自己的 SSH 密钥对（Github 也类似）。

2. 登录 Gitlab

3. 打开 **Profile settings**.

![img](https://docs.gitlab.com/ce/gitlab-basics/img/profile_settings.png)

4. 跳转到 **SSH keys** tab 页

![img](https://docs.gitlab.com/ce/gitlab-basics/img/profile_settings_ssh_keys.png)

5. 黏贴你的 SSH 公钥内容到 Key 文本框

![img](https://docs.gitlab.com/ce/gitlab-basics/img/profile_settings_ssh_keys_paste_pub.png)

6. 为了便于识别，你可以为其命名

![img](https://docs.gitlab.com/ce/gitlab-basics/img/profile_settings_ssh_keys_title.png)

7. 点击 **Add key** 将 SSH 公钥添加到 GitLab

![img](https://docs.gitlab.com/ce/gitlab-basics/img/profile_settings_ssh_keys_single_key.png)

### 创建项目

![img](http://dunwu.test.upcdn.net/snap/20190131150658.png!zp)

输入项目信息，点击 Create project 按钮，在 Gitlab 创建项目。

![img](http://dunwu.test.upcdn.net/snap/20190131150759.png!zp)

### 克隆项目到本地

可以选择 SSH 或 HTTPS 方式克隆项目到本地（推荐 SSH）

拷贝项目地址，然后在本地执行 `git clone <url>`

### 创建 Issue

依次点击 **Project’s Dashboard** > **Issues** > **New Issue** 可以新建 Issue

![img](https://docs.gitlab.com/ce/user/project/issues/img/new_issue_from_tracker_list.png)

在项目中直接添加 issue

![img](https://docs.gitlab.com/ce/user/project/issues/img/new_issue.png)

在未关闭 issue 中，点击 **New Issue** 添加 issue

![img](https://docs.gitlab.com/ce/user/project/issues/img/new_issue_from_open_issue.png)

通过项目面板添加 issue

![img](https://docs.gitlab.com/ce/user/project/issues/img/new_issue_from_projects_dashboard.png)

通过 issue 面板添加 issue

![img](https://docs.gitlab.com/ce/user/project/issues/img/new_issue_from_issue_board.png)

## 四、gitlab 权限配置

### 用户组的权限

- 用户组有这几种权限的概念：`Guest、Reporter、Developer、Master、Owner`
- 这个概念在设置用户组的时候会遇到，叫做：`Add user(s) to the group`，比如链接：`https://<gitlab_host>/<group>`

| 行为       | Guest | Reporter | Developer | Master | Owner |
| ---------- | ----- | -------- | --------- | ------ | ----- |
| 浏览组     | ✓     | ✓        | ✓         | ✓      | ✓     |
| 编辑组     |       |          |           |        | ✓     |
| 创建项目   |       |          |           | ✓      | ✓     |
| 管理组成员 |       |          |           |        | ✓     |
| 移除组     |       |          |           |        |       |

## 五、备份/迁移/升级

### 备份

#### 手动备份

执行 `gitlab-rake gitlab:backup:create` 开始备份全量数据，成功后，会在 `/var/opt/gitlab/backups` 下生产一个名称类似 `1585910556_2020_04_03_11.3.0_gitlab_backup.tar` 的压缩包。

### 定时自动备份

可以利用 crontab 来定时执行备份命令。

执行 `vim /etc/crontab` 或 `crontab -e` 手动编辑定时任务。

### 迁移

> 迁移前，需要确保新老机器的 Gitlab 版本号一致。

将备份的压缩包拷贝到新机器的备份路径下（默认为 `/var/opt/gitlab/backups`）。

（1）将备份文件权限修改为 777，不然可能恢复的时候会出现权限不够，不能解压的问题

```shell
chmod 777 1585910556_2020_04_03_11.3.0_gitlab_backup.tar
```

（2）停止相关数据连接服务

```shell
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
```

（3）从备份文件中恢复 Gitlab

```shell
# gitlab-rake gitlab:backup:restore BACKUP=备份文件编号
gitlab-rake gitlab:backup:restore BACKUP=1585910556_2020_04_03_11.3.0
```

### 升级

升级前，一定要做好备份，记录当前 gitlab 的版本号。

第一步还是使用官方命令进行升级。

```shell
sudo yum install -y gitlab-ce
```

如果下载速度理想，就无需手动升级安装。不理想就需要`停止自动更新`，并手动下载安装包

访问官方地址，下载对应`版本`，对应`系统`的安装包。

注：可以根据`自动升级时下载的版本`，选择对应文件。

```http
https://packages.gitlab.com/gitlab/gitlab-ce
```

安装包手动上传至服务器，并`替换`下载未完成的安装包。下面是升级缓存地址：

```
/var/cache/yum/x86_64/7/gitlab_gitlab-ce/packages/
```

再次执行官方升级命令即可完成自动安装。

## 参考资料

- 官网：https://about.gitlab.com/
- 中文网：https://www.gitlab.com.cn/
- 官网下载：https://about.gitlab.com/downloads/
- 官网安装说明：https://about.gitlab.com/installation/#centos-7
- [操作系统、运维部署总结系列](https://github.com/dunwu/OS)