Tutorial do .NET – seu primeiro microsserviço

Criar seu serviço

Em seu prompt de comando, execute o seguinte comando para criar seu aplicativo:

Em seu terminal, execute o seguinte comando para criar seu aplicativo:

Command prompt
dotnet new webapi -o MyMicroservice --no-https

Em seguida, navegue até o novo diretório criado pelo comando anterior:

Command prompt
cd MyMicroservice

O que esses comandos significam?

O comando dotnet cria um novo aplicativo do tipo webapi (que é um ponto de extremidade da API REST).

  • O parâmetro -o cria um diretório chamado MyMicroservice em que seu aplicativo é armazenado.
  • O sinalizador --no-https cria um aplicativo que será executado sem um certificado HTTPS, para manter as coisas simples para implantação.

O comando cd MyMicroservice o coloca no diretório de aplicativos recém-criado.

O código gerado

Vários arquivos foram criados no diretório MyMicroservice para fornecer um serviço simples que está pronto para ser executado, incluindo os seguintes arquivos:

  • O Program.cs é o arquivo de ponto de entrada e contém todas as configurações que são carregadas quando o aplicativo é iniciado e possui código para uma API simples que retorna a previsão do tempo para os próximos cinco dias. Ele também inicia o aplicativo.
  • MyMycroservice.http é usado para testar os projetos do ASP.NET Core.
  • MyMicroservice.csproj define a versão do .NET em que o aplicativo está direcionando, quais bibliotecas o projeto faz referência, etc.
  • O arquivo launchSettings.json dentro do diretório Properties define diferentes configurações de perfil para o ambiente de desenvolvimento local. Um número de porta variando entre 5000 e 5300 é atribuído automaticamente na criação do projeto e salvo neste arquivo.

O código a seguir mostra o conteúdo do arquivo Program.cs:

Program.cs
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

var summaries = new[]
{
    "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};

app.MapGet("/weatherforecast", () =>
{
    var forecast =  Enumerable.Range(1, 5).Select(index =>
        new WeatherForecast
        (
            DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
            Random.Shared.Next(-20, 55),
            summaries[Random.Shared.Next(summaries.Length)]
        ))
        .ToArray();
    return forecast;
})
.WithName("GetWeatherForecast")
.WithOpenApi();

app.Run();

record WeatherForecast(DateOnly Date, int TemperatureC, string? Summary)
{
    public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);
}

Selecione o botão Continuar abaixo para ir para a próxima etapa.

Encontrou um erro?

Não foi possível criar uma mensagem semelhante ao Template "ASP.NET Core Web API". Falha ao criar o modelo. Detalhes: O acesso ao caminho 'C:\Windows\System32\MyMicroservice' foi negado, altere seu diretório atual para um em que você tenha permissões para criar uma nova pasta e tente executar o comando novamente.

Se o Windows não encontrar o SDK ao tentar criar o projeto e você tiver certeza de que instalou o SDK, seu computador poderá ter um problema com a variável de ambiente PATH. Confira esta postagem do Stack Overflow para obter instruções sobre como diagnosticar e corrigir esse problema.

Se o problema não for resolvido, selecione o botão Ocorreu um problema abaixo para obter ajuda para corrigir o problema.

Continuar