首页 > 系统相关 >.Net 5.0 WebAPI 发布至 CentOS 7 系统

.Net 5.0 WebAPI 发布至 CentOS 7 系统

时间:2024-08-30 23:48:21浏览次数:11  
标签:5.0 WebAPI CentOS service 自启动 dotnet swagger

〇、前言

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

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

一、Linux 环境准备

1.1 centos 7.x 在线安装 .net 5.0

第一行命令是添加包源,第二行命令是安装.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

1.2 CentOS 8.x 在线安装 .net 5.0

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

1.3 查看是否安装成功

查看当前版本: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 ~]#

二、示例项目创建和发布

2.1 创建一个测试项目

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

选项(Enable OpenAPI support)选中,默认添加对 swagger 框架的支持。

直接运行起来,看下目标效果:

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

http://localhost:58268/WeatherForecast

2.2 发布步骤

选择发布至文件系统:

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

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

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

三、服务开启和配置自启动

3.1 服务开启

首先,在 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

3.2 将服务配置为系统自启动

在 /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

最后,可以执行 reboot 命令,重启服务器后,对服务进行验证。

参考: https://blog.51cto.com/u_15050718/4565015   https://blog.csdn.net/u010476739/article/details/116710199     https://blog.csdn.net/Dominic_W/article/details/133277301                        

标签:5.0,WebAPI,CentOS,service,自启动,dotnet,swagger
From: https://www.cnblogs.com/hnzhengfy/p/18384107/webapi_centos

相关文章

  • CentOS7 官网停更后的补救措施
    问题一:无法正常使用yum命令。问题描述:终端执行yum-yupdate,报以下错误提示:Couldnotretrievemirrorlisthttp://mirrorlist.centos.org/?release=7&arch=x86_64&repo=os&infra=stock32errorwas14:curl#6-"Couldnotresolvehost:mirrorlist.centos.org;Unknown......
  • Centos-MinIO安装
    1.下载MinIO可执行文件首先,您需要下载MinIO可执行文件。确保您的系统上已经安装了wget,如果没有安装,可以先参考我之前的建议来解决yuminstallwget的问题。下载MinIO:也可以在window在官网或者中文镜像网站下好二进制文件再导入到linux上wgethttps://dl.minio.org.cn......
  • webapi 获取参数值的几种方式
    [FromRoute(Name="名字")],捕捉的值会被自动赋值给Action中同名的参数;如果名字不一致,可以用[FromRoute(Name="名字")][FromQuery]来获取QueryString中的值。如果名字一致,只要为参数添加[FromQuery]即可;而如果名字不一致,[FromQuery(Name=名字)][FromForm]从Content-Type为mult......
  • HarmonyOS开发实战5.0【地址交换动画案例】
    介绍本示例介绍使用显式动画 animateTo 实现左右地址交换动画。该场景多用于机票、火车票购买等出行类订票软件中。效果预览图使用说明加载完成后显示地址交换动画页面,点击中间的图标,左右两边地址交换。实现思路创建左右两边Text组件显示地址。设置初始偏移量以及文......
  • 原神角色数据列表:数据更新到5.0版本,更换品质排序背景颜色,列表可以显示攻略
    <!DOCTYPEhtml><htmllang="zh-CN"><head><metacharset="UTF-8"><metaname="viewport"content="width=device-width,initial-scale=1.0"><title>原神角色数据列表</title>......
  • linux centos 启动 nginx 几种方式
    在CentOS上安装Nginx的方法有几种,具体取决于你的需求和系统版本。以下是几种常见的方法:1.使用EPEL仓库安装(推荐)安装EPEL仓库(如果还没有安装):sudoyuminstallepel-release安装Nginx:sudoyuminstallnginx启动Nginx:sudosystemctlstartnginx设置Nginx开机自启:sudos......
  • CentOS 7.9 内核从 3.10 升级到 5.4
    1.背景介绍环境需求:在搭建Kubernetes(K8S)环境时,内核版本最好大于4.4以支持K8S的所有特性。当前内核版本:CentOS7.9的默认内核版本为3.10.0-1160.el7.x86_64,不满足K8S的推荐内核版本要求。2.查看内核版本及相关包使用命令uname-r查看当前内核版本。使用命令r......
  • CentOS 7 的换源
    CentOS7概述CentOS7是一种基于RedHatEnterpriseLinux(RHEL)源代码构建的开源操作系统。它是一个稳定、安全且功能强大的Linux发行版,被广泛用于企业服务器和桌面环境中。CentOS7的版本是在2014年发布的,以下是CentOS7的一些主要特点:稳定性和可靠性:基于R......
  • java在centos7下部署运行jar包
    1、执行jar包的命令和在windows操作系统上是一样java-jarjarName-0.0.1-SNAPSHOT.jar;注:关闭服务器连接时会关闭此程序进程,(推荐测试可用)2、将jar程序设置成后台运行,并且将标准输出的日志重定向至文件msg.lognohupjava-jarjarName-0.0.1-SNAPSHOT.jar>msg.log2>&......
  • 24.5.0:HOOPS Publish SDK
    向您的应用程序添加3DPDF导出等功能通过使用HOOPSPublishSDK向您的工程应用程序添加交互式3DPDF、HTML和标准CAD格式导出(包括STEPAP242、JT10、IGES、STL和3MF),增强您的工程应用程序。用于创建丰富工程文档的3DCAD发布SDKHOOPSPublishSDK可帮助开发......