Tutorial .NET - Layanan Mikro Pertama Anda

Buat layanan Anda

Di prompt perintah Anda, jalankan perintah berikut untuk membuat aplikasi Anda:

Di terminal Anda, jalankan perintah berikut untuk membuat aplikasi Anda:

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

Kemudian, navigasikan ke direktori baru yang dibuat oleh perintah sebelumnya:

Command prompt
cd MyMicroservice

Apa arti perintah ini?

Perintah dotnet membuat aplikasi baru jenis webapi (yaitu titik akhir REST API).

  • Parameter -o membuat direktori bernama MyMicroservice tempat aplikasi Anda disimpan.
  • Bendera --no-https membuat aplikasi yang akan berjalan tanpa sertifikat HTTPS, untuk mempermudah penerapan.

Perintah cd MyMicroservice akan menempatkan Anda pada direktori aplikasi yang baru dibuat.

Kode yang dihasilkan

Beberapa file dibuat di direktori MyMicroservice, untuk memberi Anda layanan sederhana yang siap dijalankan, termasuk file berikut ini:

  • Program.cs adalah file titik masuk dan berisi semua pengaturan dan konfigurasi yang dimuat saat aplikasi dimulai dan memiliki kode untuk API sederhana yang mengembalikan prakiraan cuaca untuk lima hari ke depan. Ini juga akan memulai aplikasi.
  • MyMycroservice.http digunakan untuk menguji proyek ASP.NET Core.
  • MyMicroservice.csproj menentukan versi .NET yang ditargetkan aplikasi, pustaka apa yang menjadi referensi proyek, dll.
  • File launchSettings.json di dalam direktori Properties menentukan pengaturan profil yang berbeda untuk lingkungan pengembangan lokal. Nomor port berkisar antara 5000-5300 secara otomatis ditetapkan pada pembuatan proyek dan disimpan pada file ini.

Kode berikut ini memperlihatkan konten file 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);
}

Pilih tombol Lanjutkan di bawah ini untuk menuju ke langkah berikutnya.

Ada kesalahan?

Jika Anda menerima pesan yang serupa dengan Templat "ASP.NET Core Web API" tidak dapat dibuat. Gagal membuat templat. Detail: Buka 'C:\Windows\System32\MyMicroservice' ditolak, ubah direktori Anda saat ini ke direktori tempat Anda memiliki izin untuk membuat folder baru dan coba jalankan perintah lagi.

Jika Windows tidak dapat menemukan SDK saat Anda mencoba membuat proyek dan Anda yakin telah menginstal SDK, mesin Anda mungkin memiliki masalah dengan variabel lingkungan PATH. Lihat postingan Stack Overflow ini untuk petunjuk tentang cara mendiagnosis dan memperbaiki masalah ini.

Jika Anda tidak dapat menyelesaikan masalah yang Anda alami, pilih tombol Saya mengalami masalah di bawah untuk mendapatkan bantuan dalam memperbaiki masalah tersebut.

Melanjutkan