如何在mac上安装gitlab

安装docker

下载地址：
https://docs.docker.com/docker-for-mac/install/

下载下来是一个dmg的安装包，直接安装就可以了。

网络问题

嗯，在国内做开发必须谈网络问题，安装好docker之后，建议使用国内的docker镜像源，我用的是aliyun的。

• 首先你得有aliyun的账号：
• 然后进去到https://dev.aliyun.com/search.html页面
• 如果你登录了，进入到上面的页面，点击上面页面的【管理中心】
• 然后点击【镜像加速器】就可以按照提示配置了

安装portainer

portainer是一个Docker的可视化的管理工具。
使用下面的命名安装portainer：

1	docker run -d -v "/var/run/docker.sock:/var/run/docker.sock" -p 9000:9000 portainer/portainer

上面的命令执行完成之后，打开浏览器访问：

localhost:9000

一开始会让你设置管理员密码，设置完成之后，进入系统，界面应该是下面这个样式的：

在portainer可以很方便的管理你的Docker。推荐安装。

安装gitlab-ce

使用下面的命令安装gitlab-ce

1 2 3 4 5 6 7 8 9

sudo docker run --detach \ --hostname mygitlab.com \ --publish 443:443 --publish 80:80 --publish 22:22 \ --name gitlab \ --restart always \ --volume /srv/gitlab/config:/etc/gitlab \ --volume /srv/gitlab/logs:/var/log/gitlab \ --volume /srv/gitlab/data:/var/opt/gitlab \ gitlab/gitlab-ce:latest

上面的参数说明：

hostname按照自己的需要改

volume的冒号前面为物理机器上的实际目录，需提前建好，然后改为正确路径。冒号后面为挂载点，不要改

publish的三个端口映射自己看情况来，一般自己网内使用，光一个80就好了，443和22都需要额外配置数字证书什么的

安装完成之后，可以在portainer中的【containers】中查看所有的容器状态。

如果gitlab的状态是created的话，那么你可以选中，点击【start】启动，启动成功之后应该是上图的状态。

然后打开浏览器访问：

localhost:80
或者
mygitlab.com:80

这个时候会要求你修改root账户的密码，输入2次密码确定就可以了。注意这个root账户是gitlab的账户不是你mac系统的root账户，不要搞错了。

到这里，在macos中搭建gitlab系统就算完成了。

下一篇讲如何在gitlab中配置ci/cd。

gitlab配置ci/cd

gitlab

安装gitlab-runner

官方文档地址： https://docs.gitlab.com/runner/install/

注意，这里我们选择install as a Docker service。

1. 首先使用下面的命令来安装gitlab-runner

1 2 3 4 5

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

如果你是用的是docker来运行gitlab和gitlab-runner的话，注意上面的–link参数，这里必须加上–link gitlab，其中gitlab是之前我们运行gitlab的时候指定的容器名称。这样之后，等于是让gitlab-runner连接上了gitlab这个容器，这样在gitlab-runner容器中就可以访问到gitlab这个容器了。更多内容，请自行查看docker文档。

安装完成之后，在portainer中就可以看到这个容器了。

配置gitlab-runner

如果要使gitlab-runner工作的话，需要让gitlab
-runner知道你的gitlab安装在哪个地址，以及注册用的token。

使用下面的步骤来在gitlab中注册runner。

1. 运行下面的命令

   1	docker exec -it gitlab-runner gitlab-runner register

2. 输入gitlab的url地址
   Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):

   1	http://gitlab

注意这里的url地址，是http://容器的名称。

1. 输入token
   Please enter the gitlab-ci token for this runner:
   后面的步骤根据提示输入即可。

token查看地址： http://localhost:81/admin/runners

1. 接下来的2步输入描述，输入标签，自己输入即可。

2. 是否运行在没有tag的build上面。在配置gitlab-ci的时候，会有很多job，每个job可以通过tags属性来选择runner。这里为true表示如果job没有配置tags，也执行。
   Whether to run untagged builds [true/false]:

   1

   true

3. 是否锁定runner到当前项目。
   Whether to lock the Runner to current project [true/false]:

1

true

1. 选择executor，这里列出了很多executor，具体区别可以看这里：https://docs.gitlab.com/runner/executors/README.html

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

1

docker

1. 执行的默认docker image，上面一步选择了docker，所有这里是docker的配置。
   Please enter the default Docker image (e.g. ruby:2.1):

   1	alpine:latest

这里设置的是alpine，这是一个基于Alpine Linux的最小的Docker镜像。

在项目中启用runner

使用管理员账户登录gitlab，访问 http://mygitlab.com:81/admin/runners 这个地址，
在页面的底部可以看到已经注册成功的runner。
在这里可以点击runner进入配置，可以给runner指派项目。指派的项目就可以使用该runner了。

在项目中添加.gitlab-ci.yml

在gitlab中创建一个测试项目，然后添加.gitlab-ci文件
添加以下内容：

1 2 3

test: script: - ls

上面test表示一个job的名称，script是这个job要执行的命令。
还可以设置tags，only等参数，具体可以参考： https://docs.gitlab.com/ee/ci/yaml/#shallow-cloning

提交之后，就会在Pipelines中看到正在执行job。

问题记录

fatal: unable to access
http://gitlab-ci-token:xxxxxxxxxxxxxxx@mygitlab.com/zhongzhong/cicd-test.git/
failed to connect to mygitlab port 80 : connetion refused

解决：出现这个问题的原因好像是gitlab-runner在拉取代码的时候，没有解析到
mygitlab.com，查看gitlab-runner的host文件，里面有mygitlab的映射。暂时通过将gitlab中的extenar_url修改为gitlab容器在docker中的ip地址。

1	docker exec -it gitlab vi /etc/gitlab/gitlab.rb

1	external_url 'http://172.17.0.3'

这样之后，就不会在出现上面的错误了。