dotnet aks api template

ASP.NET核心Web API AKS模板

dotnet new模板，用於創建一個為AKS創建完整的，12個因子，ASP.NET Core Web API。

安裝

 dotnet new -i RobBell.AksApi.Template

模板從官方的Nuget存儲庫中解析。

用法

創建一個名為Myapi的新項目：

 dotnet new aksapi -n MyApi

其他選項包括：

 --controller-name       The name of the default controller
                        Default: SampleController

--disable-open-api      Disable OpenAPI (Swagger) support
                        Default: false

--disable-health-check  Disable liveness and readiness support
                        Default: false

--disable-logging       Disable Logging and AppInsights support
                        Default: false

--instrumentation-key   The AppInsights application key if logging is enabled
                        Default: 11111111-1111-1111-11111111111111111

--skip-restore          Skips the restore of the project on create
                        Default: false

模板功能

• 示例端點
• Docker容器化
• OpenAPI支持（Swagger）
• 自動郵政創建操作dotnet restore
• 健康檢查終點，包括運動和準備探針
• 沒有未使用的軟件包參考或用途
• 舵圖
  • 部署和服務創建
  • 圖像參考
  • 標籤
• Appinsights配置 - 感謝Dirk Rheeder
• 根據https://github.com/dotnet/aspnetcore/tree/tree/master/master/src/projectTemplates，重新引入啟動settings.json
• 在創建的項目中重新讀書，包括文件概述

進行中

• YAML釋放管道（Azure DevOps或GitHub動作？）
• 清理規則
• 覆蓋
• 構建徽章，Nuget軟件包版本

要確認

• 測試項目（包括在Dockerfile中運行） - 這些是否有價值？強迫這成為多項目，可能是解決方案的模板
• 其他12個因素應用特徵 - 查看包括
• 其他創建參數（端口？enaperauthentication？frameworkversion？）
• 是否可以在創建時間提取任何參考文獻？例如，掌舵圖表
• 許可證和貢獻文件 - dotnet new Creation Map 1：1是否有存儲庫1：1？

模板創建項目

• 本地構建和安裝
• 測試
• 安裝和用法註釋
• 所有平台上的模板包裝（.CSPROJ軟件包）
• 模板軟件包版本操作
• 刪除包裝警告

地方發展

更改模板後，運行下面的腳本以打包並在本地安裝：

 ./pack-and-install.sh

完成後，您可以使用以下方式從模板中創建新項目

 dotnet new aksapi

故障排除

明確使用官方Nuget存儲庫

嘗試：

 dotnet new -i RobBell.AksApi.Template --nuget-source https://api.nuget.org/v3/index.json

有時，您的包裝源可能會有私人Nuget存儲庫，這些存儲庫會干擾官方存儲庫中安裝模板。例如：

 C:Program Filesdotnetsdk3.1.403NuGet.targets(128,5):
error : Unable to load the service index for source https://myprivatenugetrepo.com/nuget/v3/index.json.

C:Program Filesdotnetsdk3.1.403NuGet.targets(128,5):
error :   Response status code does not indicate success: 401 (Unauthorized).