使用Gitlab-CI 实现NetCore项目Docker化并部署到阿里云K8S
先行条件:
1.了解NetCore项目基础命令,如dotnet publish 等几个常用命令。
2.了解Docker基础命令
3.了解centos基础命令
部署步骤:
大致会分为如下几个步骤,后面会详细解析
1.安装 Runner
2.注册 Runner
3.安装Docker环境
4.编写Dockerfile 脚本
5.编写 .gitlab-ci.yml 脚本
6.Push 代码
步骤分解:
1.安装 Runner (文章末尾有专门的命令解析参考地址)
Runner简介:Runner是配合 gitlab-ci 一起使用的,它可以拉取gitlab的代码并且执行一些命令,例如编译代码 发布代码等。并且最后将结果通知给Gitlab-CI。
我们Runner可以安装在任何系统的任何位置,我这里把他安装在centos系统中。
安装步骤如下:
1.1.为您的系统下载其中一个二进制文件:
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
1.2.赋予它执行权限:
sudo chmod +x /usr/local/bin/gitlab-runner
1.3.创建GitLab CI用户:
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
1.4.安装并作为服务运行:
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start
2.注册 Runner
注册ranner是指让你刚刚安装的 runner与你的gitlab关联起来,使他有权限来访问你的代码并且发送通知给gitlab-ci。
2.1.执行注册命令
先开打如下图的页面找到 URL 和 Token
然后执行如下命令:(文章末尾有专门的命令解析参考地址)
sudo gitlab-runner register
会提示您输入 URL和Token 先把上图的URL 复制 粘贴 回车。然后在复制Token 粘贴 回车。
下面就会提示输入 Please enter the gitlab-ci description for this runner (输入描述)可直接跳过或者随便输入或稍后再GitLabUI中输入都可以。
接着提示输入 Please enter the gitlab-ci tags for this runner (comma separated) (输入标签信息 )可直接跳过或稍后再GitLabUI中输入都可以。
接着提示输入 Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh (输入Runner执行程序)我们这里输入 : shell 然后回车。
最后到这里就说明runner已经安装成功并且跟项目关联成功了,我们可以在 GitLab中查看 如下图:
3.安装Docker环境
安装Docker环境是为了我们把应用打包成 DockerImage 后上传到 阿里云的镜像仓库中 用于k8s的应用部署。
安装Docker大家自行 google 这里不再介绍如何安装。
4.编写Dockerfile 脚本
如果是NetCore 项目Dockerfile 脚本应该在项目的根目录下面(官方推荐)如下图是我的项目。
Dockerfile 内容:
FROM mcr.microsoft.com/dotnet/core/aspnet:2.2
COPY . /root/publish/api.config.internal
WORKDIR /root/publish/api.config.internal
ENV ASPNETCORE_URLS http://*:7012
ENV ConnectionStrings_ConfigDbContext server=10.10.10.228;port=5566;user id=uat_ApiConfigCenterManage_Web;password=4g4TesrWg4;database=ApiConfigCenterDB;persistsecurityinfo=True;SslMode=None
ENV LoggerSettings_ClientName configcenter.internalapi_aliyun_log
ENV LoggerSettings_ServerUrl http://ulog.colipu.com:8080/v1/logs
ENV LoggerSettings_Level error
ENTRYPOINT ["dotnet", "Api.ConfigCenter.InternalApi.dll"]
以上为的Docfile脚本,大家可以参考一下,脚本中必须的命令是 FROM COPY WORKDIR ENTRYPOINT 这几个。至于为什么这样写大家可参考Docker官方文档。
5.编写 .gitlab-ci.yml 脚本
如果你的是netCore项目并且有解决方案,那么这个脚本应该创建在解决方案的根目录下。
如下图:
.gitlab-ci.yml 脚本内容:
stages: - build-image-internalapi - build-image-manageapi job1: stage: build-image-internalapi only: refs: - tags variables: - $CI_COMMIT_TAG =~ /^internalapi-.*/ script: # The output path is relative to the position of the csproj-file - dotnet publish -c Release -o ../publishinternalapi ./Api.ConfigCenter.InternalApi/Api.ConfigCenter.InternalApi.csproj --configfile Nuget.config - docker login -u sunqiang@aliyun -p Aa123456 registry-vpc.cn-shanghai.aliyuncs.com - cd publishinternalapi/ - docker build -t registry-vpc.cn-shanghai.aliyuncs.com/clp-cip-apisystem/cip-configcenter-internalapi:$CI_COMMIT_TAG . - docker push registry-vpc.cn-shanghai.aliyuncs.com/clp-cip-apisystem/cip-configcenter-internalapi:$CI_COMMIT_TAG job2: stage: build-image-manageapi only: refs: - tags variables: - $CI_COMMIT_TAG =~ /^manageapi-.*/ script: # The output path is relative to the position of the csproj-file - dotnet publish -c Release -o ../publishmanageapi ./Api.ConfigCenter.ManageApi/Api.ConfigCenter.ManageApi.csproj --configfile Nuget.config - docker login -u sunqiang@aliyun -p Aa123456 registry-vpc.cn-shanghai.aliyuncs.com - cd publishmanageapi/ - pwd - docker build -t registry-vpc.cn-shanghai.aliyuncs.com/clp-cip-apisystem/cip-configcenter-manageapi:$CI_COMMIT_TAG . - docker push registry-vpc.cn-shanghai.aliyuncs.com/clp-cip-apisystem/cip-configcenter-manageapi:$CI_COMMIT_TAG
注意:yml脚本对格式要求非常严格,所以不能有一点儿错。
有了这个脚本之后,在你每次Push代码的时候GitLab会检测到项目的根目录是否有.gitlab-ci.yml 文件 如果有就会执行里面的内容。
脚本解释:(文章末尾有专门的命令解析参考地址)
stages:表示 定义构建的阶段,我这里定义了2个阶段,因为我这个解决方案下面有两个项目。也可以定义一个那就是把脚本全部写在一块了。
job1:表示第一个阶段的名字,这个是自定义的。
stage:定义job stage (默认:test
) 表示要执行哪个阶段
only:定义一列git的分支。 refs tags 表示只通过标签的形式触发job任务来构建应用(如果不这样写,那你每次推送代码的时候都会执行job)
variables:表示在job中是可以使用关键字variables
来定义job变量。
$CI_COMMIT_TAG =~ /^manageapi-.*/ 表示我以标签 manageapi-v1 为例 要推送的项目 如下截图
script:必须存在的。在这里面的可以写任何脚本命令。其实就是命令行。
当最后执行完 docker push 命令的时候我的阿里云镜像仓库就可以看到了
最后就是通过当前镜像部署K8S应用了。
参考文档:
Gitlab CI yaml官方配置文件翻译:https://segmentfault.com/a/1190000010442764
Gitlab Runner:https://docs.gitlab.com/runner/install/linux-manually.html