dotnet aks api template

ASP.NET Core Web API para la plantilla AKS

Una dotnet new para crear una API web Core de 12 factores, ASP.NET, para AKS para AKS.

Instalación

 dotnet new -i RobBell.AksApi.Template

La plantilla se resuelve del repositorio oficial de NUGET.

Uso

Para crear un nuevo proyecto llamado MyAPI :

 dotnet new aksapi -n MyApi

Otras opciones incluyen:

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

Características de la plantilla

• Punto final de muestra
• Contenedores de acopolador
• Soporte de Openapi (arrogancia)
• Acciones automáticas de post creación - dotnet restore
• El punto final de la verificación de salud, incluidas las sondas de la vida y la preparación
• No hay referencias o usos de paquetes no utilizados
• Gráficos de timón
  • Implementación y creación de servicios
  • Referencias de imágenes
  • Etiqueta
• Configuración de AppInsights: gracias a Dirk Rheeder
• Reintroduce elunchsettings.json según https://github.com/dotnet/aspnetcore/tree/master/src/projecttemplates
• ReadMe en el proyecto creado, incluida la descripción general del archivo

En curso

• Pipeline de liberación de YAML (¿Azure DevOps o GitHub Actions?)
• Reglas de limpieza
• Pelusa
• Construir insignias, versión de paquete nuget

Para ser confirmado

• Proyecto de pruebas (incluye ejecutar en Dockerfile) - ¿Son valiosos? Obliga a esto a convertirse en una plantilla de creación de soluciones múltiples y posiblemente
• Otros rasgos de aplicaciones de 12 factores: mira lo que sería útil incluir
• Otros parámetros de creación (Port? EnlingAuthentication?
• ¿Hay alguna referencia que se pueda extraer en el momento de la creación? Gráficos de timón, por ejemplo,
• Licencia y archivos contribuyentes: ¿debería dotnet new Creation Map 1: 1 con un repositorio?

El proyecto de creación de plantillas

• Construcción e instalación local
• Pruebas
• Notas de instalación y uso
• Embalaje de plantilla en todas las plataformas (paquete .csproj)
• Versión del paquete de plantilla
• Eliminación de advertencias de paquetes

Desarrollo local

Después de hacer cambios en la plantilla, ejecute el script a continuación para empacar e instalar localmente:

 ./pack-and-install.sh

Una vez completado, puede crear nuevos proyectos a partir de la plantilla usando:

 dotnet new aksapi

Solución de problemas

Use el repositorio oficial de Nuget explícitamente

Intentar:

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

A veces puede tener repositorios privados de Nuget en las fuentes de su paquete que interfieren con la instalación de la plantilla del repositorio oficial. Por ejemplo:

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