色破飞机 发表于 2017-12-6 10:15:56

Ubuntu & GitLab CI & Docker & ASP.NET Core 2.0 自动化发布和部署(2)

  上一篇:Ubuntu & GitLab CI & Docker & ASP.NET Core 2.0 自动化发布和部署(1)
  服务器版本 Ubuntu 16.04 LTS。
  本篇博文目的:项目中添加Dockerfile文件,使用 CI 脚本构建自定义镜像,推送到 Docker 私有仓库,然后在服务器上拉取镜像并创建相应容器,最后启动容器,完成发布和部署。
  实现上面目的,大概有三种实现方式:


[*]GitLab Runner 不运行在 Docker 容器中:Executor 选择shell(本地运行),然后在本服务器上安装 .NET Core 和 Docker 环境,.gitlab-ci.yml中执行dotnet编译发布和docker构建发布脚本,将构建的镜像推送到 Docker 私有仓库,然后 SSH 连接到服务器,拉取镜像并创建相应容器,最后启动容器,完成发布和部署。
[*]GitLab Runner 运行在 Docker 容器中:Executor 选择shell(GitLab Runner 容器中运行),然后进入 GitLab Runner 容器,在上面安装 .NET Core 和 Docker 环境,.gitlab-ci.yml中执行dotnet编译发布和docker构建发布脚本,后面同上操作。
[*]GitLab Runner 运行在 Docker 容器中:Executor 选择docker(指定镜像容器中运行),需要自定义构建一个包含 .NET Core 和 Docker 环境的镜像,构建脚本执行在自定义镜像容器中,.gitlab-ci.yml中执行dotnet编译发布和docker构建发布脚本,后面同上操作。
  上面三种方式,最简单的是第一种,第二种和第三种比较类似,实现稍微复杂点,我也没有配置成功,下面分别说下。

1. GitLab Runner 运行在 Docker 容器中
  第二种和第三种实现方式,放在一块说,如果 Executor 选择shell,然后我们需要在 GitLab Runner 容器中配置编译环境,但这样会产生一个问题,就是如果我们是升级 GitLab Runner 的时候,需要重新配置编译环境,实际情况是,我进入容器docker exec -it gitlab-runner bash,并没有安装成功 .NET Core 和 Docker 环境(各种服务器中没出现的问题,而且速度非常慢),其实,还有一种方式,就是在.gitlab-ci.yml中执行安装 .NET Core 和 Docker 环境的脚本(检查是否安装),不过,编写是有些问题,这个我没进行尝试。
  如果 Executor 选择docker,其实,这样会嵌套很多容器,首先服务器上运行 GitLab Runner 容器,然后在此容器内,运行另外一个构建容器,然后在此容器内,执行构建和发布操作,因为 GitLab Runner 在每次构建的时候,会创建和运行一个新的构建容器,所以,我们不能直接在这个容器中,配置 .NET Core 和 Docker 环境,也不能在.gitlab-ci.yml中执行安装,因为每次都会覆盖之前的操作,唯一的解决方式,就是自定义构建一个包含 .NET Core 和 Docker 环境的镜像文件,然后每次构建使用它进行创建对应容器,执行构建和发布脚本即可。
  这里说下,自定义构建一个包含 .NET Core 和 Docker 环境的镜像文件,两种方式:


[*]docker build -t 139.219.65.81:5000/xishuai-gitlab-ci-build .:在Dockerfile文件编写安装环境脚本。
[*]docker commit microsoft-aspnetcore 139.219.65.81:5000/xishuai-gitlab-ci-build:使用一个容器,然后在容器中安装环境,最后基于这个容器,创建一个自定义镜像文件
  第一种方式,我没有进行尝试,第二种方式尝试了下,我使用microsoft/aspnetcore镜像作为基础镜像(800M 左右),然后在其创建的容器中安装 Docker 环境,速度非常慢,而且有时候报各种奇怪的错误,如果安装成功了,左右构建的自定义镜像文件,也非常的大。
  这两种方式,我最后都没有采用,最后使用的是下面最简单的方式。

2. GitLab Runner 不运行在 Docker 容器中(Executor 选择 Shell)
  如果我们不使用 Docker 安装和运行 GitLab Runner,就得手动进行安装和配置下 GitLab Runner。
  安装命令:
$ sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-amd64  然后进行给予其权限:
$ sudo chmod +x /usr/local/bin/gitlab-runner  接着就可以进行注册 GitLab Runner 了,命令:
  

$ sudo gitlab-runner register  

  示例配置:

  配置好之后,我们需要添加一个用于跑 GitLab Runner 的gitlab-runner用户,命令:
$ sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash  然后指定 GitLab Runner 执行的用户和工作目录,命令:
$ sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner  配置好之后,我们可以从配置文件中,查看相关配置信息:
$ cat /etc/systemd/system/gitlab-runner.service  

  
Description=GitLab Runner
  
After=syslog.target network.target
  
ConditionFileIsExecutable=/usr/bin/gitlab-ci-multi-runner
  

  

  
StartLimitInterval=5
  
StartLimitBurst=10
  
ExecStart=/usr/bin/gitlab-ci-multi-runner "run" "--working-directory" "/home/gitlab-runner" "--config" "/etc/gitlab-runner/config.toml" "--service" "gitlab-runner" "--syslog" "--user" "gitlab-runner"
  

  

  

  

  

  
Restart=always
  
RestartSec=120
  

  

  
WantedBy=multi-user.target
  上面工作完成之后,就可以启动 GitLab Runner 了,命令:
$ sudo gitlab-runner start  然后,我们就可以在项目中看到 GitLab Runner 了,示例:

  另外,我们还需要做一些其他工作,来保证 GitLab Runner 可以正常运行。
  两台服务器需要配置的环境:


[*]GitLab Runner 服务器:.NET Core 2.0、Docker、Docker 私有仓库(或者其他服务器)、SSH
[*]测试服务器:Docker
  首先,我们需要创建一个 Docker 私有仓库,用于存放程序生成的镜像,这个最好是配置在一个单独的服务器,配置详见:Ubuntu Docker Registry 搭建私有仓库
  通过下面两个连接,查看 Docker 私有仓库中的镜像:


[*]http://139.219.69.172:5000/v2/_catalog
[*]http://139.219.69.172:5000/v2/hwapp/tags/list
  然后,我们需要把 GitLab Runner 服务器中的gitlab-runner账户,添加到docker用户组中,命令:
$ sudo usermod -aG docker gitlab-runner  否则会报如下错误:

  然后,我们在 GitLab Runner 服务器中,切换到gitlab-runner用户下,配置 SSH,命令:
$ su gitlab-runner  
$ ssh-keygen -t rsa -P ''
  
$ ssh-copy-id root@139.219.69.172
  139.219.69.172是测试服务器的 IP 地址,如果不进行这样配置,SSH 连接的时候,会报如下错误:

  原因是,GitLab Runner 在执行脚本的时候,会切换到gitlab-runner用户下,我们在root账户下配置 SSH,是无效的。
  以上工作完成之后,GitLab Runner 执行编译脚本,基本上执行是没有问题了,我们在示例项目中添加.gitlab-ci.yml配置文件,示例:
stages:  - build
  - deploy_dev
  
build_job:
  stage: build
  only:
  - master
  script:
  - dotnet restore
  - dotnet build
  
deploy_dev_job:
  stage: deploy_dev
  environment:
  name: development
  only:
  - master
  script:
  # 发布程序并部署运行

  - dotnet publish -c>  - docker build -t $GITLAB_SERVER:5000/hwapp .
  - docker push $GITLAB_SERVER:5000/hwapp
  - ssh root@$DEPLOY_SERVER_DEV "docker pull $GITLAB_SERVER:5000/hwapp && docker run -d -p 5001:5001 $GITLAB_SERVER:5000/hwapp"
  build_job执行效果:

  deploy_dev_job执行效果:

  

  然后,我们在测试服务器上,就可以看到创建和运行的容器了:

  浏览器打开http://139.219.110.30:5001/api/values,查看效果:

  参考资料:


[*]Manual installation and configuration on GNU/Linux
[*]Registering Runners
[*]Using SSH keys
[*]GitLab CI 自动部署 netcore web api 到 Docker
页: [1]
查看完整版本: Ubuntu & GitLab CI & Docker & ASP.NET Core 2.0 自动化发布和部署(2)