dotnet aks api template

ASP.NET CORE WEB API สำหรับเทมเพลต AKS

เทมเพลต dotnet new สำหรับการสร้าง ASP.NET Core Web API สำหรับ AKS

การติดตั้ง

 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 Containerisation
• การสนับสนุน OpenAPI (Swagger)
• การดำเนินการสร้างโพสต์อัตโนมัติ - dotnet restore
• จุดสิ้นสุดการตรวจสุขภาพรวมถึงโพรบและความพร้อม
• ไม่มีการอ้างอิงแพ็คเกจหรือการใช้งานที่ไม่ได้ใช้
• แผนภูมิหางเสือ
  • การปรับใช้และการสร้างบริการ
  • ข้อมูลอ้างอิง
  • ฉลาก
• การกำหนดค่า AppInsights - ขอบคุณ Dirk Rheeder
• reintroduce launchsettings.json ตาม https://github.com/dotnet/aspnetcore/tree/master/src/projectTemplates
• readme ในโครงการที่สร้างขึ้นรวมถึงภาพรวมไฟล์

การดำเนินการ

• Yaml Release Pipeline (Azure Devops หรือการกระทำของ GitHub?)
• กฎการทำความสะอาด
• การเป็นผ้าสำลี
• สร้างป้ายรุ่น NuGet Package

ที่จะได้รับการยืนยัน

• โครงการทดสอบ (รวมถึงการทำงานใน DockerFile) - สิ่งเหล่านี้มีค่าหรือไม่? บังคับให้สิ่งนี้กลายเป็นหลายโครงการและอาจเป็นเทมเพลตการสร้างโซลูชัน
• ลักษณะแอพ 12 ปัจจัยอื่น ๆ - ดูสิ่งที่จะเป็นประโยชน์ในการรวม
• พารามิเตอร์การสร้างอื่น ๆ (พอร์ต?
• มีการอ้างอิงใด ๆ ที่สามารถดึงในเวลาสร้างได้หรือไม่? ตัวอย่างชาร์ตเฮล์ม
• ใบอนุญาตและไฟล์ที่มีส่วนร่วม - ควร 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 ส่วนตัวในแหล่งแพ็คเกจของคุณซึ่งรบกวนการติดตั้งเทมเพลตจาก repo อย่างเป็นทางการ ตัวอย่างเช่น:

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