編寫第一個 .NET 微服務
阿新 • • 發佈：2020-09-07
## 介紹
本文的目的是：通過建立一個返回列表的簡單服務，並在 Docker 容器中執行該服務，讓您熟悉使用 .NET 建立微服務的構建過程。
## 安裝 .NET SDK
要開始構建 .NET 應用程式，首先下載並安裝 .NET Core SDK（軟體開發工具包）。
根據作業系統的型別下載並安裝對應版本的 .NET Core SDK v3.1：[.NET SDK (64-位)](https://download.visualstudio.microsoft.com/download/pr/547f9f81-599a-4b58-9322-d1d158385df6/ebe3e02fd54c29487ac32409cb20d352/dotnet-sdk-3.1.401-win-x64.exe) 或 [.NET SDK (32-位)](https://download.visualstudio.microsoft.com/download/pr/719cf74a-8a57-405d-a048-be8d94bbef37/1914f811ddbf10f7a2a45181b9cac714/dotnet-sdk-3.1.401-win-x86.exe)
> 全部 .NET SDK 下載頁面（Download .NET SDKs for Visual Studio）：
> [https://dotnet.microsoft.com/download/visual-studio-sdks](https://dotnet.microsoft.com/download/visual-studio-sdks)
### 檢查安裝是否正確
.NET SDK 安裝完成後，開啟一個命令提示符視窗並執行以下命令:
```bash
dotnet
```
如果命令執行時，打印出的資訊是介紹如何使用 `dotnet`，說明安裝正確。
## 建立您的服務
### 建立一個應用
在命令提示符視窗執行以下命令：
```bash
dotnet new webapi -o myMicroservice --no-https
cd myMicroservice
```
第一行中 `dotnet` 命令建立了一個 `webapi`（一個 REST API 終端）型別的“新”應用。
- 引數 `-o` 建立一個名為 `myMicroservice` 的目錄，用於儲存應用程式。
- 標記 `--no-https` 建立一個不需要 HTTPS 證書就可以執行的應用程式，以便簡化部署。
使用 `cd myMicroservice` 命令進入新建應用程式的目錄。
### 生成的程式碼
可以看到，在 `myMicroservice` 目錄中建立了幾個檔案，為您提供了一個可以執行的簡單服務。
- `myMicroservice.csproj` 定義了專案引用的庫等。
- `Startup.cs` 包含應用程式啟動時載入的所有設定和配置。
- `Controllers/WeatherForecastController.cs` 有一個簡單 API 的程式碼，可以返回未來 5 天的天氣預報（*模擬資料*）。
`Controllers/WeatherForecastController.cs` 檔案中程式碼：
```csharp
[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
private static readonly string[] Summaries = new[]
{
"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};
private readonly ILogger