如何在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
|
sudo docker run --detach \
|
上面的参数说明:
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-runner
官方文档地址: https://docs.gitlab.com/runner/install/
注意,这里我们选择install as a Docker service。
- 首先使用下面的命令来安装gitlab-runner
1
|
docker run -d --name gitlab-runner --restart always \
|
如果你是用的是docker来运行gitlab和gitlab-runner的话,注意上面的–link参数,这里必须加上–link gitlab,其中gitlab是之前我们运行gitlab的时候指定的容器名称。这样之后,等于是让gitlab-runner连接上了gitlab这个容器,这样在gitlab-runner容器中就可以访问到gitlab这个容器了。更多内容,请自行查看docker文档。
配置gitlab-runner
如果要使gitlab-runner工作的话,需要让gitlab
-runner知道你的gitlab安装在哪个地址,以及注册用的token。
使用下面的步骤来在gitlab中注册runner。
-
运行下面的命令
1
docker exec -it gitlab-runner gitlab-runner register
-
输入gitlab的url地址
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):1
http://gitlab
注意这里的url地址,是http://容器的名称。
- 输入token
Please enter the gitlab-ci token for this runner:
后面的步骤根据提示输入即可。
token查看地址: http://localhost:81/admin/runners
-
接下来的2步输入描述,输入标签,自己输入即可。
-
是否运行在没有tag的build上面。在配置gitlab-ci的时候,会有很多job,每个job可以通过tags属性来选择runner。这里为true表示如果job没有配置tags,也执行。
Whether to run untagged builds [true/false]:1
true
-
是否锁定runner到当前项目。
Whether to lock the Runner to current project [true/false]:
1
|
true
|
- 选择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
|
- 执行的默认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
|
test:
|
上面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'
|
这样之后,就不会在出现上面的错误了。