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).