.Net 5.0 WebAPI 发布至 Linux 系统

阅读目录

〇、前言

本文主要介绍了在 CentOS 7 上部署 WebAPI 项目的过程。

先安装 .net 5.0 的环境，再创建一个示例项目并发布至 CentOS 上，同时列明了一些注意的点；最后将 dotnet 命令添加到系统自启动服务。

第一行命令是添加包源，第二行命令是安装.Net Core版本的包
首先，配置仓库：
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
然后，执行安装命令，二者其一：

	sudo yum install dotnet-sdk-5.0 -y
	sudo dnf install dotnet-runtime-5.0 -y
	# 使用 dnf 命令时，会出现报错【sudo: dnf: command not found】
	# 这个错误表明你的系统中没有安装 dnf 包管理器，可以手动安装 dnf 的支持：sudo yum install dnf

直接执行命令：
sudo dnf install dotnet-sdk-5.0

查看当前版本：dotnet --version；
查看详情：dotnet --info。

	[root@localhost ~]# dotnet --info
	.NET SDK (reflecting any global.json):
	Version: 5.0.408
	Commit: da985e2a23

	Runtime Environment:
	OS Name: centos
	OS Version: 7
	OS Platform: Linux
	RID: centos.7-x64
	Base Path: /usr/share/dotnet/sdk/5.0.408/

	Host (useful for support):
	Version: 5.0.17
	Commit: 6a98414363

	.NET SDKs installed:
	5.0.408 [/usr/share/dotnet/sdk]

	.NET runtimes installed:
	Microsoft.AspNetCore.App 5.0.17 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]
	Microsoft.NETCore.App 5.0.17 [/usr/share/dotnet/shared/Microsoft.NETCore.App]

	To install additional .NET runtimes or SDKs:
	https://aka.ms/dotnet-download
	[root@localhost ~]#

下面简单创建一个测试项目：WebAPI.WebApplication.Test。

选项（Enable OpenAPI support）选中，默认添加对 swagger 框架的支持。

直接运行起来，看下目标效果：

http://localhost:58268/swagger/index.html

http://localhost:58268/WeatherForecast

选择发布至文件系统：

然后找到发布文件夹：（需要将此文件夹中的文件全部上传至 CentOS 服务器）

WebAPI.WebApplication.Test\bin\Release\net5.0\publish

上传至 CentOS 的 /home/webapi.test 文件夹中，备用。（上传方法就略过了）

首先，在 Startup.cs 文件中将 Swagger 的配置放出来：

	public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
	{
	if (env.IsDevelopment())
	{
	app.UseDeveloperExceptionPage();
	}
	// 如下两行，原来在 if 里边，放到外边，就无论是什么环境都可加载 Swagger
	app.UseSwagger();
	app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "WebAPI.WebApplication.Test v1"));

	app.UseRouting();

	app.UseAuthorization();

	app.UseEndpoints(endpoints =>
	{
	endpoints.MapControllers();
	});
	}

另外，文件 launchSettings.json，注意如下备注的两个配置项：

	{
	"$schema": "http://json.schemastore.org/launchsettings.json",
	"iisSettings": {
	"windowsAuthentication": false,
	"anonymousAuthentication": true,
	"iisExpress": {
	"applicationUrl": "http://localhost:25863",
	"sslPort": 0
	}
	},
	"profiles": {
	"IIS Express": {
	"commandName": "IISExpress",
	"launchBrowser": true,
	"launchUrl": "swagger",
	"environmentVariables": {
	"ASPNETCORE_ENVIRONMENT": "Development"
	}
	},
	"WebAPI.WebApplication.Test": {
	"commandName": "Project",
	"dotnetRunMessages": "true",
	"launchBrowser": true,
	// 配置路径参数，示例：http://localhost:5000/swagger
	// 路径上要加上 swagger 才能访问
	"launchUrl": "swagger",
	"applicationUrl": "http://localhost:5000",
	"environmentVariables": {
	// 环境变量配置，服务启动时，必须加上对应的环境变量"Development"
	"ASPNETCORE_ENVIRONMENT": "Development"
	}
	}
	}
	}

使用 dotnet 命令直接开启服务试试：

 dotnet /home/webapi.test/WebAPI.WebApplication.Test.dll -server.urls "http://*:5000" --environment Development

在 /etc/systemd/system/ 路径下，新增一个 webapi.test.service 文件，文件内容如下：

	# Unit 文件描述，webapi 为服务文件名
	[Unit]
	Description=weapi.test service

	# Service 配置参数
	[Service]
	Type=simple
	GuessMainPID=true

	# 自启动项目所在的位置路径
	WorkingDirectory=/home/webapi.test
	StandardOutput=journal
	StandardError=journal

	# 自启动项目的命令
	# 用 dotnet 启动，所以前面添加了 dotnet 的路径 /usr/bin/，后边就是 dotnet 命令的配置参数
	ExecStart=/usr/bin/dotnet /home/webapi.test/myProject.Test.dll --Urls=http://*:5000
	Restart=always
	RestartSec=30

	[Install]
	WantedBy=multi-user.target

操作服务的相关命令：

	# 启动
	systemctl start xxx.service
	# 查看当前状态
	systemctl status xxx.service
	# 重新启动
	systemctl restart xxx.service
	# 查看所有已启动的服务
	systemctl list-units --type=service

	# 设置开机自启动
	systemctl enable xxx.service
	# 停止开机自启动
	systemctl disable xxx.service