Mulai menggunakan kontainer WSL

Panduan langkah demi langkah ini akan membantu Anda mulai membangun dan menjalankan kontainer Linux di Windows menggunakan wslc.exe, CLI kontainer yang dibangun dengan WSL.

wslc.exe menyediakan CLI yang familier untuk membangun, mengirim, dan menjalankan aplikasi kontainer.

Gambaran umum kontainer WSL

Kontainer adalah alat yang digunakan untuk membuat, menyebarkan, dan menjalankan aplikasi. Kontainer memungkinkan pengembang untuk mengemas aplikasi dengan semua bagian yang dibutuhkan (pustaka, kerangka kerja, dependensi, dll) dan mengirimkan semuanya sebagai satu paket. Menggunakan kontainer memastikan bahwa aplikasi akan berjalan sama terlepas dari pengaturan yang disesuaikan atau pustaka yang diinstal sebelumnya pada komputer yang menjalankannya yang dapat berbeda dari komputer yang digunakan untuk menulis dan menguji kode aplikasi. Ini memungkinkan pengembang untuk fokus pada penulisan kode tanpa khawatir tentang sistem yang kodenya akan dijalankan.

Prasyarat

WSL terpasang. Jalankan wsl --update untuk memastikan Anda memiliki versi terbaru.
Instal Visual Studio Code(opsional). Ini akan memberikan pengalaman terbaik, termasuk kemampuan untuk membuat kode dan men-debug proyek kontainer Anda yang terhubung ke distribusi Linux Anda.
Instal Terminal Windows(opsional). Ini akan memberikan pengalaman terbaik, termasuk kemampuan untuk menyesuaikan dan membuka beberapa terminal dalam antarmuka yang sama (termasuk Ubuntu, Debian, PowerShell, Azure CLI, atau apa pun yang lebih Anda gunakan).

Menginstal dan memverifikasi wslc

wslc.exe sudah termasuk dalam WSL, jadi Anda tidak perlu menginstal mesin secara terpisah. Untuk memastikan Anda memiliki versi WSL yang menyertakannya:

Instal WSL jika Anda belum melakukannya, lalu perbarui ke versi terbaru dengan membuka PowerShell dan memasukkan:
```
wsl --update
```
Konfirmasikan bahwa wslc.exe tersedia dan periksa versinya dengan memasukkan:
```
wslc version
```
Uji bahwa semuanya berfungsi dengan benar dengan menjalankan gambar bawaan sederhana. Gambar secara otomatis ditarik jika belum ada secara lokal:
```
wslc run --rm hello-world
```
Anda akan melihat pesan "Halo" yang mengonfirmasi bahwa penginstalan Anda tampaknya berfungsi dengan benar.

Petunjuk / Saran

Berikut adalah beberapa perintah bermanfaat wslc untuk diketahui:

Cantumkan perintah yang tersedia di wslc CLI dengan memasukkan: wslc --help
Cantumkan informasi untuk perintah tertentu dengan: wslc <COMMAND> --help
Cantumkan gambar di komputer Anda, dengan: wslc image list
Cantumkan kontainer yang sedang berjalan di komputer Anda, dengan: wslc container list atau cantumkan semua kontainer (termasuk yang dihentikan) dengan: wslc container list --all
Tampilkan statistik penggunaan sumber daya untuk kontainer anda yang sedang berjalan, dengan: wslc stats

Jalankan kontainer pertama Anda

Dengan wslc.exe Anda dapat menarik gambar, menjalankan kontainer di latar depan atau latar belakang, menerbitkan port, dan berinteraksi dengan kontainer yang sedang berjalan. Coba beberapa perintah ini dari PowerShell:

# Run a command in a throwaway container
wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!"

# Run a web server in the background and publish port 8080 to the container's port 80
wslc run -d --rm -p 8080:80 --name web nginx

# Request content from the running web server
curl localhost:8080

# List the running container
wslc container list

# Run an additional command inside the running container
wslc exec web cat /etc/os-release

# Stop the container
wslc container stop web

nginx Karena kontainer dimulai dengan --rm, kontainer dihapus secara otomatis setelah berhenti.

Buat dan jalankan image kontainer Anda sendiri

Untuk mulai mengembangkan aplikasi dengan wslc.exe, sebaiknya gunakan Visual Studio Code, bersama dengan ekstensi WSL sehingga Anda dapat mengedit proyek Anda pada sistem file Linux dan menjalankan wslc perintah dari terminal terintegrasi.

Mari kita buat gambar kontainer untuk proyek aplikasi yang ada.

Untuk contoh ini, kita akan menggunakan kode sumber dari tutorial Halo Dunia untuk Django di lingkungan pengembangan Python menyiapkan dokumen. Anda dapat melewati langkah ini jika Anda lebih suka menggunakan kode sumber proyek Anda sendiri. Untuk mengunduh aplikasi web HelloWorld-Django dari GitHub, buka terminal WSL (misalnya Ubuntu) dan masukkan:
```
git clone https://github.com/<username>/helloworld-django.git
```
Nota

Selalu simpan kode Anda dalam sistem file yang sama dengan tempat Anda menggunakan alat. Ini akan menghasilkan performa akses file yang lebih cepat. Dalam contoh ini, kami menggunakan distro Linux (Ubuntu) dan ingin menyimpan file proyek kami pada sistem \\wsl$file WSL . Menyimpan file proyek pada sistem file Windows akan secara signifikan memperlambat hal-hal saat menggunakan alat Linux di WSL untuk mengakses file-file tersebut.
Dari terminal WSL Anda, ubah direktori ke folder kode sumber untuk proyek ini:
```
cd helloworld-django
```
Buka proyek di Visual Studio Code yang berjalan di server ekstensi WSL lokal dengan memasukkan:
```
code .
```
Konfirmasikan bahwa Anda terhubung ke distro WSL Linux Anda dengan memeriksa indikator jarak jauh hijau di sudut kiri bawah instans Visual Studio Code Anda.

Tambahkan sebuah Containerfile di direktori root proyek Anda yang menjelaskan cara membangun image. Untuk contoh Django, minimal Containerfile mungkin terlihat seperti ini:

FROM python:3
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

Dari folder proyek (direktori yang berisi Anda Containerfile), buat gambar dengan wslc build, beri tag dengan nama yang dapat Anda referensikan nanti:
```
wslc build -t helloworld-django .
```
Konfirmasikan bahwa gambar dibuat dengan mencantumkan gambar Anda:
```
wslc image list
```
Jalankan gambar yang baru dibuat sebagai kontainer, publikasikan port aplikasi sehingga Anda dapat menjangkaunya dari Windows:
```
wslc run -d --rm -p 8000:8000 --name django helloworld-django
```
Untuk mengonfirmasi bahwa kontainer Anda berjalan, cantumkan kontainer yang sedang berjalan dan periksa lognya:
```
wslc container list
wslc container logs django
```
Buka browser di Windows dan kunjungi http://localhost:8000/ untuk melihat aplikasi Anda berjalan di dalam kontainernya. Anda juga dapat mengonfirmasi bahwa aplikasi berjalan di Linux dengan menjalankan perintah di dalam kontainer:
```
wslc exec django uname
```
Hasil uname "Linux" mengonfirmasi bahwa kontainer berjalan pada kernel Linux WSL 2.
Setelah selesai, hentikan kontainer:
```
wslc container stop django
```

Anda sekarang telah berhasil membangun dan menjalankan kontainer Linux di Windows menggunakan wslc.exe, didukung oleh WSL 2, yang dapat Anda bangun, jalankan, sebarkan, atau debug bersama Visual Studio Code!

Penyelesaian Masalah

Memeriksa kontainer atau gambar

Ketika kontainer berperilaku tidak terduga, inspect perintah dan logs memberikan informasi terperinci untuk membantu Anda mendiagnosis masalah:

wslc container inspect <container-id>
wslc container logs <container-id>
wslc image inspect <image>

Mengklaim kembali ruang disk

Gambar dan kontainer yang dihentikan memakan ruang disk. Untuk membersihkan sumber daya yang tidak lagi Anda gunakan:

# Remove all stopped containers
wslc container prune

# Remove unused images
wslc image prune

Untuk bantuan selengkapnya tentang masalah pemecahan masalah umum di WSL, lihat dokumen Pemecahan Masalah .

Sumber daya tambahan

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-06-29