dotnet aks api template

ASP.NET CORE WEB API для шаблона AKS

dotnet new для создания полнофункционального 12-факторного, основного веб-API ASP.NET для 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
• Поддержка OpenAPI (Swagger)
• Автоматические действия по посту - dotnet restore
• Конечная точка проверки здоровья, включая датчики и готовность к готовности
• Нет неиспользованных ссылок на пакет или употребления
• Хелм диаграммы
  • Развертывание и создание услуг
  • Ссылки на изображение
  • Ярлыки
• Конфигурация Appinsights - благодаря Дирку Ридеру
• Reintroduce запуск setsettings.json в соответствии с https://github.com/dotnet/aspnetcore/tree/master/src/projecttemplates
• Readme в созданном проекте, включая обзор файлов

В ходе выполнения

• YAML Lexation Pipeline (Azure DevOps или GitHub Actions?)
• Правила очистки
• Лининг
• Построить значки, версия пакета Nuget

Быть подтвержденным

• Проект тестов (включает в себя работу в Dockerfile) - это ценны? Заставляет это стать многопроектом и, возможно, для создания решений шаблон
• Другие 12 -факторные признаки приложения - посмотрите, что было бы полезно для включения
• Другие параметры создания (порт?
• Есть ли какие -либо ссылки, которые можно привлечь во время создания? Хульжковые диаграммы, например
• Лицензия и внесение файлов - должен ли dotnet new Creation Map 1: 1 с репозиторием?

Проект создания шаблона

• Локальная сборка и установка
• Тесты
• Установки и заметки об использовании
• Упаковка шаблона на всех платформах (.
• Шаблон пакета
• Удаление предупреждений упаковки

Местное развитие

После внесения изменений в шаблон запустите сценарий ниже, чтобы упаковать и установить локально:

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