一、引言
在微服务架构中,由于我们对系统的划分粒度足够小,服务会很多,而且也存在经常迭代的情况。如果还按照以前的部署方式显得非常吃力和复杂,并且很容易出现错误。而随着容器技术的发展,这个时候持续集成(CI)和持续部署(DI)也相应的流行起来,极大的方便了微服务的部署,而GitLab正式这样的一个DevOps工具。
GitLab是由GitLabInc.开发,使用MIT许可证的基于网络的Git仓库管理工具,且具有wiki和issue跟踪功能。使用Git作为代码管理工具,并在此基础上搭建起来的web服务。关于GitLab的信息可以查看官网: https://about.gitlab.com/ 。
接下来我们先来看下在Docker中如何安装GitLab。
二、安装GitLab
具体的安装可以在 https://docs.gitlab.com/omnibus/docker/README.html 看到详细的信息。
docker run --detach --hostname gitlab.example.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
安装完成后可以通过浏览器访问到,作为git仓库其用法和github类似。
三、持续集成CI
GitLab Runner是一个开源项目,用于运行您的作业并将结果发送回GitLab。它与GitLab CI一起使用,GitLab CI是GitLab随附的开源持续集成服务,用于协调作业。https://docs.gitlab.com/runner/ 。
具体对于gitlab runner的详细介绍就请阅读官方文档。这里直接介绍其安装,那么我使用的是centos,就以linux x86-64安装为例。
1. 下载二进制文件
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
2. 赋予其执行权限
chmod +x /usr/local/bin/gitlab-runner
3. 创建用户
useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
4. 安装并运行,如果gitlab-runner安装并作为服务运行,它将以root用户身份运行,但将按照install命令指定的用户执行作业。 这意味着某些作业函数(如缓存和工件)需要执行/usr /local/bin/gitlab-runner命令,因此运行作业的用户需要具有对可执行文件的访问权限。
gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner gitlab-runner start
5. 将gitlab runner注册到gitlab上
(1) 运行命令
gitlab-runner register
(2) 输入GitLab的URL
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com ) https://gitlab.example.com
(3) 输入token,token的获取在Gitlab中,如下图
Please enter the gitlab-ci token for this runner xxx
(4) 输入runner的描述
Please enter the gitlab-ci description for this runner [hostname] my-runner
(5) 输入标签
Please enter the gitlab-ci tags for this runner (comma separated): my-tag,another-tag
(6) 选择Runner的执行者,这里使用shell
Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell: shell
完成之后就可以在GitLab中查看到Runner了
6. 将.Net Core项目提交到GitLab完成自动化集成部署
(1) 在.git 根目录下创建.gitlab-ci.yml文件
rtest: script: - cd User.Api - docker-compose up -d --build --force-recreate
(2) 提交代码到GitLab上,由于22端口被占用改了其他端口,在git 的时候可以使用下面的命令来改变端口
git remote set-url origin ssh://git@172.18.6.155:23/jesen/user.api.git
或者clone仓库的时候直接指定
git clone ssh://git@172.18.6.155:23/jesen/user.api.git
(3) 提交完后,gitlab ci会自动构建镜像并运行,在这中间可能会有问题发生,我遇到的问题是找不到 devtoolset-7 和 git,这时可以是使用yum安装
yum install devtoolset-7 yum install git
(4) 再次重试构建,依然出错
出现此错误是因为权限的问题,之前安装gitlab时创建的gitlab-runner用户没有指定用户组docker,可以查看/etc/group是否存在docker用户组,不存在则先创建 groupadd docker,然后将gitlab-runner用户添加到docker用户组中
gpasswd -a gitlab-runner docker 或 usermod -aG docker gitlab-runner
再次Retry,自动构建成功了
三、部署本地镜像仓库Registry,详细可参考 https://docs.docker.com/registry/
1、安装
docker run -d -p 5000:5000 --restart=always --name registry registry:2
2、给镜像打标签后推送到本地仓库
docker image tag ubuntu localhost:5000/myfirstimage docker push localhost:5000/myfirstimage
3、从本地仓库拉取镜像
docker pull localhost:5000/myfirstimage
4、停止并移除所有数据
docker container stop registry && docker container rm -v registry
5、添加可视化UI:https://github.com/kwk/docker-registry-frontend
docker run -d --name registry-web --link registry:registry -e ENV_DOCKER_REGISTRY_HOST=registry -e ENV_DOCKER_REGISTRY_PORT=5000 -p 8080:80 konradkleine/docker-registry-frontend:v2
四、参考资料
Gitlab CI 官方配置文件参数说明快速入门 :https://docs.gitlab.com/ce/ci/quick_start/README.html
配置文档讲解 :https://docs.gitlab.com/ce/ci/yaml/
持续集成的概念:http://www.ruanyifeng.com/blog/2015/09/continuous-integration.html