经过 docker 搭建自用的 gitlab 服务

前言

git 是当下如日中天的版本管理系统。如今若是不是工做在 git 版本管理系统之下，几乎都很差意思和人打招呼了。有不少现成的互联网的 git 服务提供给你们使用，例如号称程序员社交网络的 GitHub，还有低调好用的 bitbucket 。这些给我的使用或者公司用来作开源使用都没有什么问题。但若是在部门内推广使用就会涉及到代码不能公开或者额外的费用的问题。本人原来在部门内采用的是手工在 linux 服务器上来管理代码仓库。权限无法设置，也很是不方便。因此也一直很苦恼。

正好 gitlab 公司提供了 gitlab 社区版，看了看基本知足了部门内 git 管理的需求。gitlab 提供了各类各样的安装方式，最方便的固然仍是 docker 方式的安装，适合我这种不想多折腾的。抽空搭建了一个。也趟了几个坑，将步骤记录以下，但愿对其余有此需求的人有所帮助。

docker 安装

既然是基于 docker 来安装 gitlab ，首先是安装 docker 环境了。我是在 centos 7 的基础上安装的。根据官网的指南

删除旧版本的 docker

旧版本的 docker 的叫作 docker 或者 docker-engine，若是系统中已经安装旧版本，则须要删除。经过一下命令删除旧的 docker 版本

yum remove docker docker-common docker-selinux docker-engine
复制代码

增长 docker yum 源

新的 docker 叫作 docker-ce ，若是第一次安装 docker-ce 须要设置 docker-ce 的 yum 源。用以下的命令来增长 docker-ce 的yum 源

yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum-config-manager --enable docker-ce-edge
yum-config-manager --enable docker-ce-test
复制代码

安装 dokcer-ce

首先咱们查看全部有效的 docker-ce 的版本

yum list docker-ce --showduplicates | sort -r
复制代码

获得以下的列表

docker-ce.x86_64         17.12.0.ce-1.el7.centos              docker-ce-test   
docker-ce.x86_64         17.12.0.ce-1.el7.centos               docker-ce-stable 
docker-ce.x86_64         17.12.0.ce-1.el7.centos               @docker-ce-stable
docker-ce.x86_64         17.12.0.ce-0.4.rc4.el7.centos         docker-ce-test   
docker-ce.x86_64         17.12.0.ce-0.3.rc3.el7.centos         docker-ce-test   
docker-ce.x86_64         17.12.0.ce-0.2.rc2.el7.centos         docker-ce-test   
docker-ce.x86_64         17.12.0.ce-0.1.rc1.el7.centos         docker-ce-test   
docker-ce.x86_64         17.11.0.ce-1.el7.centos               docker-ce-test   
docker-ce.x86_64         17.11.0.ce-0.4.rc4.el7.centos         docker-ce-test   
...
docker-ce.x86_64         17.03.1.ce-0.1.rc1.el7.centos         docker-ce-test   
docker-ce.x86_64         17.03.0.ce-1.el7.centos               docker-ce-stable
复制代码

从这里能够看到最新的稳定版本是 17.12.0.ce。咱们用下面的命令选择安装该版本

yum install docker-ce-17.12.0.ce
复制代码

自定义 docker 配置

由于众所周知的缘由，访问 docker 的中央仓库下载 docker 镜像的速度很是慢。为了得到较好的体验，咱们须要配置一个寻找一个国内的镜像加速服务。

默认状况下，docker 将运行的目录配置到了/var/lib/docker 目录下。一般这个目录是在 linux 的根分区下，空间比较有限，因此咱们须要将 docker 的运行目录配置到其余目录下。

镜像加速服务可使用阿里云的镜像加速服务。注册阿里云的用户后，登陆 https://cr.console.aliyun.com ，在管理控制台选择镜像加速服务，则出现以下的信息。这里红色打码部分就是你的阿里云镜像加速服务的地址。

为了自定义 docker 的默认运行目录和镜像仓库地址，咱们须要修改 /etc/docker/daemon.json

mkdir /etc/docker
vi /etc/docker/daemon.json
复制代码

输入以下内容

{
  "graph":"/u1/docker",
  "registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"]
}
复制代码

graph 定义 docker 运行的目录， registry-mirrors 定义了 docker 获取镜像的仓库的地址。

启动 docker

执行以下的命令启动 docker 的服务

systemctl start docker
复制代码

执行以下命令查看 docker 信息

docker info
复制代码

能够看到以下的信息

能够看到 Docker Root Dir 和 RegistryMirrors 都变成了 /etc/docker/daemon.json 中配置的内容了

安装 gitlab

下载镜像

执行下面的命令，从 docker 的镜像仓库中下载 gitlab 社区版的镜像

docker pull gitlab/gitlab-ce:latest
复制代码

镜像有 1g 多，因此须要等待一段时间

数据持久化保存

由于容器的数据是不能持久化保存的。因此咱们须要用 docker volume 的方式将存储的数据映射到操做系统的目录中来。这样就算运行的容器崩溃，咱们从新启动一个新的容器，原来容器中的数据仍是不会丢失

咱们创建了目录 /u1/gitlab 来保存 gitlab 容器中的数据

准备映射 sshd

另外，为了 git 采用 ssh 协议来操做 git 仓库，咱们将主机的 sshd 的 22 端口映射到 容器中去。将主机的 sshd 端口更改成 15678。这里由于 centos 7 更严格的安全机制，算是一个坑，须要按照下面的步骤去进行。

编辑文件 /etc/ssh/sshd_config，将其中的 #Port 22 注释去掉，将数字 22 更改成 15678

执行下面的命令重启 sshd 服务

systemctl restart sshd
复制代码

运行下面的命令使 15678 端口能够对外提供服务。不然没法进行远程的 ssh 登陆。

semanage port -a -t ssh_port_t -p tcp 15678
firewall-cmd --permanent --add-port=15678/tcp
firewall-cmd --reload 
复制代码

运行 gitlab

docker run \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --name gitlab \
    --volume /u1/gitlab/config:/etc/gitlab \
    --volume /u1/gitlab/logs:/var/log/gitlab \
    --volume /u1/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce
复制代码

这里把主机的 44三、80、22 端口直接转发到容器，同时利用 --volume /u1/gitlab/config:/etc/gitlab 、 --volume /u1/gitlab/logs:/var/log/gitlab 、 --volume /u1/gitlab/data:/var/opt/gitlab 这三个参数将 gitlab 的配置、数据和日志持久化到主机文件系统上来。

管理员配置 gitlab

登陆 gitlab

等待 docker 容器启动完成后，访问 http://ip 就进入 gitlab 访问界面。第一次访问是让咱们修改管理员密码。以下所示

设置后管理员密码后，就进入登陆页面，输入用户名 root 和刚才设置的密码就进入了 gitlab 的控制台。以下图所示

建立组（ group）

gitlab 里面有三类对象：组（ group）、项目（ project）和用户 （people）。

为了方便管理，咱们应该基于组来建立项目。一个项目就是一个 git 的仓库。基于组建立项目 ，而后将用户设置合适的权限后加入到组里面。这样用户就有了组里面全部项目的对应权限。

点击 “Create a group” 连接，以下图所示建立一个“健康医疗开发组” 的组

建立用户（people）

点击 “Add people” 连接，以下图所示建立一个 “yanggch” 的用户

由于尚未配置好邮件服务，因此还不能发送用户初始化密码的邮件。咱们须要编辑用户，手动设置一个密码。以下图所示。若是用户忘记了密码，充值密码也能够在这里进行。

将用户加入组

为了方便管理，须要将用户加入到对应的组里面。以下图所示，在组管理界面中，点击组的名称，进入组用户设置界面。将刚才建立的用户 “yanggch” 加入到组 “健康医疗开发组”中，而且给他设置为 “Master” 角色。只有 “Master” 或者 “Owner” 角色才能推送 git 的更新。

建立项目（project）

增长 gitlab 组的时候，为了让项目让组里面的人都能访问，注意要将项目创建在组之下。以下图所示，在“健康医疗开发组”之下创建了 “redis_util” 的项目。

这样项目建好以后就能够被组里的用户访问了。

客户端访问

安装 git 客户端

这里演示在 window上安装 git 客户端。首先根据 window 版本下载 git 客户端安装程序。这里我下载的是

https://github.com/git-for-windows/git/releases/download/v2.15.1.windows.2/Git-2.15.1.2-64-bit.exe
复制代码

命令行访问

安装后，在准备 clone 项目的目录下点击鼠标右键，出现下面的右键菜单。

点击 “Git Bash Here” 进入 git 命令行环境。咱们会从 redis_util 项目中看到该项目基于 http 协议的 clone 命令是

git clone http://7a45cd079bdc/healthcare_dev/redis_util.git
复制代码

这里的 7a45cd079bdc 其实是 docker 容器的机器名。实际执行的时候咱们把这个字符串更换成容器所在主机的 ip 地址便可。以下所示

git clone http://10.110.2.50/healthcare_dev/redis_util.git
复制代码

这种状况下会要求输入登陆的用户名和密码。这里输入刚才建立的用户的用户名和密码便可。在使用前，须要用这个用户登陆 gitlab 控制台修改一下初始密码才能使用。

出现以下提示表示从 gitlab clone 项目成功

Cloning into 'redis_util'...
warning: You appear to have cloned an empty repository.
复制代码

免密码登陆

刚才那种方式经过 http 协议和 gitlab 进行通讯，每次都要输入用户名和密码，很是不方便。用户能够设置经过 ssh 进行交互，将ssh key 加入到用户的 sshkey 设置列表中。

参考“命令访问” 章节进入 git 的 bash 环境。执行下面的命令进入 ssh key 存储目录

cd ~/.ssh
复制代码

目录中 id_rsa.pub 是 ssh 访问的公钥。若是不存在则执行下面的命令生成

ssh-keygen -t rsa
复制代码

所有回车后，会生成 id_rsa.pub 文件。

将文件中的内容拷贝到剪贴板。而后经过前面建立的用户名和密码登陆 gitlab 控制台。在下面的界面中，将 id_rsa.pub 文件的内容填入文本框

保存后。再经过 ssh 协议操做 git 仓库，将再也不须要输入用户名和密码。以下所示

推送一次提交

首先配置当前仓库的用户名和用户邮箱配置

cd redis_util
git config --local user.name "yanggch"
git config --local user.email "yanggch@inspur.com"
复制代码

而后在 redis_util 目录下加入一个 readme.txt，执行下面的命令提交并将更新推送到 gitlab 远程服务器

#将新文件加入到版本管理
git add readme.txt
#提交
git commit -m"第一次提交"
#将当前分支 master 推送到远程仓库
git push
#以 master 分支为基础创建一个新的 dev 本地分支
git checkout -b dev
#将本地仓库分支推送到远程仓库，在远程仓库创建对应的 dev 分支
git push --set-upstream origin dev
复制代码

到 gitlab 控制台查看 redis_util 的状态。以下图所示

到此，咱们就完成了一个公司级别的 gitlab 服务器的搭建工做。小伙伴们就能够在这个上面流畅的进行开发了。

原文发表在简书中，原始连接