Menyiapkan Kontainer Dev di Windows

Dev Container memungkinkan Anda menggunakan kontainer Docker sebagai lingkungan pengembangan lengkap, yang didefinisikan oleh file yang devcontainer.json dimasukkan ke dalam repositori Anda. Setiap orang yang membuka proyek mendapatkan alat, ekstensi, dan pengaturan yang sama — terlepas dari apa yang diinstal pada komputer lokal mereka.

Halaman ini mencakup penyiapan khusus Windows. Untuk pengenalan lengkap tentang apa itu Kontainer Dev dan cara kerjanya, lihat Dokumentasi Dev Containers di situs web VISUAL Code.

Prasyarat

Kontainer Dev di Windows memerlukan:

  • WSL 2 — Subsistem Windows untuk Linux, versi 2. Instal WSL jika Anda belum melakukannya.
  • Docker Desktop untuk Windows dengan backend WSL 2 diaktifkan. Unduh Docker Desktop dan ikuti penginstal. Selama penyiapan, pastikan Gunakan mesin berbasis WSL 2 dipilih di pengaturan Docker Desktop (Pengaturan>Umum).
  • Visual Studio Code — Unduh Vs Code.
  • Ekstensi Dev Containers — Instal ekstensi Dev Containers dari Vs Code Marketplace.

Tempat Anda menyimpan file penting

Penting

Pada Windows, performa Dev Container sangat bergantung pada tempat file proyek Anda berada. Simpan proyek Anda di sistem file WSL 2 (misalnya, /home/yourname/projects/), bukan di sistem file Windows (misalnya, C:\Users\yourname\projects\).

Ketika file Anda berada di sistem file Windows (C:\), Docker mengaksesnya melalui berbagi file lintas OS, yang secara signifikan lebih lambat. Ketika file Anda berada dalam sistem file WSL 2, Docker menggunakan I/O Linux asli dan performa secara substansial lebih baik - terutama untuk build dan alat pengamatan file.

Untuk mengkloning ke dalam sistem file WSL 2, buka distribusi WSL Anda (misalnya, Ubuntu) dari menu Mulai atau Terminal Windows, dan kloning di sana:

cd ~
mkdir projects && cd projects
git clone https://github.com/your-org/your-repo.git

Kemudian buka folder tersebut di VS Code dari WSL.

code your-repo

VS Code terhubung ke WSL dan mendeteksi devcontainer.json jika ada.

Membuka proyek di Kontainer Dev

Setelah proyek Anda terbuka di Visual Studio Code (terhubung ke WSL):

  1. Tekan F1 dan pilih Dev Containers: Buka Kembali di dalam Kontainer.
  2. Visual Studio Code membangun gambar kontainer yang ditentukan dalam .devcontainer/devcontainer.json (atau meminta Anda untuk menambahkannya jika tidak ada).
  3. Setelah build selesai, Visual Studio Code terhubung kembali di dalam kontainer dengan semua alat dan ekstensi yang dikonfigurasi tersedia.

Untuk kembali ke lingkungan lokal Anda, tekan F1 dan pilih Kontainer Dev: Buka Kembali Folder Secara Lokal.

Menambahkan Kontainer Dev ke proyek yang sudah ada

Jika proyek Anda belum memiliki devcontainer.json :

  1. Tekan F1 dan pilih Kontainer Dev: Tambahkan File Konfigurasi Kontainer Dev.
  2. Pilih gambar dasar (misalnya, Node.js, Python, atau gambar Debian/Ubuntu generik).
  3. Visual Studio Code membuat file .devcontainer/devcontainer.json yang dapat Anda masukkan ke dalam pengendalian versi.

Untuk referensi opsi devcontainer.json lengkap, lihat referensi devcontainer.json di situs Spesifikasi Kontainer Dev.

Troubleshooting

Container dimulai tetapi perubahan file tidak terdeteksi Proyek Anda kemungkinan disimpan pada sistem file Windows. Pindahkan ke WSL (lihat Tempat Anda menyimpan file Anda penting di atas).

Docker Desktop tidak dimulai atau integrasi WSL hilang Buka Docker Desktop, buka Pengaturan>Sumber Daya>integrasi WSL, dan aktifkan integrasi untuk distribusi WSL yang diinstal.

Visual Studio Code tidak dapat tersambung ke kontainer Pastikan Docker Desktop berjalan sebelum membuka Visual Studio Code. Periksa ikon baki sistem Docker Desktop.

Langkah berikutnya

  • Last updated on