(是時候拿出來這種圖了)
本文首發於公眾號,但是會有新的內容加進來,所以就在部落格園新開了一篇,望見諒。截止發稿,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
同時可以檢視下升級方案:
下載.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託管的。
二、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 base
WORKDIR /app
EXPOSE 80
如果你直接修改3.1為5.0,那用這個Dockerfile構建映象是找不到源映象的,新版的是這樣的:
FROM mcr.microsoft.com/dotnet/aspnet:5.0-buster-slim AS base
WORKDIR /app
EXPOSE 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倉庫裡,檢視具體的流程說明。