Rainbond云原生快捷部署生产可用的Gitlab步骤详解

Gitlab简介

GitLab是利用 Ruby on Rails 一个开源的版本管理系统，实现一个自托管的Git项目仓库，可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能，能够浏览源代码，管理缺陷和注释。同时Gitlab集成了一系列的CI功能。不得不说，Gitlab在企业中是的使用率非常高。

Rainbond非常推荐用户使用Git代码仓库管理代码，从而获取更好的源代码管理和自动化CI体验。话不多说，接下来我们用10分钟的时间完成Gitlab服务在Rainbond的完整部署。

准备工作

准备一个可用的域名（如果你可以准备），比如 git.example.com
准备域名对应的证书（如果你可以准备）
Rainbond平台已安装完成，参考文档Rainbond快速安装
Rainbond平台处在能够连接互联网的环境下。

部署步骤

本教程我们将采用基于已制作完成的Docker镜像安装的方式部署Gitlab。部署完成后在Rainbond的运行效果如下：

我们在Rainbond部署一个开源的项目，基于Docker镜像的方式是最快，最简单的方式，特别是一些根据云原生的建议制作的镜像在Rainbond运行兼容性和体验都非常优越。

我们今天部署的Gitlab服务包括Postgresql组件、Redis组件和Gitlab-Server组件，它们的网络依赖关系如上图你看到一样，我们根据依赖关系从小到上依次部署。

首先创建应用 GItlab然后从应用管理页面开始添加服务组件：

我们采用基于DockerRun命令的方式创建服务，参考文档基于镜像创建服务 ,

此次部署的Gitlab镜像由社区提供，是目前使用最广的镜像。

部署Postgresql组件

添加服务组件，基于以下DockerRun命令，Rainbond将从下面的命令中获取镜像名称和持久化存储目录。

docker run --name gitlab-postgresql -d \
    --volume /srv/docker/gitlab/postgresql:/var/lib/postgresql \
    sameersbn/postgresql:10

服务构建源识别完成后，通常的过程是直接创建并启动，但是我们这里还需要设置服务的运行类型为有状态服务，并且还需要设置一下连接信息。因此我们需要选择创建不启动。方式如下：

强调一下，取消图中红色框框中的单选框，这一步非常重要

确认后页面直接跳转到服务管理页面，我们做以下几步设置：

1.更改端口别名，设置连接信息

进入服务端口管理页面，服务已默认添加了5432端口，更改端口协议为TCP, 打开端口的对内服务按钮，同时单击"使用别名"后方的端口别名信息，在弹出窗中设置端口别名为 “DB”。确认后将自动生成DB_HOST和DB_POST两个连接信息，在服务"依赖"页面可以查询连接信息, 同时我们继续添加以下连接信息：

变量名	值	说明
DB_EXTENSION	pg_trgm
DB_NAME	gitlabhq_production	数据库名称
DB_PASS	password	密码，你自己可以随便定义值
DB_USER	gitlab	连接数据库用户名

添加这些连接信息有两个作用：

Postgresql将读取这些变量自动创建用户和数据库

Postgresql服务被Gitlab-Server依赖后将注入到Gitlab-Server环境中，Gitlab-Server将根据这些变量信息连接数据库。

更多信息参考文档服务端口管理服务连接信息管理

2.更改服务部署类型

由于Postgresql属于数据库类，我们需要将服务部署类型设置为有状态服务，进入服务"其他设置"页面，在"基础信息"信息中将服务的部署类型切换为有状态服务。

3.创建服务

设置完成，点击构建开始构建并启动服务，这时候我们可以开始下一个组件的部署了。

部署Redis组件

部署Redis组件的过程与Postgresql一致，唯一的不同是不需要添加过多的连接信息。

1.基于下述DockerRun命令添加服务

docker run --name gitlab-redis -d \
    --volume /srv/docker/gitlab/redis:/var/lib/redis \
    sameersbn/redis:4.0.9-1

2.完成检查后设置创建不启动，进入服务管理页面

3.设置6379端口别名为REDIS,并开启端口对内服务。完成后在服务依赖页面可以查看到REDIS_HOST和REDIS_PORT两个连接信息变量，此变量将被注入到Gitlab服务中。

4.更改服务的部署类型为有状态服务。

5.创建服务，现在可以进入下一个环节了。

部署Gitlab-Server组件

1.使用下述的DockerRun命令创建组件，选择创建不启动。

docker run --name gitlab -d \
    --publish 10022:22 --publish 10080:80 \
    -e GITLAB_PORT=80 \
    -e GITLAB_HOST=git.example.com \
    -e GITLAB_SSH_PORT=10022 \
    -e GITLAB_SECRETS_DB_KEY_BASE=long-and-random-alpha-numeric-string \
    -e GITLAB_SECRETS_SECRET_KEY_BASE=long-and-random-alpha-numeric-string \
    -e GITLAB_SECRETS_OTP_KEY_BASE=long-and-random-alpha-numeric-string \
    --volume /srv/docker/gitlab/gitlab:/home/git/data \
    sameersbn/gitlab:11.8.2

这里需要说明的是其中的几个变量信息：

变量	值	说明
GITLAB_PORT	80
GITLAB_HOST	git.example.com	之前准备的域名，如果没有准备后续设置Rainbond默认分配的域名即可（创建后可更改）
GITLAB_SSH_PORT	20222	Gitlab server 22端口开启外网访问后分配的端口（创建后可更改）
GITLAB_SSH_HOST	10.10.10.10	Gitlab server 22端口开启外网访问后的IP（创建后可更改）

2.创建服务后依赖上面建立的两个服务。直接进入拓扑图编辑模式，将Gitlab Server与redis和postgresql服务连线即可。参考文档建立服务依赖

3.构建服务，等待服务启动完成。

注意，Gitlab服务第一次启动过程比较缓慢，等待服务启动完成。

配置网关访问策略

gitlab服务提供80端口的HTTP访问和22端口的SSH代码访问，分别为其添加访问策略。

80端口，配置HTTP访问策略，使用预先准备的域名比如(git.example.com)，这与GITLAB_HOST配置的必须一致。绑定域名对应的证书。

添加完成后进入访问策略列表，选择刚刚添加的策略，进入参数配置，将"上传限制"调整为10000 Mb,基本就是不限制了。

参考文档添加HTTP访问策略

为22端口添加TCP策略，生成的IP和端口需要与GITLAB_SSH_HOST GITLAB_SSH_PORT 两个变量一致。

到此，Gitlab服务部署完成，你可以直接访问服务了。第一次进入时将设置root账号的密码。

FAQ

安装完成，访问返回Gitlab的502页面

这个时候Gitlab正在进行初始化和启动过程，内部的某些进程还未启动完成。这个时候只需要等待服务启动完成即可，第一次启动大概5-10分钟。

上述过程还是有点复杂，能不能直接一键部署。

那当然是可以的，我已将Gitlab服务分享到Rainbond公有应用市场，供给Rainbond用户一键安装，应用市场搜索"Gitlab代码仓库服务" 选择版本v11.8.2，同步后直接安装即可。需要注意的是，安装完成后需要根据你的网关访问策略重新配置Gitlab的GITLAB_HOST、GITLAB_SSH_HOST等信息。

频道导航