rdev
Dokümanlar English Türkçe Giriş yap Hesap oluştur

rdev'i kullanma

Laptopunuzu bağlama

Laptopunuz editör ve tarayıcı görevi görür. Kod, servisler ve ajanlar sunucunuzda kalır.

Kendi tailnet'iniz

Laptopunuz ve sunucunuz, Tailscale hesabınıza ait özel bir Tailscale ağı üzerinden konuşur. rdev bu ağa asla katılmaz. Kurulum aracı sunucunuzu hesabınızdan alınan bir anahtarla bağlar, laptop uygulaması da laptopunuzu bağlar.

Dosya senkronu

Mutagen proje dosyalarınızı laptopunuzla sunucunuz arasında iki yönlü olarak senkron tutar. node_modules, vendor ve derleme çıktıları gibi taşınması gerekmeyen klasörler baştan hariç tutulur.

Neyin senkronlanacağını panelinizde Pano > sunucunuz > Ayarlar altından seçersiniz:

  • Laptoplara senkronla: tamamen uzaktan çalışmak için kapatın. Laptopa hiçbir şey kopyalanmaz; editörünüz projeleri SSH ile açar (ssh rdev, VS Code ya da Cursor Remote-SSH, PhpStorm Gateway). Siteler ve .dev.test çalışmaya devam eder.
  • Laptoplardaki projeler: bir projenin işaretini kaldırırsanız proje yalnızca sunucuda kalır. Laptopta zaten bir kopyası varsa ona dokunulmaz; gerekmediğinde silin. Proje daha sonra yeniden senkronlanırsa laptoptaki eski kopya önce ~/Code-rdev-old/ altına taşınır, ardından sunucudaki kopya iner.
  • Hiç senkronlanmayanlar: her birini kapatabileceğiniz varsayılan hariç tutmalar ve Mutagen'in .gitignore benzeri sözdizimiyle kendi kalıplarınız.

Laptoplar yeni kuralları birkaç dakika içinde uygular. Hemen uygulamak için rdev laptop sync çalıştırın.

Editörler ve tarayıcı

Senkronlanan dosyalarda VS Code ya da PhpStorm gibi zaten bildiğiniz editörü kullanın. Sitelerinizi alıştığınız tarayıcıda https://<name>.dev.test adresinden açın; laptop uygulaması bu adresler için ad çözümlemesini ve güvenilir bir sertifikayı ayarlar.

Ekran görüntüleri

Sunucudaki bir terminale görsel yapıştırılamaz, bu yüzden rdev ajanınıza kendi ekran görüntüsü klasörünü verir. Laptopunuzdaki ~/rdev-shots klasörüne düşen her şey, dosya senkronu kapalı olsa bile birkaç saniye içinde sunucudaki ~/Shots klasörüne kopyalanır. Ajanınıza "son ekran görüntüsüne bak" demeniz yeter; en yenisini açar.

  • Mac uygulamasındaki (menü çubuğu simgesinde de var) Send clipboard image, panodaki görüntüyü kaydeder, sunucuya ulaşmasını bekler ve sunucudaki yolunu panoya koyar; bunu ajana yapıştırın. Terminalde: rdev laptop shots send.
  • Save macOS screenshots here, Shift-Command-3, 4 ve 5 ile alınan görüntülerin ~/rdev-shots'a kaydedilmesini sağlar (rdev laptop shots macos). Shottr ya da CleanShot gibi uygulamalar da oraya kaydedebilir.
  • Ekran görüntüleri 7 gün sonra iki tarafta da silinir. Doğrudan sunucunuza gider, rdev.cloud'dan hiç geçmez. Uygulamadaki anahtarla ya da rdev laptop shots off ile kapatabilirsiniz.

Desteklenen laptoplar

Lansmanda laptop uygulaması Mac ve Linux üzerinde çalışır. Windows desteği lansmandan sonra gelecek.

Adım adım bağlantı

  1. Laptopunuza Tailscale kurun ve sunucunuzun kullandığı Tailscale hesabıyla giriş yapın. Linux'ta bu adımı atlayabilirsiniz: Tailscale yoksa rdev laptop connect onu Tailscale'in resmî deposundan kurar ve girişi başlatır, girişi tarayıcınızda tamamlarsınız.
  2. Laptopunuza rdev'i kurup bağlayın. Bu komutu terminalde kendi kullanıcınızla çalıştırın ve istendiğinde laptop parolanızı girin; parola rdev'i kurmak, sertifikayı güvenilir kılmak ve ad çözümlemesini ayarlamak için gerekir:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Komut rdev komutunu kurar ve rdev laptop connect'i çalıştırır. Bu adım sunucunuzu tailnet'inizde bulur, SSH ayarlarınıza rdev girdisini ekler, ortamınızın sertifikasını güvenilir kılar, *.dev.test adreslerini sunucunuza yönlendirir ve ~/Code klasörünüzü sunucudaki ~/Code ile senkronlamaya başlar. Kurulumda sunucuya başka bir ad verdiyseniz --server <ad>, başka bir klasörü senkronlamak için --code-dir <klasör> ekleyin. Kurulumu yeniden yapmak istediğinizde rdev laptop connect'i tekrar çalıştırın.

Önceden başka bir şey kurmanız gerekmez. Dosya senkronunu yapan Mutagen yoksa rdev sürümü sabitlenmiş ve sağlaması doğrulanmış bir kopyasını ~/.local/share/rdev/bin altına kurar; zaten kurulu bir Mutagen varsa onu kullanır. Linux'ta ekran görüntüleri için pano araçlarını (wl-clipboard, xclip) ve sertifikayı Chrome'a ekleyen certutil'i de paket yöneticinizle, aynı parola sorusu içinde kurar.

rdev laptop connect, parolanızı sormadan önce senkronlayacağı klasöre bakar. O klasörü ya da onu içeren bir klasörü başka bir Mutagen oturumu zaten senkronluyorsa (rdev ile de senkronlamak her şeyi üç makine arasında kopyalar) ya da klasör 5 GB'tan büyükse durur ve --code-dir <klasör> önerir. Klasörü yine de senkronlamak için --force ile çalıştırın. Bunun için rdev 0.2.0-beta.21 ya da sonrası gerekir.

dev.test'i zaten başka bir yere, örneğin başka bir geliştirme sunucusuna gönderen bir Mac'te rdev bu ayarı kenara koyar ve bağlantıyı kestiğinizde ya da rdev'i kaldırdığınızda geri getirir.

Bağlantıyı istediğiniz zaman rdev laptop status ile kontrol edin. rdev laptop disconnect senkronu durdurur ve ayarları kaldırır; dosyalarınız iki tarafta da kalır.

rdev'i laptopunuzdan kaldırmak

rdev laptop uninstall

Bağlantıyı keser, ortamınızın sertifikasına güvenmeyi bırakır ve rdev komutunu, ayarlarını ve kurduğu araçları kaldırır. Senkronlanan klasörünüz ve ~/rdev-shots kalır. rdev'in kurduğu Mutagen de başka senkron oturumları onu kullandığı sürece kalır. Laptop parolanızı bir kez sorar; rdev 0.2.0-beta.21 ya da sonrası gerekir.

Laptopunuzun sunucuya girebilmesi gerekir: kurulum aracı, kurulum sırasında sunucuya girebilen SSH anahtarlarını kopyalar. Başka bir laptop eklemek için açık anahtarını sunucuda /opt/rdev/home/.ssh/authorized_keys dosyasına ekleyin.

Bağlandıktan sonra sunucuda ssh rdev ile terminal açıp ajanınızı orada başlatın; sitelerinizi tarayıcıda https://<klasör>.dev.test adresinden açın.

Mac uygulaması

Yazmak yerine tıklamayı mı tercih edersiniz? Mac için rdev uygulamasını indirin (Apple silicon ve Intel; Apple tarafından imzalı ve onaylı), Uygulamalar klasörüne sürükleyip açın. Laptopunuzun bağlı olup olmadığını gösterir, tek düğmeyle bağlar ve bağlantıyı keser, sunucunuzda bir terminal açar. rdev laptop connect ile aynı kurulumu yapar; yalnızca Tailscale gerekir (1. adım), komutu kurmanız gerekmez; Mutagen'i uygulama kendisi kurar.

Uygulamada dört sekme var:

  • Sites: projeleriniz https://<ad>.dev.test bağlantıları olarak, sunucuda bir terminal ve ekran görüntüleriniz.
  • Sync: paneldeki ayarların aynısı (senkron açık/kapalı, bu laptoptaki projeler, hariç tutmalar). Kaydettiğinizde bu laptopta hemen uygulanır.
  • Env: sunucudaki bir projenin .env dosyasını okuyup değiştirin. Uygulama SSH bağlantısı üzerinden çalıştığı için mevcut değerleri gösterir ve değerler rdev.cloud'dan hiç geçmez.
  • Account: Sign in with rdev.cloud'u seçin, tarayıcıda şifrenizi onaylayın, aynı kodun göründüğünü kontrol edip onaylayın. Oturum açmış uygulamalar panelinizde Ayarlar > Bağlı uygulamalar altında listelenir; bağlantıları oradan kesilebilir.

Uygulama açık kaldığı sürece paneldeki senkron kurallarını beş dakikada bir uygular.

Firefox kendi sertifika listesini tutar. Firefox kullanıyorsanız ~/.config/rdev/ca.pem dosyasını Ayarlar > Gizlilik ve Güvenlik > Sertifikalar altından içe aktarın.