使用docker安装gitlab中文版记录

使用docker安装gitlab中文版记录

关于

由 BobH 实验并记录,QQ:1551608379

该教程会持续更新

环境

系统:Ubuntu 16.04.3LTS

CPU:Intel(R) Core(TM) i5-7400 CPU @ 3.00GHz

内存:4G*2 DDR4

读完教程你将会学到

1.在ubuntu系统上安装docker

2.在任意安装有docker的系统上搭建gitlab

3.gitlab的一些基本配置项的修改以及生效

4.配置gitlab的邮件发送

5.配置gitlab的项目ssh

6.vim的基本使用

7.docker的一些基本操作

过程

1.安装docker

先删除掉apt官方库所有docker

sudo apt-get remove docker docker-engine docker-ce docker.io

然后更新apt源

sudo apt-get update

安装以下包以使apt可以通过HTTPS使用存储库

sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common

添加Docker官方的GPG密钥

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

使用下面的命令来设置stable存储库

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

然后再更新apt源

sudo apt-get update

安装最新版本的Docker CE

sudo apt-get install -y docker-ce

安装成功后,使用下面指令启动docker(默认是启动了的)

sudo systemctl start docker

2.使用docker来安装gitlab

确保已经成功安装上了docker

接下来来到 ~ 目录下,然后执行

sudo docker pull twang2218/gitlab-ce-zh

然后给本机新建三个文件夹,用于存储docker内运行的gitlab的配置文件目录

建议给定空间大一点,最好是在主磁盘下,因为以后gitlab东西都是存这里

mkdir ~/docker/gitlab/config
mkdir ~/docker/gitlab/logs
mkdir ~/docker/gitlab/data

接下来就可以创建容器了

sudo docker run --detach --publish 443:443 --publish 80:80 --publish 23:22 --name cn-gitlab --restart always --volume ~/docker/gitlab/config:/etc/gitlab --volume ~/docker/gitlab/logs:/var/log/gitlab --volume ~/docker/gitlab/data:/var/opt/gitlab twang2218/gitlab-ce-zh

这句话需要解释一下,--publish参数可以指定端口映射,前面是宿主机的端口,后面是容器内端口,这里我把SSL端口,80端口,和SSH端口都映射出来方便后面管理

然后后面的-volume参数就是指定容器内文件系统映射关系,这里的地址( ~/docker/gitlab/config )之类的就是我们刚才在主机上新建的用于存储gitlab数据的目录

接下来我们检验一下启动是否成功

输入

sudo docker ps

查看现在正在运行的docker虚拟机的状态

CONTAINER ID        IMAGE                    COMMAND             CREATED             STATUS                   PORTS                                                          NAMES
9ad55d926321        twang2218/gitlab-ce-zh   "/assets/wrapper"   4 minutes ago       Up 4 minutes (healthy)   0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:23->22/tcp   cn-gitlab

如果在STATUS那一栏看到Starting字样表示gitlab正在启动,如果是healthy字样表示已经启动成功,这时候我们可以访问服务器的ip看到如下界面了

这个时候表明gitlab已经搭建成功,可以使用了

初始用户名为 root

密码在这里设置了即可登录

接下来我将讲述如何配置gitlab的邮件发送

3.使用docker来修改gitlab的配置

关于gitlab的配置文件在何处,这里你可以用以下指令查看

为了方便各位理解,接下来的指令我都会直接附上终端的目录信息等

由于我们刚才使用docker搭建gitlab的时候指定了存储目录,所以现在你可以

ycoi@ycoi-server:~/docker/gitlab$ cd ~/docker/gitlab/
ycoi@ycoi-server:~/docker/gitlab$ ls

不出意外,你会看到如下结果:

config  data  logs

我们的配置文件位于config文件夹内,所以执行下列指令

ycoi@ycoi-server:~/docker/gitlab$ cd config
ycoi@ycoi-server:~/docker/gitlab/config$ ls

不出意外,你会看到如下结果:

gitlab.rb            ssh_host_ecdsa_key      ssh_host_ed25519_key      ssh_host_rsa_key      trusted-certs
gitlab-secrets.json  ssh_host_ecdsa_key.pub  ssh_host_ed25519_key.pub  ssh_host_rsa_key.pub

其中的gitlab.rb就是我们的配置文件,使用下列指令来编辑它

ycoi@ycoi-server:~/docker/gitlab/config$ sudo vim gitlab.rb

如果打开是空白,那么很可能是你没有加上sudo 导致vim没有权限读取导致,请一定不要忘了sudo

打开后是形如此番场景的一个配置文件编辑页面,如果你不熟悉vim的基本操作,请跳到本教程末尾附录的vim基本使用教程中去,这里不做赘述

按下键盘上的/键进行查找,并输入/# exter (注意#号后有空格),然后回车,你会发现光标跳到下面这个位置来

然后按下键盘上的i,切换到编辑模式,将#号删除,并将后面的url改成你自己的服务器内网地址(或者域名,在后面高级篇会讲一下),就像这样

建议初学者都将链接设置成http而不是https,因为https会有很多意外的麻烦,所以不要一下子想学会所有,像这样填,或者 http://192.168.1.105/ 之类的形式

然后是配置gitlab的ssh连接功能,默认的gitlab是不需要配置ssh端口的,因为ssh端口默认为22,但是由于刚才我们在docker新建容器的时候为了避免和本机ssh端口冲突,把容器内的22端口映射为了23端口,所以这里我们还需要做一点修改

按下键盘上的/键进行查找,并输入/gitlab_shell_ssh (注意#号后有空格),然后回车,你会发现光标跳到下面这个位置来

删除#号,然后将端口改成23(如果你刚才映射出去的不是23,那你映射的是多少就填多少)

然后按下ESC 键退出编辑模式,如果你不配置发送邮箱功能,此时可以按下键盘下 : 键然后输出 wq! 退出并保存。然而现在我想教你们如何配置邮箱。

继续停留在vim配置文件内,按下键盘上的/键进行查找,并输入/smtp_enable ,然后回车,你会发现光标跳到下面这个位置来

这就是所有邮箱配置所需要的信息了,你不必每一个都取消注释,像是我这样就可以

还有就是需要添加一点点东西,是为了防止邮件被退回的

这里smtp_password我填写的并不是我的真实QQ密码,而是授权码,详情可以看这里

https://service.mail.qq.com/cgi-bin/help?subtype=1&&no=1001256&&id=28

如果你需要配置,只需要把图片中所有1551608379@qq.com替换成你的邮箱,然后更改成你的授权码(或者密码)就行了

配置完毕后,可以按下键盘下 : 键然后输出 wq! 退出并保存。

此时所有信息都配置完毕了,但是还未生效,接下来我将教你如何在docker里面让gitlab重载配置,让刚才的设置生效

4.使用docker来重载gitlab配置并验证邮箱配置

现在配置文件更改了,然而gitlab仍然处于运行中,所以更改不会立即生效,接下来的操作就是要让gitlab重新读取配置文件并让我们的更改生效

一定注意不要像网上所说的那样直接使用sudo docker cn-gitlab restart这样的方式来重启容器达到配置生效的效果,这样做非常不安全,配置文件可能只有部分生效而且很可能造成gitlab的完全崩溃,无法启动(笔者的亲身经历...)

接下来,输入以下命令,在任意目录下执行均可

sudo docker exec -it cn-gitlab /bin/bash

输入以后,你会发现终端前缀变化了,实际上,这就是docker容器内的shell环境,接下来你输入的所有指令都将是在cn-gitlab这个容器内完成的

接下来输入以下指令重载gitlab的配置,注意观察日志输出

root@9ad55d926321:/# gitlab-ctl reconfigure

基本上如果你配置文件不粗心写错,且是完全严格按照本教程要求来操作的话,是不会报错的。

当你看到如下界面

出现gitlab Reconfigured!字样的时候,恭喜你,已经重载配置成功了。

以后如果你作出了有关配置文件的修改,最好都以这样的方式来重载配置,如果不成功,至少不至于让gitlab全盘崩溃,造成数据损失。当然,日常docker容器备份也是一个好习惯,在本教程附录部分,我也会讲解如果备份docker镜像的详细事宜。

接下来我们来验证一下邮箱发送功能是否配置成功,在这之前,用浏览器访问服务器地址确保gitlab已经正常启动。

我们仍然停留在容器内部的shell里面,然后执行下面命令

root@9ad55d926321:/# gitlab-rails console

注意,在输入这个指令后,控制台会卡顿相当长一段时间,表面上看起来是无输出的未响应状态,请不要着急,等待直到出现下面信息

然后在这里输入

irb(main):001:0> Notify.test_email('你收件邮箱', 'test', 'test body').deliver_now

查看输出信息,并检查收件箱是否已经收到测试邮件

已经成功证明邮件发送功能配置成功

附录

1.关于vim基本操作

使用vim编辑某个文件

sudo vim <文件路径>

例如

sudo vim gitlab.rb
sudo vim ~/docker/gitlab/config/gitlab.rb

打开vim过后,一下基本操作

键盘 移动光标

键盘i键按下后进入可编辑模式

键盘ECS键按下后退出当前模式

键盘/键按下后进入搜索模式,在/后输入想搜索的内容回车

键盘:按下后进入命令模式,一般只用退出并保存命令wq!

2.docker容器的备份

备份一个docker镜像为文件

sudo docker export <镜像ID或名称> > backup.tar

例如

sudo docker export cn-gitlab > 20190524bak_gitlab.tar

稍等片刻即可看到当前目录下多出一个备份文件,只需要拷贝这个备份文件就可以完成备份

导入时

sudo docker import <备份文件名>

例如

sudo docker import 20190524bak_gitlab.tar

“使用docker安装gitlab中文版记录”的3个回复

评论已关闭。