使用Gitlab-CI 实现NetCore项目Docker化并部署到阿里云K8S

素颜马尾好姑娘i 2021-12-09 01:13 532阅读 0赞

**先行条件：**

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

![646268-20190715163124715-1311582642.png][]

![646268-20190715163148142-290263193.png][]

然后执行如下命令：(文章末尾有专门的命令解析参考地址)

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中查看 如下图：

![646268-20190715163207124-1339831126.png][]

3.安装Docker环境

安装Docker环境是为了我们把应用打包成 DockerImage 后上传到 阿里云的镜像仓库中 用于k8s的应用部署。

安装Docker大家自行 google 这里不再介绍如何安装。

4.编写Dockerfile 脚本

如果是NetCore 项目Dockerfile 脚本应该在项目的根目录下面(官方推荐)如下图是我的项目。

![646268-20190715163710258-1143749544.png][]

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项目并且有解决方案，那么这个脚本应该创建在解决方案的根目录下。

如下图：

![646268-20190715164129272-1736469504.png][]

.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 为例 要推送的项目 如下截图

![646268-20190715165833408-1133963412.png][]

![646268-20190715170049693-662723868.png][]

script：必须存在的。在这里面的可以写任何脚本命令。其实就是命令行。
    当最后执行完 docker push 命令的时候我的阿里云镜像仓库就可以看到了

![646268-20190715170520913-1931180847.png][]

最后就是通过当前镜像部署K8S应用了。
    参考文档：
    Gitlab CI yaml官方配置文件翻译：https://segmentfault.com/a/1190000010442764
    Gitlab Runner:https://docs.gitlab.com/runner/install/linux-manually.html

转载于:https://www.cnblogs.com/sunqiang/p/11190000.html

[646268-20190715163124715-1311582642.png]: /images/20211209/4170e669fb01431e910d999541ff8328.png
[646268-20190715163148142-290263193.png]: /images/20211209/1b506c8e4a7e4d5884a0bc8a8d273625.png
[646268-20190715163207124-1339831126.png]: /images/20211209/a663dee3253d427fbc33a285065ee5e0.png
[646268-20190715163710258-1143749544.png]: /images/20211209/0b3a248a3d354028ba0e81aa8bbf4276.png
[646268-20190715164129272-1736469504.png]: /images/20211209/3f5ef80a8eb3432bb0a859dd85ecf722.png
[646268-20190715165833408-1133963412.png]: /images/20211209/7049706b13124fb18d1dd15e466c26be.png
[646268-20190715170049693-662723868.png]: /images/20211209/2fcc7e3d4a98423c93be412da761f607.png
[646268-20190715170520913-1931180847.png]: /images/20211209/e094bd5233ba4f64974642ec1ebc9c10.png