dotnet aks api template

ASP.NET Core Web API لقالب AKs

قالب dotnet new لإنشاء API ASP.NET Core Web API لـ 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

ميزات القالب

• عينة نقطة النهاية
• حاوية الالتصاق
• دعم Openapi (Swagger)
• إجراءات إنشاء ما بعد ما بعد ذلك - dotnet restore
• نقطة نهاية الفحص الصحية ، بما في ذلك التحقيقات الرفيعة والاستعداد
• لا توجد مراجع أو استخدامات حزمة غير مستخدمة
• مخططات هيلم
  • النشر وإنشاء الخدمات
  • مراجع الصورة
  • تسميات
• تكوين AppInsights - بفضل Dirk Rheeder
• إعادة تقديم launchsettings.json حسب https://github.com/dotnet/aspnetcore/tree/master/src/projecttemplates
• ReadMe في مشروع تم إنشاؤه ، بما في ذلك نظرة عامة على الملفات

في تَقَدم

• خط أنابيب إطلاق Yaml (Azure DevOps أو إجراءات GitHub؟)
• قواعد التنظيف
• linting
• بناء شارات ، إصدار حزمة nuget

ليتم تأكيدها

• مشروع الاختبارات (يشمل التشغيل في Dockerfile) - هل هذه قيمة؟ يجبر هذا على أن يصبح قالبًا متعدد المحال
• آخر 12 سمات تطبيق عامل - انظر إلى ما قد يكون مفيدًا لتضمينه
• معلمات خلق أخرى (PORT؟ ENIBLINGAUTINGENTICATION؟
• هل هناك أي مراجع يمكن سحبها في وقت الخلق؟ مخططات هيلم على سبيل المثال
• الترخيص والملفات المساهمة - هل يجب على خريطة إنشاء dotnet new 1: 1 مع مستودع؟

مشروع إنشاء القالب

• البناء والتثبيت المحلي
• الاختبارات
• ملاحظات التثبيت والاستخدام
• عبوات القالب على جميع الأنظمة الأساسية (.csproj package)
• القالب حزمة الإصدار
• إزالة تحذيرات الحزمة

التنمية المحلية

بعد إجراء تغييرات على القالب ، قم بتشغيل البرنامج النصي أدناه لتعبئة وتثبيت محليًا:

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