Blog.Core 專案已完成升級.NET5.0

老張的哲學發表於2020-11-12

(是時候拿出來這種圖了)

 

 本文首發於公眾號,但是會有新的內容加進來,所以就在部落格園新開了一篇,望見諒。截止發稿,Blog.Core專案Master分支已經遷移到了5.0,新建了3.1的分支。

 

 

 

 

開心的鑼鼓

想必這兩天最熱鬧的幾個詞語,就是c#9.0、.net5.0還有conf大會了吧,當然還有大一統。

 

其實,早在2019年年中,就已經引入了.NET5.0了,然後從2020-03-16開始,就一直在說.NET5.0的正向積極迭代釋出過程,前前後後經歷了8個預覽版,2個最終測試版,終於在2020-11-10釋出了v5.0.0版本。

 

當然,我也是二話不多說,直接開始升級更新,我先用我的Blog.Core專案測試,大家也可以先用我的這個專案試試,如果沒啥問題,可以放心的升級自己的線上產品,當然,我還是是建議升級的,很多公司都直接把測試版上了生產環境了,比如:cnblogs.com,dot.net,bing.com什麼的,穩定性是靠的住的,特別是在效能提升和降低web應用託管成本上有很好的表現,當然如果你已經會了netcore3.x,不用擔心升級帶來的壓力,因為沒有壓力。具體內容:

可以檢視官方PM的官宣文件:

https://devblogs.microsoft.com/dotnet/announcing-net-5-0

 

同時可以檢視下升級方案:

https://docs.microsoft.com/en-us/aspnet/core/migration/31-to-50?view=aspnetcore-5.0&tabs=visual-studio

 

下載.NET 5.0 SDK (v5.0.100):

https://dotnet.microsoft.com/download/dotnet/5.0

 

下載VS2019:

https://visualstudio.microsoft.com/zh-hans/vs/whatsnew/

 

檢視C#相關內容

https://devblogs.microsoft.com/dotnet/c-9-0-on-the-record/

 

瞭解.NET Conf安排

https://devblogs.microsoft.com/dotnet/net-5-0-launches-at-net-conf-november-10-12/

 

 

 

有哪些改進

首先就是效能,許多元件的效能都已經得到了很大的提高,比如Arm64效能和gRPC。

然後就是新語言的改進,C#9和F#5提供了新的語言改進,比如頂級程式,比如邏輯和屬性模式匹配,比如Record記錄,比如可空註釋,當然還有Windows的窗體設計器。

還有一些其他的,比如Json序列化,正則,HTTP效能,垃圾回收。

還有ClickOnce客戶端釋出,單檔案應用程式,縮小容器映象大小等等。

當然,我這裡也就是泛泛而談,網上已經充滿了各種資料,想必都已經看過了,我就不贅述了。

 

 

關於命名的問題

這個已經不是一個同學問我了,為啥叫.NET5.0,這裡是兩部分,第一個就是.NET,這個是很好理解的,畢竟是大一統嘛。

.NET 5 = .NET Core vNext,

簡單點說呢,就是在Core的基礎上,把Framework的大部分Api給融入了進去,這樣就是統一了。

 

然後就是5.0了,這裡有個圖,你一看就知道啥意思了:

 

 

 

就是要和.NETFramework做區分,所以取名為5的版本,是這個意思。

 

好啦,基本的的介紹呢,如果要鋪開了來講,三篇都不夠,所以關於效能的除錯等資料,以後會出報告,我們先懷著激動的心直接升級專案吧,更多的文件以後同步更新。

 

 

 

 

 

 

 

一、更新開發環境

 

其實我們都是從2.0一路升級過來的,各種套路已經輕車熟路了,還是老規矩,升級VS就行了。

 

1、升級VS

 

如果你是用的VSCode的話,C#外掛已經支援了.NET5和C#9,更新即可:

https://code.visualstudio.com/docs/languages/dotnet

 

如果是VS2019的話,直接升級到16.8版本即可,官方已經正式釋出了,首先更新安裝程式。

 

 

 

(更新VS Installer)

 

我這裡是目前知識安裝了web開發相關的功能元件

 

 

(安裝核心功能元件)

 

我們切換頂部欄目,可以看到第一個就是.NET5的執行時:

 

 

(支援的執行時)

 

當然,如果你要開發移動端和桌面應用程式,這四個也需要勾選了

 

 

(其他功能元件)

 

 

接下來就是等待安裝成功了

 

 

(vs成功安裝至16.8.0)

 

到這裡就完成了升級開發環境的過程,當然,如果不放心,可以檢視下:

 

 

(SDK成功安裝至5.0)

 

 

2、更新專案

 

這個就更簡單了,自從netcore3.0穩定了以後,無論是升級到LTS的3.1,還是.NET5.0,都是特別簡單,直接修改專案檔案.csproj就行:

 

 

(更新csproj檔案)

 

當然,你也可以右鍵,更新屬性

 

 

(更新專案屬性)

 

就這樣,我們把每一層都更新到.NET5.0後,然後同時也把引用的nuget也都升級到最新,就ok了,這個不贅述,簡單升級就行。

 

最後,清理解決方案,然後重新編譯下,可以看到,0 fail,0 error,就是這麼絲滑!

 

 

(專案全部編譯通過)

 

啟動執行專案,就可以看到效果了

 

(專案升級完成)

 

 

3、新建專案

 

剛剛演示的是更新一個我們之前的專案的,那如何新建專案,會不會有變化呢,可以看看。

首先,選擇SDK的時候,還是帶了core,這個應該是做統一吧

 

 

(新建.NET5.0專案)

 

雖然這裡還是帶了Core,但是無礙。

除此之外,可以看到,如果新建API專案,右側多了一個OpenAPI的支援,勾選框可以看到,其實是我們經常使用的Swagger,可見官方也預設了這種方式。

 

進到專案裡,也看到了和3.1是一樣的,只不過官方承諾的引數提示終於完整的加上了,VS2019預覽版做的不是很好,目前這個已經很OK了。

如果升級到16.8,還是沒有看到,需要開啟下配置,在工具-選項-編輯器-C#-高階-開啟內聯引數

 

 

(VS引數提示)

 

 

 

那本地開發我們們說完了,伺服器怎麼來操作下呢,沒有任何麻煩,十分簡單,我下邊會說兩個情景,一個是直接Linux伺服器+Docker託管執行的,一種是基於Jenkins下使用Docker託管的。

 


Blog.Core 專案已完成升級.NET5.0

 

二、Linux+Docker

 

如果你是用pm2之類的元件託管的,那隻需要直接在Linux伺服器上安裝5.0就行,無論是執行時還是SDK,我直接安裝的SDK,我用的是CentOS:

sudo yum update or refresh sudo yum install dotnet-sdk-5.0 

注意下,如果你的是全新的伺服器,一定要先安裝微軟的一些配置和依賴:

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm

 

現在環境好了,可以用命令列試試,是否可以執行我們的專案:

 

 

(第一次釋出,會有歡迎提示)

 

然後執行下發布後的檔案:

dotnet xxxx.dll

很好,沒問題,那接下來就需要用docker構建映象了。

 

 

構建docker映象

 

這裡有個小小的插曲,要注意一下,如果你的專案之前已經用了dockerfile,並且是微軟的官方源映象,那需要修改下地址,之前的版本是這樣的:

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS baseWORKDIR /appEXPOSE 80

如果你直接修改3.1為5.0,那用這個Dockerfile構建映象是找不到源映象的,新版的是這樣的:

FROM mcr.microsoft.com/dotnet/aspnet:5.0-buster-slim AS baseWORKDIR /appEXPOSE 80

 

沒錯,你一定看出來了,少了一個core的路徑,從這個小地方,就可以看得出來,微軟官方的想法是怎樣的。

 

好啦,那沒有什麼了,直接提交到伺服器,構建映象吧:

 

 

 

完成。

 

 

 

三、Docker+Jenkins

 

如果你是一直跟著我的教程走的,肯定知道前段時間我搞了一個基於docker容器版本的Jenkins,來快速實現CI/CD,目前一切良好。

而且你肯定也知道我是自建了一個Jenkins的映象,因為我在裡邊新增了DotNetCore和NPM的依賴元件,那之前是3.1的SDK,現在我又升級了下,新增了.NET5.0的SDK:

 

 

(自建Jenkins映象,core版本)

 

如果你想看具體的構建內容和過程,可以看這篇文章《升級Jenkins:釋出和代理 VUE 專案》,如果想使用呢,直接pull下來就行了:

docker pull laozhangisphi/jenkins_with_dnt-cnpm_by_docker:latest

 

然後就可以刪掉之前的容器,再生成一個新的容器就行了,如果你之前的資料都掛載在宿主機上了,就不用擔心丟失的問題:

docker run -u root --rm -d -p 3000:8080 --name jenkins \-v /etc/localtime:/etc/localtime \-v /usr/bin/docker:/usr/bin/docker \-v /var/run/docker.sock:/var/run/docker.sock \-v /home/dockerVolumes2/jenkins_home:/var/jenkins_home \laozhangisphi/jenkins_with_dnt-cnpm_by_docker

 

當然,如果你不放心,可以先不刪掉之前的容器,可以run一個新的容器和埠,看看效果。這裡有個小問題就行,如果你之前pull過我的映象,再pull的話,會有兩個,用最新的就行。

 

然後在Jenkins中編輯構建:

 

 

(Jenkins構建命令)

 

因為我用的是先發布再構建的方式,所以這麼寫,你可以直接Dockerfile中編譯釋出構建一體,這個就是基礎知識了,你肯定看的懂。

 

構建完成,很簡單,2分鐘搞定。

 

 

(jenkins構建任務記錄)

 

目前專案已經完全更新完成,沒任何問題,當然,可能因為元件或者ORM的問題,出現些小問題,都是小事兒,和.NET5.0沒啥關係,完美。

 

全部時間:2個小時。

 

參考連結:
https://devblogs.microsoft.com/dotnet/

https://devblogs.microsoft.com/dotnet/announcing-net-5-0

 

 

 

 

基於Net/Core,快速搭建 API & SPA 及微服務應用組織

BASE NETCORE (VUE) PROJECT TEAM

 

每一個.NET開發者都可以通過自己的開源專案(最好可以配套簡單發表些文章)在這裡進行分享,BCVP開發者組織的意義就是激發和挖掘更多的作品,可能偏基礎,但是都會有價值。目的就是希望:每個人能將從社群學到的知識,進行自己消化和總結,濃縮成一個個獨立的專案,接著投入到社群,最後讓更多的初學者去了解、去學習、去思想碰撞,從而達到學習來源於社群,最後反哺於社群的良好迴圈目的,我們都是學生,也都是下一批初學者的老師,這才應該是一個社群正向推動的方法。

地址:https://github.com/BaseCoreVueProject

可以在Home倉庫裡,檢視具體的流程說明。

 

 

 

 

相關文章