dotnet aks api template

ASP.NET Core Web API pour le modèle AKS

Un dotnet new pour créer une API Web ASP.NET Core entièrement entièrement entièrement tractée pour AKS.

Installation

 dotnet new -i RobBell.AksApi.Template

Le modèle se résout du référentiel officiel de NuGet.

Usage

Pour créer un nouveau projet nommé MyAPI :

 dotnet new aksapi -n MyApi

Les autres options incluent:

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

Fonctionnalités de modèle

• Exemple de point d'évaluation
• Contenerisation Docker
• Support OpenAPI (Swagger)
• Actions de création de postes automatiques - dotnet restore
• Point de terminaison de contrôle de santé, y compris les sondes Lively and Readiness
• Pas de références ou d'utilisations inutilisées
• Graphiques de barre
  • Déploiement et création de services
  • Références d'image
  • Étiquettes
• Configuration des appinsights - grâce à Dirk Rheeder
• Réintroduire les lancets.json selon https://github.com/dotnet/aspnetcore/tree/master/src/projectTemplates
• ReadMe dans le projet créé, y compris la vue d'ensemble des fichiers

En cours

• Pipeline de libération YAML (Azure DevOps ou GitHub Actions?)
• Règles de nettoyage
• Libellé
• Construire des badges, version du package NuGet

À confirmer

• Projet de tests (inclut l'exécution dans Dockerfile) - sont-ils précieux? Oblige cela à devenir un multi-projets, et peut-être le modèle de création de solutions
• 12 autres traits d'application de facteur - Regardez ce qui serait utile pour inclure
• Autres paramètres de création (port? Activation de l'authentification? FrameworkVersion?)
• Y a-t-il des références qui peuvent être tirées au moment de la création? Graphiques de tête par exemple
• Licence et fichiers contributifs - dotnet new Creation Map 1: 1 avec un référentiel?

Le projet de création de modèle

• Construction et installation locales
• Tests
• Notes d'installation et d'utilisation
• Emballage de modèle sur toutes les plates-formes (package .csproj)
• Template Package Versioning
• Suppression des avertissements d'emballage

Développement local

Après avoir apporté des modifications au modèle, exécutez le script ci-dessous pour emballer et installer localement:

 ./pack-and-install.sh

Une fois terminé, vous pouvez créer de nouveaux projets à partir du modèle en utilisant:

 dotnet new aksapi

Dépannage

Utilisez explicitement le référentiel officiel de Nuget

Essayer:

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

Parfois, vous pourriez avoir des référentiels privés NuGet dans vos sources de package qui interfèrent avec l'installation du modèle du référentiel officiel. Par exemple:

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