dotnet aks api template

ASKテンプレートのASP.NETコアWeb API

AKSの完全な機能、12ファクター、ASP.NETコアWeb APIを作成するためのdotnet newテンプレート。

インストール

 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
• livensionと準備プローブを含むヘルスチェックエンドポイント
• 未使用のパッケージの参照や使用はありません
• ヘルムチャート
  • 展開とサービスの作成
  • 画像参照
  • ラベル
• AppInsights Configuration -Dirk Rheederに感謝します
• https://github.com/dotnet/aspnetcore/tree/master/src/projectttemplatesに従って、LaunchSettings.jsonを再導入します
• ファイルの概要を含む、作成されたプロジェクトのREADME

進行中

• YAMLリリースパイプライン（Azure DevOpsまたはGitHubアクション？）
• クリーンアップルール
• 糸くず
• バッジをビルド、nugetパッケージバージョン

確認されます

• テストプロジェクト（DockerFileでの実行を含む） - これらは価値がありますか？これを強制的にマルチプロジェクトにし、場合によってはソリューションを作成するテンプレートになります
• その他の12ファクターアプリの特徴 - 含めるのに役立つものを見てください
• その他の作成パラメーター（ポート？exanablingAuthentication？FrameWorkversion？）
• 作成時に引用できる参照はありますか？たとえば、ヘルムチャート
• ライセンスと寄付ファイルdotnet new作成マップ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).