VS Code, Git ve Docker ile Hızlı Geliştirme Ortamı Kurulumu

Modern geliştirici iş akışlarında VS Code, Git ve Docker birlikte kullanıldığında hem bireysel hem de ekip verimliliği artar. Docker, uygulamaları kapsayıcılar içinde çalıştırarak ortam bağımlılıklarını azaltır ve tekrarlanabilir ortamlar sağlar (Docker blog). Visual Studio Code ise kapsayıcı içi geliştirmeyi destekleyen Dev Containers özelliğiyle, konteyner tabanlı geliştirme deneyimini kolaylaştırır (VS Code Dev Containers).

Neler kazanacaksınız?

Daha tutarlı geliştirme ortamları ("works on my machine" sorunlarının azalması).
Hızlı onboarding: yeni geliştiriciler depo klonlayıp kısa sürede çalışmaya başlayabilir.
VS Code içinde Git ile entegre sürüm kontrolü ve konteyner tabanlı hata ayıklama.

Gereksinimler (kısa)

İşletim Sistemi uyumluluğu: Windows (tercihen WSL2), macOS veya Linux.
Git kurulumu ve temel yapılandırma (https://git-scm.com üzerinden yönergeler).
Docker Desktop veya uygun Docker Engine kurulumu; platforma göre WSL2/VM gereksinimleri olabilir.
Visual Studio Code ve Dev Containers desteği (resmi doküman için VS Code Dev Containers sayfasına bakın).

Hızlı Kurulum Adımları (adım adım)

Git yükleyin ve temel ayarları yapın.
Git'i kurduktan sonra yerel kullanıcı adı ve e-posta tanımlayın: git config --global user.name "Adınız" ve git config --global user.email "[email protected]". Bu, commit kayıtlarının doğru görünmesini sağlar.
Docker'ı kurun.
Docker kurulum talimatları işletim sistemine göre değişir. Windows'ta WSL2 tabanlı kurulum yaygın kullanımdadır; Docker ve VS Code entegrasyonu hakkında genel bilgiler için Docker'ın rehberine bakın (Docker blog).
VS Code ve Dev Containers özelliğini etkinleştirin.
VS Code'a Dev Containers desteğini ekleyin veya güncel VS Code sürümünü kullanın. Resmi doküman, konteyner içinde geliştirme akışını açıklar ve örnekler sunar (VS Code Dev Containers).
Depoyu klonlayın ve .devcontainer dizinini oluşturun.
Örnek: git clone https://github.com/your-org/your-repo.git. Depo kökünde .devcontainer adında bir klasör oluşturun ve burada devcontainer.json ile Dockerfile veya docker-compose dosyasını tanımlayın.
Basit bir devcontainer.json örneği oluşturun.
Minimal bir yapı şöyle olabilir (örnek gösterim):
{"name": "dev-container","image": "mcr.microsoft.com/vscode/devcontainers/base:ubuntu","postCreateCommand": "npm install","extensions": ["ms-vscode.cpptools", "ms-python.python"]}

Bu örnek: bir temel imaj kullanır, oluşturma sonrası komut çalıştırır ve geliştirici uzantılarını önerir. Daha ileri gereksinimler için Dockerfile veya docker-compose kullanabilirsiniz.
VS Code içinde projeyi konteyner olarak açın.
VS Code Command Palette içinden Dev Containers ile "Reopen in Container" seçeneğini kullanarak, tanımladığınız konteyner içinde editöre yeniden bağlanabilirsiniz. Bu işlem, geliştiricinin yerel makinesindeki bağımlılıkları kurmadan çalışmasına olanak verir (VS Code Dev Containers).
Çoklu servisler için docker-compose kullanımı.
Veritabanı veya arka uç servisleri gerekiyorsa docker-compose.yml ile app ve db servislerini tanımlayın. Örnek yapı: version: "3.8" services: app: build: . volumes: - .:/workspace ports: - "3000:3000" db: image: postgres:15 environment: POSTGRES_PASSWORD: example. Bu yapı, VS Code Dev Containers ile uyumlu şekilde çalıştırılabilir.
Git iş akışı ve VS Code entegrasyonu.
VS Code, Source Control sekmesiyle commit/branch işlemlerini GUI üzerinden yönetmenizi sağlar. Terminal veya GUI ile commit yapın, dallanma (branch) oluşturun ve uzak depoya push/pull işlemlerini gerçekleştirin. VS Code eklentileriyle güvenli kimlik doğrulama (ör. credential helpers) konfigürasyonu yapabilirsiniz.

Paylaşım ve Onboarding İpuçları

Depoya .devcontainer klasörü ekleyin; yeni gelenler tek bir adımla (Open in Container) çalışmaya başlayabilsin.
.vscode/extensions.json dosyası ile önerilen uzantıları belirtin; böylece VS Code uzantılarını ekipçe standardize edebilirsiniz.
Environment değişkenleri için .env.example dosyası sağlayın; gerçek değerleri güvenli kanallarda paylaşın.
Onboarding sürecini README içinde net adımlar halinde yazın: kurulum, container açma, test çalıştırma, tipik sorunlar ve iletişim kanalı.
İsterseniz bir önceden oluşturulmuş container image (container registry) sağlayarak kurulum süresini kısaltabilirsiniz.

Yaygın Sorunlar ve Çözümleri

Dosya izinleri ve sahiplik problemleri
Linux konteynerlerde volume mount edildiğinde dosya sahipliği farklı olabilir. Gerekirse entrypoint veya postCreate komutunda kullanıcı izinlerini düzeltin.
Performans sorunları (macOS/Windows)
Dosya paylaşımlarında yavaşlık hissederseniz named volumes veya WSL2 tabanlı mount seçeneklerini değerlendirin.
Port çatışmaları
Yerel makinada aynı port kullanılıyorsa docker-compose içindeki port yönlendirmesini değiştirin veya ilgili servisi durdurun.
VS Code uzantıları konteyner içinde çalışmıyorsa
Bazı uzantılar yalnızca yerel ortamda çalışır; devcontainer.json içinde uzantıların doğru şekilde listelendiğinden ve gerektiğinde remote sürümünün kurulduğundan emin olun. Resmi doküman ek yönergeler içerir (VS Code Dev Containers).

Ekip İçin Onboarding Kontrol Listesi

.devcontainer dizini ve açıklayıcı README
.vscode/extensions.json ile önerilen uzantılar
Örnek .env veya çevresel değişken dokümantasyonu
Çalıştırma ve test komutları (örnekler)
Gerekirse önceden build edilmiş image ve registry bilgisi

Bu kılavuz genel amaçlıdır ve belirli işletim sistemi veya şirket politikalarına göre değişiklik gösterebilir. Resmi kaynaklar ve güncel talimatlar için VS Code Dev Containers ve Docker dokümantasyonlarını inceleyin; Docker ile VS Code entegrasyonuna dair pratik bilgileri Docker blog yazısında bulabilirsiniz (Docker blog).