Windows'de Geliştirme Kapsayıcıları ayarlama

Geliştirme Kapsayıcısı (Dev Container), sizin deponuzda denetlenen bir dosya tarafından tanımlanan tam geliştirme ortamı olarak bir devcontainer.json Docker kapsayıcısı kullanmanıza olanak tanır. Projeyi açan herkes, yerel makinelerinde ne yüklü olursa olsun aynı araçları, uzantıları ve ayarları alır.

Bu sayfa, Windows özel kurulumu kapsar. Geliştirme Kapsayıcılarının ne olduğunu ve nasıl çalıştıklarını tam olarak öğrenmek için VS Code web sitesindeki Geliştirme Kapsayıcıları belgelerine bakın.

Önkoşullar

Windows'da Geliştirme Kapsayıcıları şunları gerektirir:

• WSL 2 — Linux için Windows Alt Sistemi, sürüm 2. Henüz yüklemediyseniz WSL'yi yükleyin.
• WSL 2 arka ucuyla etkinleştirilmiş Docker Desktop for Windows. Docker Desktop'ı indirin ve yükleyiciyi takip edin. Kurulum sırasında Docker Desktop ayarlarında WSL 2 tabanlı altyapı kullan'ın seçili olduğundan emin olun (Ayarlar>Genel).
• Visual Studio Code — VS Code dosyasını indir.
• Geliştirme Kapsayıcıları uzantısı — VS Code Market'ten Geliştirme Kapsayıcıları uzantısını yükleyin.

Dosyalarınızı nerede depoladığınız önemlidir

Önemli

Windows'de Dev Container performansı, proje dosyalarınızın bulunduğu yere büyük ölçüde bağlıdır. Projenizi Windows dosya sisteminde değil WSL 2 dosya sisteminde (örneğin, /home/yourname/projects/) depolayın (örneğin, C:\Users\yourname\projects\).

Dosyalarınız Windows dosya sistemindeyken (C:\), Docker bunlara işletim sistemi arası bir dosya paylaşımı üzerinden erişir ve bu çok daha yavaştır. Dosyalarınız WSL 2 dosya sistemindeyken Docker yerel Linux G/Ç kullanır ve özellikle derlemeler ve dosya izleme araçları için performans önemli ölçüde daha iyidir.

WSL 2 dosya sistemine kopyalamak için Başlangıç menüsünden veya Windows Terminal WSL dağıtımınızı (örneğin, Ubuntu) açın ve buraya kopyalayın:

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

Ardından bu klasörü WSL'den VS Code'da açın:

code your-repo

VS Code, WSL'ye bağlanır ve bir devcontainer.json mevcutsa algılar.

Geliştirme Kapsayıcısında proje açma

Projeniz VS Code'da açıldıktan sonra (WSL'ye bağlı):

1. F1 tuşuna basın ve Geliştirme Kapsayıcıları: Kapsayıcıda Yeniden Aç'ı seçin.
2. VS Code içinde .devcontainer/devcontainer.json tanımlanan kapsayıcı görüntüsünü oluşturur (veya yoksa eklemenizi ister).
3. Derleme tamamlandığında, VS Code tüm yapılandırılmış araçlar ve uzantılar ile kapsayıcıya yeniden bağlanır.

Yerel ortamınıza dönmek için F1 tuşuna basın ve Geliştirme Kapsayıcıları: Klasörü Yerel Olarak Yeniden Aç'ı seçin.

Var olan projeye Geliştirme Kapsayıcısı ekleme

Projenizin henüz bir devcontainer.json özelliği yoksa:

1. F1 tuşuna basın ve Geliştirme Kapsayıcıları: Geliştirme Kapsayıcısı Yapılandırma Dosyaları Ekle'yi seçin.
2. Bir temel görüntü seçin (örneğin, Node.js, Python veya genel bir Debian/Ubuntu görüntüsü).
3. VS Code, kaynak denetimine denetleyebileceğiniz bir .devcontainer/devcontainer.json dosya oluşturur.

devcontainer.json seçenekleri için tam referans için bkz. Dev Container Specification sitesinde devcontainer.json referansı.

Sorun giderme

Container başlatılır ancak dosya değişiklikleri algılanmaz Projeniz büyük olasılıkla Windows dosya sisteminde depolanır. WSL'ye taşıyın (bkz. Dosyalarınızı nerede depoladığınız yukarıda önemlidir ).

Docker Desktop başlatılmıyor veya WSL tümleştirmesi eksik Docker Desktop'ı açın, Ayarlar>Kaynakları>WSL tümleştirmesi'ne gidin ve yüklü WSL dağıtımlarınız için tümleştirmeyi etkinleştirin.

VS Code kapsayıcıya bağlanamıyor VS Code'i açmadan önce Docker Desktop'ın çalıştığından emin olun. Docker Desktop sistem tepsisi simgesini denetleyin.

Sonraki Adımlar

• Geliştirme Kapsayıcıları belgeleri — VS Code ekibinden tam başvuru
• devcontainer.json başvurusu — tüm yapılandırma seçenekleri
• Daha geniş WSL + Docker kurulum kılavuzu olan WSL 2'de Docker uzak kapsayıcılarını kullanmaya başlama
• WSL'yi yükleme — WSL'yi henüz ayarlamadıysanız