dotnet aks api template

API da Web Core ASP.NET para AKS

Um dotnet new para criar uma API Web de 12 fator, de 12 fatores de 12 fatores, para AKs.

Instalação

 dotnet new -i RobBell.AksApi.Template

O modelo resolve do repositório oficial do NUGET.

Uso

Para criar um novo projeto chamado Myapi :

 dotnet new aksapi -n MyApi

Outras opções incluem:

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

Recursos de modelo

• Exemplo de terminal
• Docker Recainerização
• Suporte OpenApi (Swagger)
• Ações automáticas de criação pós - dotnet restore
• Endpoint de verificação de saúde, incluindo sondas de lactive e prontidão
• Nenhuma referência de pacote não utilizada
• Gráficos de comando
  • Implantação e criação de serviços
  • Referências de imagem
  • Rótulos
• Configuração do AppInsights - graças a Dirk Rheeder
• Reintroduce o iniciador
• Readme no projeto criado, incluindo visão geral de arquivos

Em andamento

• Pipeline de liberação da YAML (Ações do Azure DevOps ou Github?)
• Regras de limpeza
• LING
• Construa crachás, versão do pacote NUGET

A ser confirmado

• Projeto de testes (inclui a corrida no Dockerfile) - são valiosos? Força isso a se tornar um modelo de vários projetos e, possivelmente, criação de soluções
• Outros traços de aplicativos de 12 fatores - veja o que seria útil para incluir
• Outros parâmetros de criação (Port? HabilingAthentication? FrameworkVersion?)
• Existem referências que podem ser puxadas no momento da criação? Gráficos de comando, por exemplo,
• Licença e arquivos contribuintes - deve dotnet new mapa de criação 1: 1 com um repositório?

O projeto de criação de modelos

• Construção local e instalação
• Testes
• Notas de instalação e uso
• Embalagem de modelos em todas as plataformas (pacote .csproj)
• Versão do pacote de modelos
• Remoção de avisos de pacotes

Desenvolvimento local

Depois de fazer alterações no modelo, execute o script abaixo para embalar e instalar localmente:

 ./pack-and-install.sh

Uma vez concluído, você pode criar novos projetos a partir do modelo usando:

 dotnet new aksapi

Solução de problemas

Use o repositório oficial do Nuget explicitamente

Tentar:

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

Às vezes, você pode ter repositórios privados de Nuget em suas fontes de embalagem que interferem na instalação do modelo a partir do repositório oficial. Por exemplo:

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