dotnet aks api template

ASP.NET Core Web API untuk Template AKS

Template dotnet new untuk membuat API Web Core ASP.NET Core untuk AKS.

Instalasi

 dotnet new -i RobBell.AksApi.Template

Template diselesaikan dari repositori Nuget resmi.

Penggunaan

Untuk membuat proyek baru bernama Myapi :

 dotnet new aksapi -n MyApi

Opsi lain termasuk:

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

Fitur Template

• Contoh titik akhir
• Containerisasi Docker
• Dukungan OpenAPI (Swagger)
• Tindakan pembuatan pos otomatis - dotnet restore
• Titik Akhir Periksa Kesehatan, termasuk probe Liveness dan Kesiapan
• Tidak ada referensi atau penggunaan paket yang tidak digunakan
• Grafik Helm
  • Penyebaran dan pembuatan layanan
  • Referensi gambar
  • Label
• Konfigurasi AppInsights - Terima kasih kepada Dirk Rheeder
• Reintroduce launchsettings.json sesuai https://github.com/dotnet/aspnetcore/tree/master/src/projecttemplates
• ReadMe dalam proyek yang dibuat, termasuk ikhtisar file

Sedang berlangsung

• YAML Release Pipeline (Azure DevOps atau Tindakan GitHub?)
• Aturan pembersihan
• Berbaris
• Bangun Lencana, Versi Paket Nuget

Untuk dikonfirmasi

• Proyek Tes (termasuk berjalan di DockerFile) - apakah ini berharga? Memaksa ini untuk menjadi multi-proyek, dan mungkin template penciptaan solusi
• Ciri Aplikasi 12 Faktor Lainnya - Lihatlah apa yang akan berguna untuk dimasukkan
• Parameter pembuatan lainnya (port? EnablingAuthentication? FrameworkVersion?)
• Apakah ada referensi yang dapat ditarik pada waktu penciptaan? Grafik helm misalnya
• Lisensi dan Kontribusi File - Haruskah dotnet new 1: 1 dengan repositori?

Proyek Pembuatan Template

• Bangun dan Instal Lokal
• Tes
• Catatan Instalasi dan Penggunaan
• Kemasan Template di Semua Platform (Paket .CSPROJ)
• Versi Paket Template
• Penghapusan peringatan paket

Pengembangan Lokal

Setelah membuat perubahan pada templat, jalankan skrip di bawah ini untuk mengemas dan menginstal secara lokal:

 ./pack-and-install.sh

Setelah selesai, Anda dapat membuat proyek baru dari templat menggunakan:

 dotnet new aksapi

Pemecahan masalah

Gunakan repositori nuget resmi secara eksplisit

Mencoba:

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

Terkadang Anda mungkin memiliki repositori nuget pribadi di sumber paket Anda yang mengganggu pemasangan templat dari repo resmi. Misalnya:

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