Azure DevOps (十一) 通过Azure Devops部署一个.NET Core WebAPI

前几篇文章中,我们讨论了如何通过流水线实现项目的编译、上传、打包、部署等操作,今天我们来实现一套完整的流程,把之前碎片化的知识点给串起来。

文章配套视频专栏:

https://space.bilibili.com/38649342/channel/seriesdetail?sid=2267536

本次我们使用一个ASP.NET Core的WebApi项目来进行项目的演示,后面也会写java和golang的。

首先我们先创建一个ASP.NET Core WebAPI的模板项目,使用IDE创建就可以,我用的是jb全家桶的rider.

 

创建完成之后,我们稍微对项目做一点点修改,主要修改的内容为:关闭HTTP重定向,关闭鉴权,更改启动端口为5001.

在Program.cs中删除 HTTP重定向,鉴权的代码,在luanchsetting.json中更改启动端口为5000,注意这里改的只是你本地debug时候的端口和编译后部署时的不是一个配置。

 

 

 这些搞好之后,启动项目,会自动弹开swagger的页面,我们访问一下里面的模板接口,可以看到返回了一个标准的json数据结构。

 

这些都准备好之后,我们把我们的代码推送到仓库里去,创建仓库的步骤不在赘述,我在系列文章的第一篇里已经做了介绍:《Azure DevOps (一) 托管自己的Git仓库

代码推送好之后,我们开始创建编译流水线来编译我们的webapi代码。

点击流水线,创建流水线之后右侧第一个选项就是.NET Core。毕竟是微软的亲儿子,地位都不一样,点击添加之后,我们可以看到有很多的选项

来执行不同的阶段,我们本次的目标是部署项目,所以我们使用publish来执行。

 

 

 添加的时候这里要注意下把web project的勾给取消掉,打这个勾是默认编译mvc项目的他会去找你的wwwroot文件和webconfig

 

 

 

勾选完之后我们执行一下编译,然后就发现了一个天大的雷,身为微软的亲儿子,这个.NET Core的编译插件居然TM的不支持.NET 6,是的,你没听错,我都怀疑这爹不是亲的。(╯‵□′)╯︵┻━┻

 

 

 

 既然出了这档子事儿,我们也只能自己想办法了,我选择的是自己下载.NET6的SDK,自己编译。

我们打开.net core的官网,选择linux安装.net core sdk  网站地址:https://docs.microsoft.com/zh-cn/dotnet/core/install/linux-ubuntu#2110-

因为我们流水线的运行环境是乌班图,所以我装的是乌班图的。

安装命令如下:

wget https://packages.microsoft.com/config/ubuntu/21.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update; \
sudo apt-get install -y apt-transport-https && \
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-6.0

然后我们在执行一下编译命令 dotnet publish

最后我们整理一下azure的流水线脚本,因为没有插件可用,所以这次的脚本需要我们自己纯手打,我们在script节点中加入sdk安装命令,然后创建第二个scprit节点用来进行项目的编译

当然全部写在一个里面也没有什么问题,但是还是建议分开,看着清爽。

脚本如下:

# Starter pipeline
# Start with a minimal pipeline that you can customize to build and deploy your code.
# Add steps that build, run tests, deploy, and more:
# https://aka.ms/yaml

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- script: echo Hello, world!
  displayName: 'Run a one-line script'

- script: |
    echo Add other tasks to build, test, and deploy your project.
    echo See https://aka.ms/yaml
    wget https://packages.microsoft.com/config/ubuntu/21.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
    rm packages-microsoft-prod.deb
    sudo apt-get update; \
    sudo apt-get install -y apt-transport-https && \
    sudo apt-get update && \
    sudo apt-get install -y dotnet-sdk-6.0
  displayName: 'Run a multi-line script'
- script:
   cd /home/vsts/work/1/s;
   dotnet publish;
   cd /home/vsts/work/1/s/azure_dotnet_app/bin/Debug/net6.0/publish/;
   ls
  displayName: "publish dotnet"

然后我们运行一下看看效果,可以看到成功的安装了SDK6

 

然后执行dotnet publish,这次成功完成了编译

 

 

 编译完之后,我们需要添加一下制品上传步骤,和我们之前的文章中一样,我们需要把制品上传到流水线的仓库上去方便后面使用。

编辑流水线,添加制品上传,目录选择我们的publish的目标目录,最后完成的流水线脚本如下:

# Starter pipeline
# Start with a minimal pipeline that you can customize to build and deploy your code.
# Add steps that build, run tests, deploy, and more:
# https://aka.ms/yaml

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- script: echo Hello, world!
  displayName: 'Run a one-line script'

- script: |
    echo Add other tasks to build, test, and deploy your project.
    echo See https://aka.ms/yaml
    wget https://packages.microsoft.com/config/ubuntu/21.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
    rm packages-microsoft-prod.deb
    sudo apt-get update; \
    sudo apt-get install -y apt-transport-https && \
    sudo apt-get update && \
    sudo apt-get install -y dotnet-sdk-6.0
  displayName: 'Run a multi-line script'
- script:
   cd /home/vsts/work/1/s;
   dotnet publish;
   cd /home/vsts/work/1/s/azure_dotnet_app/bin/Debug/net6.0/publish/;
   ls
  displayName: "publish dotnet"


- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '/home/vsts/work/1/s/azure_dotnet_app/bin/Debug/net6.0/publish/'
    ArtifactName: 'dotnet_app'
    publishLocation: 'Container'

完成之后运行流水线,我们就可以在流水线的运行脚本结果中看到我们的流水线制品

 

 然后接下来,我们去创建发布流水线,发布流水线的内容非常简单,前几篇的文章中我们使用的是FTP,后来我发现SFTP更好用,所以这里我们用SFTP

 

 

 然后我们去准备一下服务器的环境,在服务器上安装一下sdk和nginx,顺道配置一下守护进程,代码如下:

centos安装sdk:

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install dotnet-sdk-6.0

安装nginx

yum install nginx
systemctl restart nginx

配置守护进程

[Unit]
Description=Example .NET Web API App running on Ubuntu

[Service]
WorkingDirectory=/home/dotnet_app
ExecStart=/usr/bin/dotnet /home/dotnet_app/azure_dotnet_app.dll
Restart=always
# Restart service after 10 seconds if the dotnet service crashes:
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=dotnet-example
User=root
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

配置反向代理:

server {
        listen       80;
        listen       [::]:80;
        server_name  _;
        root         /usr/share/nginx/html;
  location / {
        proxy_pass         http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }
        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

启动守护进程:

systemctl enable app
systemctl start app
systemctl status app

查看服务状态,服务正常运行。

 

 然后,我们更改一下项目的源代码,返回一句祖传问候

 

 然后在流水线中添加脚本命令:systemctl restart app

 

 最后我们重新运行一下流水线,等待流水线运行完后,我们访问一下接口地址

 

 

成功输出祖传问候,第一个ASP.NET Core的流水线创建成功,完结撒花。

文章虽短,但是写这篇文章用了三个小时才完成,踩了一堆的坑,大家在调试过程中需要多多注意。

页面下部广告