Cara Membuat Gambar Docker dari .NET Web API

Salah satu keuntungan utama Docker adalah memungkinkan Anda menjalankan proyek perangkat lunak tanpa perlu menyiapkan lingkungan pengembangan yang kompleks.

Panduan ini akan menunjukkan cara membuat image Docker dari .NET 5 Web API. Anda kemudian dapat menggunakan gambar untuk menjalankan kode backend dari PC mana pun yang telah menginstal Docker dan berinteraksi dengan API dari proyek web front-end atau aplikasi seluler Anda.

Membuat .NET 5 Web API

Baik Docker dan .NET 5 adalah open-source dan cross-platform, oleh karena itu Anda dapat mengikuti panduan ini baik Anda menggunakan macOS, Windows, atau Linux.

Gunakan dotnet CLI untuk membuat proyek ASP.NET Web API dengan perintah berikut:

 dotnet webapi baru -o aspdockerapi 

Perintah di atas membuat proyek bernama aspdockerapi dan letakkan di folder dengan nama yang sama. Selain itu, aplikasi membuat perancah pengontrol API dengan beberapa contoh data prakiraan cuaca.

Catatan: Jika Anda belum menginstal .NET 5 di PC Anda, Anda dapat mengunduhnya dari tautan di bawah ini.

Unduh: .NET 5 Untuk Windows, macOS, dan Linux

Setelah proyek dibuat, Anda dapat masuk ke folder root proyek menggunakan perintah berikut.

cd aspdockerapi

Anda dapat menjalankan dan melayani web API menggunakan perintah di bawah ini.

 lari dotnet 

Secara default, aplikasi akan dilayani pada port 5001. Anda dapat melihat data sampel aplikasi di browser Anda pada URL berikut: https://localhost: 5001/prakiraan cuaca dan data API akan terlihat seperti di bawah ini.

Belajarlah lagi: Apa itu API?

Membuat Instruksi Gambar Docker

Untuk membuat image Docker, Anda perlu memberi Docker Engine beberapa instruksi tentang cara membuatnya. Instruksi ini harus ditempatkan dalam file bernama file docker. Perhatikan bahwa file tidak memiliki ekstensi.

Gunakan perintah berikut untuk membuat file docker di folder root proyek aplikasi Anda.

sentuh Dockerfile

Setelah membuat file docker, struktur folder proyek Anda harus serupa dengan yang di bawah ini:

Sekarang, salin dan tempel kode di bawah ini ke dalam file docker.

DARI mcr.microsoft.com/dotnet/aspnet: basis AS fokus 5.0
WORKDIR /aplikasi
paparan 80
DARI mcr.microsoft.com/dotnet/sdk: 5.0-focal AS build
WORKDIR /src
SALIN ["aspdockerapi.csproj", "./"]
JALANKAN dotnet restore "./aspdockerapi.csproj"
SALINAN. .
WORKDIR "/src/."
JALANKAN dotnet build "aspdockerapi.csproj" -c Rilis -o /app/build
DARI build SEBAGAI publikasikan
RUN dotnet publish "aspdockerapi.csproj" -c Rilis -o /app/publish
DARI dasar AS final
WORKDIR /aplikasi
SALIN --from=publish /app/publish .
ENTRYPOINT ["dotnet", "aspdockerapi.dll"]

Catatan: Di Dockerfile di atas, nama proyek dan dll adalah aspdockerapi.csproj dan aspdockerapi.dll masing-masing, jika proyek Anda memiliki nama yang berbeda, pastikan untuk memperbarui Dockerfile Anda dengan nama yang benar.

Memahami Instruksi Dockerfile

Itu file docker terutama terdiri dari kata kunci Dockerfile, yang menurut konvensi adalah kata-kata huruf kapital. Kata kunci menentukan instruksi untuk dieksekusi di setiap lapisan gambar Docker. Di bawah ini adalah kata kunci Docker utama yang digunakan Dockerfile di atas.

1. DARI

Itu DARI kata kunci menentukan gambar dasar di mana kita ingin gambar kita dibangun. Dalam Dockerfile di atas, gambar dasar awal adalah gambar .NET 5 dari Microsoft. Gambar dasar .NET 5 berisi komponen yang diperlukan untuk menjalankan aplikasi.

2. DIRI KERJA

DIRI KERJA mengatur direktori kerja atau konteks di dalam gambar. Dalam contoh ini, /app direktori ditetapkan sebagai direktori kerja root default menggunakan pernyataan berikut: WORKDIR /aplikasi.

3. SALINAN

Itu SALINAN kata kunci hanya menyalin konten dari satu folder dan menempatkannya ke folder lain. Dalam contoh ini, awalnya digunakan untuk menyalin file proyek utama, yaitu, aspdockerapi.csproj ke dalam direktori kerja gambar.

4. LARI

Itu LARI kata kunci digunakan untuk menjalankan perintah Linux tertentu dalam gambar Docker. Dalam file docker di atas LARI perintah digunakan untuk memulihkan dependensi, membangun proyek ASP.NET dan menerbitkan proyek.

5. CMD

Itu CMD kata kuncinya sedikit mirip dengan LARI kata kunci yang dibahas di atas. Ini juga digunakan dalam menjalankan perintah Linux, tetapi tidak seperti LARI kata kunci yang menjalankan perintah untuk membangun gambar, the CMD kata kunci digunakan untuk menjalankan perintah Linux ketika gambar dimulai, dalam contoh wadah.

6.EXPOSE

Itu MEMBUKA kata kunci digunakan untuk mengekspos port di dalam gambar Docker ke dunia luar. Dalam hal ini, image mengekspos port 80, yang digunakan untuk mengekspos API saat menjalankan container Docker.

Membangun Gambar Docker

Untuk membangun gambar Docker berdasarkan berkas Docker, cukup jalankan perintah berikut di dalam folder root proyek, yaitu, di mana file docker ditempatkan.

docker build -t dockerwebapi -f Dockerfile .

Perintah di atas menandai gambar Docker dengan nama dockerwebapi dan juga menentukan bahwa instruksi untuk membuat gambar ini ada di file docker.

Setelah gambar selesai dibuat, Anda dapat memeriksa apakah gambar tersebut terdaftar sebagai gambar Docker lokal menggunakan perintah berikut:

gambar buruh pelabuhan

Output dari perintah di atas harus mirip dengan yang di bawah ini, dan gambar (dockerwebapi) muncul di baris pertama dalam kasus ini.

Jika Anda belum menginstal Docker di PC Anda, inilah cara menginstal buruh pelabuhan di Ubuntu Linux, jika tidak, gunakan tautan di bawah ini untuk mengunduh dan menginstal Docker.

Unduh: Panduan pengunduhan dan penginstalan Docker

Menjalankan Gambar Docker

Untuk menjalankan image Docker yang baru dibuat, gunakan perintah berikut. Itu -ti opsi menentukan bahwa gambar harus dijalankan dalam mode terminal interaktif, dan --rm menentukan bahwa wadah harus segera dipindahkan setelah keluar.

docker run -ti --rm -p 8080:80 dockerwebapi

Juga, perintah menentukan bahwa wadah Docker harus dijalankan pada port HTTP 8080, yang memetakan ke port 80 di dalam wadah.

Pergi ke URL: http://localhost: 8080/Prakiraan Cuaca di browser Anda dan Anda akan menemukan data API Anda dilayani dari instance Docker yang Anda jalankan.

Mengapa Menggunakan Docker?

Panduan ini menunjukkan cara membuat image Docker dari .NET 5 web API.

Dengan Docker, Anda dapat mengotomatiskan cara Anda menerapkan aplikasi, menyederhanakan pengaturan lingkungan pengembangan perangkat lunak, dan memudahkan kolaborasi dengan sesama insinyur perangkat lunak.

Docker juga menawarkan beberapa keunggulan dibandingkan teknologi virtualisasi lainnya, itulah sebabnya Anda mungkin harus mempertimbangkan untuk menggunakannya dalam proyek rekayasa perangkat lunak Anda.

6 Alasan Menggunakan Perangkat Lunak Virtualisasi Docker

Docker memberikan banyak keuntungan dibandingkan mesin virtual berikut alasan untuk mulai menggunakannya hari ini.

Baca Selanjutnya

Tentang Penulis

Perluas untuk Membaca Cerita Lengkap