KTD-004 | Visual Studio Code ile Uzak Sunucu Yönetimi

Bölüm 1

Remote SSH Nedir?

Remote SSH, Visual Studio Code üzerinden uzak bir Linux sunucusuna bağlanıp dosyaları sanki kendi bilgisayarımızdaymış gibi düzenlememizi sağlayan bir yöntemdir.

📌 Gerçek Proje Notu

Bu doküman, kemaltokmak.com projesinin VPS üzerinde VS Code Remote SSH ile düzenlenmesi sırasında yapılan gerçek adımlardan hazırlanmıştır.

Bölüm 2

Gerekli Hazırlıklar

Remote SSH kullanmadan önce bilgisayarımızda Visual Studio Code, sunucumuzda ise SSH erişimi hazır olmalıdır.

Visual Studio Code kurulu olmalıdır.
VPS üzerinde SSH servisi çalışmalıdır.
Sunucu IP adresi bilinmelidir.
SSH kullanıcı adı ve anahtar dosyası hazır olmalıdır.

ssh root@SUNUCU_IP_ADRESI

Bölüm 3

Visual Studio Code Kurulumu

Visual Studio Code, uzak sunucu dosyalarını düzenlemek için kullanacağımız ana editördür. Kurulumdan sonra sol taraftaki eklentiler bölümünden Remote SSH eklentisi kurulacaktır.

💡 İpucu

VS Code ile uzak sunucuya bağlandıktan sonra nano gibi terminal editörlerine ihtiyaç duymadan dosyaları daha rahat düzenleyebiliriz.

Bölüm 4

Remote SSH Eklentisinin Kurulması

VS Code içinde sol menüden Extensions bölümüne girilir ve Remote - SSH eklentisi aranıp kurulur.

Remote SSH eklentisi ekran görüntüsü

Bölüm 5

SSH Anahtarını Kontrol Etme

SSH anahtarımızın bilgisayarda olup olmadığını kontrol edelim. Windows üzerinde genellikle kullanıcı klasöründeki .ssh dizini kullanılır.

ls ~/.ssh

Eğer anahtar yoksa yeni bir SSH anahtarı oluşturabiliriz.

ssh-keygen -t ed25519 -C "kemal266"

Bölüm 6

SSH Config Dosyasını Hazırlama

VS Code'un sunucuya kolay bağlanabilmesi için SSH config dosyasına bir bağlantı profili eklenir.

Host kemaltokmak-vps
    HostName SUNUCU_IP_ADRESI
    User root
    IdentityFile ~/.ssh/id_ed25519

Bu yapı sayesinde her seferinde uzun SSH komutu yazmak yerine sadece profil adını seçerek bağlanabiliriz.

Bölüm 7

VS Code ile Sunucuya Bağlanma

VS Code üzerinde sol alt köşedeki yeşil uzak bağlantı simgesine tıklanır. Ardından Connect to Host seçilir ve SSH config içinde tanımladığımız sunucu profili seçilir.

kemaltokmak-vps

ℹ️ Bilgi

İlk bağlantıda VS Code sunucuya kendi yardımcı dosyalarını kurar. Bu işlem birkaç dakika sürebilir.

Bölüm 8

Proje Klasörünü Açma

Bağlantı kurulduktan sonra File → Open Folder seçeneğiyle proje klasörümüz açılır.

/opt/docker/kemaltokmak

Bu klasör içinde Docker compose dosyası ve web sitesi dosyalarımız bulunur.

Bölüm 9

Uzak Sunucuda Dosya Düzenleme

VS Code ile bağlandığımızda sunucudaki dosyaları doğrudan düzenleyebiliriz. Örneğin web sitesi dosyaları şu klasör altındadır:

/opt/docker/kemaltokmak/html

Doküman sayfaları ise şu klasörde yer alır:

/opt/docker/kemaltokmak/html/docs

Bölüm 10

VS Code Terminalini Kullanma

VS Code içinden terminal açarak sunucuda komut çalıştırabiliriz. Bu terminal doğrudan VPS üzerinde çalışır.

pwd
ls -la
docker ps

💡 İpucu

VS Code terminali sayesinde hem dosyaları düzenleyip hem de aynı ekranda Docker, Git ve Linux komutlarını çalıştırabiliriz.

Bölüm 11

VS Code ile Git İşlemleri

VS Code sol menüsündeki Source Control alanından değişen dosyaları görebilir, commit alabilir ve GitHub'a push edebiliriz.

Aynı işlemler terminalden de yapılabilir:

git status
git add .
git commit -m "KTD-004 VS Code Remote SSH dokümanı eklendi"
git push origin main

Bölüm 12

Karşılaşılan Sorunlar ve Çözümler

Remote SSH bağlantılarında en sık karşılaşılan sorunlar SSH config hataları, yanlış anahtar dosyası yolu ve sunucu tarafında yetki problemleridir.

⚠️ Dikkat

SSH config dosyasında girilen HostName, User ve IdentityFile alanları doğru olmalıdır.

Bağlantıyı Terminalden Test Etme

ssh -i ~/.ssh/id_ed25519 root@SUNUCU_IP_ADRESI

Bu Dokümanda Ne Öğrendik?

✅ Özet

VS Code Remote SSH mantığını öğrendik.
SSH anahtarını kontrol ettik.
SSH config dosyası hazırladık.
VPS üzerindeki proje klasörünü VS Code ile açtık.
Uzak sunucuda dosya düzenledik.
VS Code terminali ile komut çalıştırdık.
Git işlemlerini VS Code ve terminal üzerinden yönettik.

Visual Studio Code ile Uzak Sunucu (Remote SSH) Yönetimi