大家好，我是Mandy。今天分享的主题内容是如何使用GitLab搭建属于自己的代码管理平台。
为什么会单独分享这篇文章呢，相信在很多的开发同学任职的公司中，都用到了gitlab来做代码管理平台，同时结合GitLab的一些自动化功能，实现devops的功能。
GitLab由乌克兰程序员DmitriyZaporozhets和ValerySizov开发，它使用Ruby语言写成。后来，一些部分用Go语言重写。截止2018年5月，该公司约有290名团队成员，以及2000多名开源贡献者。GitLab被IBM，Sony，JülichResearchCenter，NASA，Alibaba，Invincea，O’ReillyMedia，Leibniz-Rechenzentrum(LRZ)，CERN，SpaceX等组织使用。
GitLab是由GitLabInc.开发，使用MIT许可证的基于网络的Git仓库管理工具，且具有wiki和issue跟踪功能。使用Git作为代码管理工具，并在此基础上搭建起来的web服务。
GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的web服务。安装方法是参考GitLab在GitHub上的Wiki页面。同时官方也提供了免费版本，可以支持独立安装，也可以支持直接使用官方搭建的web服务。
与GitLab同类的产品也很多，例如国外微软旗下的GitHub，国内的Gitee都属于同类的代码管理平台，同时这些平台也结合了一些企业开发相关的功能。例如项目任务管理、项目自动化构建发布等等功能。
使用GitHub的同学应该知道，GitHub属于国外的网站在访问上经常遇到无法访问或者访问较慢的情况，并且个人是没法直接创建私有仓库，你只能通过创建公开仓库，对于有私有仓库的需求就需要付费使用并且费用还不算低。
对于Gitee来说，属于国内的网站避免了访问的问题，但Gitee是开发部分免费功能，其他的功能是需要收费使用。
基于上述的一些原因，企业也选择GitLab来搭建代码管理平台，同时里面的一些自动化功能也是完全不亚于GitHub、Gitee。对于个人开发者使用GitLab，不仅能够管理自己的代码，同时也能学到GitLab与其他的系统实现一些自动化功能，这将是一个不错的选择。
如何搭建
接下来，我将全面的演示如何在Linux上搭建GitLab。整体来说是非常的简单，整篇文章都是采用Docker来搭建，毕竟现在Docker的使用不管是个人还是企业都是非常主流的技术栈。
这里要特别的说明一下，强烈建议你选择一个高配置的服务器来搭建GitLab，在我个人的测试过程中发现GitLab是非常消耗内存，基本搭建好GitLab就会占用4G的内存，如果你只是在本地搭建用作学习，应该是完全没问题的，毕竟个人的电脑应该没有低于4G内存大小的计算机。
检索官方镜像并拉取到本地
通过docker search xxx可以查找Docker官方镜像中，关于GitLab的镜像，你会看到如下很多的镜像。有的是一些插件，有的是基于官方镜像构建的镜像。这里还是强烈推荐直接使用官方提供的GitLab镜像。
# 查找gitlab镜像
docker search gitlab
[root@VM-4-9-centos ~]# docker search gitlab
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
bitnami/gitlab-runner 35
bitnami/gitlab-runner-helper 3
alpinelinux/gitlab-runner-helper Helper image container gitlab-runner-helper … 4
rapidfort/gitlab-ce 12
okteto/gitlab 2
alpinelinux/gitlab-runner Alpine Linux gitlab-runner (supports more ar… 5
drud/gitlab-ce 18
accurics/gitlab-connector 0
domjudge/gitlabci 0
wodby/gitlab Alpine-based GitLab CE container image 0
ustclug/gitlab Dockrized GitLab used by LUG@USTC 0
alpinelinux/gitlab Alpine Linux based Gitlab image 8
itisfoundation/gitlab-runner-docker 0
pnnlmiscscripts/gitlab-runner-operator 0
jitesoft/gitlab-ci-runner Image inheriting from the gitlab runner. I… 0
vulhub/gitlab 0
alpinelinux/gitlab-shell Alpine Linux based gitlab-shell image, provi… 1
wodby/gitlab-nginx Nginx for GitLab CE container image 0
corpusops/gitlabtools https://github.com/corpusops/docker-gitlabto… 0
vulhub/gitlab-cve-2016-9086 gitlab cve-2016-9086 0 [OK]
drud/gitlab-backups 0
gromacs/gitlab-runner 0
wodby/gitlab-runner 0
avenga/gitlab-job 0
osuosl/gitlab-runner-helper 0
接下来拉取官方镜像到本地，直接拉取最新的镜像。
docker pull gitlab/gitlab-ce:latest
拉取好镜像之后，可以查看本地是否拉取到镜像。这里使用docker images查看本地的镜像有哪些，下面就可以看到gitlab/gitlab-ce的镜像地址，表示我们已经成功拉取到本地。
[root@VM-4-9-centos ~]# docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
gitlab/gitlab-ce latest df5003a3217c 2 days ago 2.86GB
zmister/mrdoc v6 f4973a0fcd4b 3 months ago 1.34GB
postgres 15.2 bf700010ce28 6 months ago 379MB
openspug/spug-service latest db1e45c81bec 7 months ago 593MB
surveyking/surveyking latest 7445aa54d4c4 12 months ago 157MB
mariadb 10.8.2 51adad759c74 21 months ago 414MB
启动镜像容器
拉取到镜像之后，就可以基于镜像在本地启动一个GitLab容器。这里要说明一点，你再创建容器时，一定要做磁盘挂载和端口映射。不过磁盘挂载很可能容器删除导致数据丢失，端口映射是为了通过宿主机的访问达到访问容器内部的GitLab服务，否则是没法直接访问容器内的服务。
# 启动容器
docker run \
-itd \
-p 9981:80 \
-p 9922:22 \
-v /opt/gitlab/etc:/etc/gitlab \
-v /opt/gitlab/log:/var/log/gitlab \
-v /opt/gitlab/opt:/var/opt/gitlab \
--restart always \
--privileged=true \
--name gitlab \
gitlab/gitlab-ce
上述命令主要的作用是：
1、 run：启动容器命令，这是Docker自带的命令，创建容器时必须使用该命令才能创建容器。
2、-itd：-i参数是以交互模式运行容器，通常与 -t 同时使用命令解释；-t参数是为容器重新分配一个伪输入终端，通常与 -i 同时使用；-d参数是后台运行容器，并返回容器id。
3、-p：是做端口映射，第一个-p是为了将容器内的web端口映射宿主机的端口，这样就能通过宿主机的端口直接访问到容器内的端口，也就是说后面通过浏览器访问GitLab就需要该端口；第二个-p是为了将容器内22端口映射至宿主机9922端口，这是访问ssh的端口，例如后面使用命令git push代码到GitLab会用到该协议。
4、-v：该参数为了将宿主机的目录和容器内的目录做一个映射，容器内的文件和宿主机实现同步，防止数据丢失，哪怕是后续你容器被删掉，宿主机的文件保持存在，数据就不会丢失。
5、–restart：保持容器自动启动。比如你关闭了Docker服务，容器也会随着退出，再次启动Docker服务时，容器会自动启动，不需要你手动去启动容器。
6、–privileged：该参数是为了让容器内获取到宿主机的root权限。
7、–name：该参数是为了给容器取一个名称，记住这个名称要不能重复。例如你本地有一个名字叫做A的容器，就不能取同样名称的容器。
8、gitlab/gitlab-ce：该参数是表示容器从哪一个镜像中创建，前面我们拉取了官方镜像到本地仓库，因此会自动从本地的镜像中去创建。如果你没拉取镜像到本地，此时会自动去Docker官方镜像仓库中拉取到本地。
此时，我们的GitLab容器已经创建完毕，但要访问容器，还需要你修改一些其他的配置。这里推荐直接在容器中去修改配置，如果直接在宿主机修改，可能出现同步到容器中存在延迟，导致访问出现问题。
修改配置
在修改配置之前，你需要明确如下几点：
1、访问方式：如果你是想通过域名的方式访问，你需要解析一个域名，如果不需要直接使用配置成宿主机的IP地址。我这里假设域名是a.baidu.com。
2、ssh方式：ssh适用于代码同步，这里也需要配置成域名或者IP的方式。
#第一步是进入到容器内部，gitlab可以写成你容器的id
docker exec -it gitlab /bin/bash
#修改gitlab.rb的配置文件
vi /etc/gitlab/gitlab.rb
#gitlab访问地址，可以写域名。如果端口不写的话默认为80端口
external_url 'http://192.168.1.194'
或者是
external_url 'a.baidu.com'
#ssh主机ip
gitlab_rails['gitlab_ssh_host'] = '192.168.1.194'
#ssh连接端口
gitlab_rails['gitlab_shell_ssh_port'] = 9922
修改好之后，在容器中重启gitlab-ctl reconfigure配置，并且使用gitlab-ctl restart来重启GitLab服务。此时就可以直接使用IP的方式访问GitLab，如果你配置的是域名，还需要在Linux系统中使用域名配置，做端口代理访问到GitLab服务。假设你用的是NGINX做web服务，你需要做如下的配置。
server{
listen 80;
server_name a.baidu.com;
location / {
proxy_pass http://127.0.0.1:9981;
}
}
配置好域名之后，重启NGINX服务nginx -s reload就可以通过域名的方式访问。
注意事项
在网上有的文章会提到如下的配置操作：
vi /opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml
gitlab:
host: 192.168.1.194
port: 9980
https: false
但实际测试下来，并非一定要做这一步操作。在你上面修改好配置之后，执行``gitlab-ctl reconfigure命令重启后，上面的gitlab.yml`文件会自动帮你同步配置。
账号修改
当你能访问搭建好的GitLab服务，并且能够访问，但一开始会让你进行登录注册，GitLab默认的超级管理员账号是root，此时是需要你修改默认的密码。
# 进入容器内部
docker exec -it gitlab /bin/bash
# 进入控制台
gitlab-rails console -e production
# 查询id为1的用户，id为1的用户是超级管理员
user = User.where(id:1).first
# 修改密码为gitlab001
user.password='gitlab001'
# 保存
user.save!
# 退出
exit
此时你使用root账号，并且密码是gitlab001就可以正常访问了。
自此GitL按服务就算搭建完成，你就可以直接使用了。更多的功能，你也可以直接进行摸索使用。
相关链接
一、GitHub拥有28kstar，Go开源的多文件存储神器
二、强烈推荐使用的Markdown编辑器工具
三、又遇到一款神仙级别的PDD绘图工具
四、使用Go开源的一款性能监控软件
