Hızlı Başlangıç

Kendi sunucunuzda şifrelenmiş, izole bir konteyner ortamı dağıtın. Bulut hesabı veya SaaS bağımlılığı gerekmez. Her şey sizin kontrol ettiğiniz donanım üzerinde çalışır.

---

Giriş

Temel Kavramlar

Bir repo, disk üzerinde tek bir şifrelenmiş dosyadır. Taşıyabilir, yedekleyebilir, çatallayabilirsiniz. Sadece bir dosyadır. Bağlandığında, içinde özel bir Docker daemon’u ve uygulama verileriniz bulunan bir klasöre dönüşür.

Bir repoyu USB bellek gibi düşünün. Elinizde somut bir şeydir ve taktığınızda sistem tarafından görünür ve erişilebilir hale gelir. Uygulamalarınız ve verileriniz tamamen taşınabilirdir. Herhangi bir bulut sağlayıcısındaki herhangi bir makinede Tak ve Çalıştır.

İki araç, iki rol:

• rdc = Dizüstü bilgisayarınızdaki CLI (TypeScript, global olarak kurulur)
• renet = Sunucudaki orkestratör (Go ikili dosyası, daemon/ağ/izolasyon yönetimi)
• RDC, config machine setup sırasında renet’i otomatik olarak kurar. Sunucuda elle kurulum gerekmez.

Mimari güvenlik modelini açıklar. rdc vs renet hangi aracı ne zaman kullanacağınızı açıklar.

1. CLI Kurulumu

curl -fsSL https://www.rediacc.com/install.sh | bash
rdc doctor     # Doğrulama: Node, SSH anahtarı, renet, Docker

Windows, Alpine, Arch: bkz. Kurulum. Tam sistem gereksinimleri: Gereksinimler.

2. SSH Anahtar Kurulumu

rdc, SSH üzerinden bağlanır. rdc sunucuya ulaşabilmesi için sunucunun ortak anahtarınıza güvenmesi gerekir.

# Anahtar oluşturun (zaten varsa atlayın)
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519

# Ortak anahtarı sunucuya kopyalayın (parola isteyecektir)
ssh-copy-id -i ~/.ssh/id_ed25519 user@your-server-ip

# rdc'ye hangi anahtarı kullanacağını belirtin
rdc config ssh set --key ~/.ssh/id_ed25519

Artık her rdc komutu bu anahtarla kimlik doğrulaması yapar. Parola gerekmez.

3. Sunucunuzu Ekleyin

rdc config machine add --name my-server --ip 192.168.1.100 --user muhammed
rdc config machine setup --name my-server  # renet kurulumu + veri deposu oluşturma

Ne olur: SSH host anahtarı taranır, renet ikili dosyası yüklenir, sunucuda şifrelenmiş veri deposu başlatılır. Repolar için hazır.

Veri deposu boyutlandırma, Ceph RBD, bulut sağlayıcıları: Makine Kurulumu. SSH hataları: Sorun Giderme.

4. Yapılandırma Dosyası

rdc config show                            # Okunabilir özet
cat ~/.config/rediacc/rediacc.json         # Ham JSON: makineler, repolar, depolar, SSH anahtarı

Tek dosya = tek ortam. Başka bir dizüstü bilgisayara kopyalayın ve hazırsınız.

---

Repo ile Çalışma

1. Repo Oluşturma

rdc repo create --name my-app -m my-server --size 2G  # 2 GB şifrelenmiş repo oluştur

Şifrelenmiş birimi oluşturur, bağlar ve Docker daemon’unu başlatır. Repo yapılandırmanıza kaydedilir ve kullanıma hazırdır.

Yeniden boyutlandırma, silme, doğrulama: Depolar.

2. Şablon Uygulama

rdc repo template list                                        # Gömülü şablonları göster
rdc repo template apply --name app-postgres -m my-server -r my-app  # docker-compose.yml + Rediaccfile dağıt

Şablonlar bir docker-compose.yml, Rediaccfile ve destekleyici dosyalar sağlar. Bir şablon (veya kendi compose dosyanız) olmadan başlatılacak bir şey yoktur.

3. Repoyu Başlatma

rdc repo up --name my-app -m my-server  # Rediaccfile up() çalıştır
rdc repo list -m my-server                           # Makinedeki tüm repoları gör
rdc repo status --name my-app -m my-server  # Bağlama durumu, Docker, boyut, şifreleme

repo up gerektiğinde otomatik bağlama yapar. Ek bayrak gerekmez.

4. VS Code

rdc vscode connect -m my-server -r my-app              # VS Code SSH açar, repo sandbox'una iner

Şifrelenmiş birim içinde dosyaları düzenliyorsunuz. docker ps yalnızca bu reponun konteynerlerini gösterir. Kaydedin, compose up yapın, tekrarlayın.

5. rdc repo up ile renet dev up Karşılaştırması

	rdc repo up	renet dev up
Nerede çalıştırırsınız	Dizüstü bilgisayarınız (CLI)	VS Code sandbox içinde
Ne yapar	SSH → otomatik bağlama → Rediaccfile up() çalıştırır	Rediaccfile up() doğrudan çalıştırır
Kullanım senaryosu	CI/CD, otomasyon, uzaktan işlemler	Geliştirici iç döngüsü
İzolasyon	Dışarıdan yönetir	Zaten sandbox içindedir

Demo akışı: rdc repo template apply → rdc vscode connect -m my-server -r my-app → docker-compose.yml düzenle → renet dev up → uygulamanın çalıştığını gör → tekrarla.

Rediaccfile yapısı: Servisler. Hangi aracı ne zaman kullanmalı: rdc vs renet.

6. İzolasyon Modeli

• Evrensel kullanıcı (rediacc): Her makinede aynı UID. Bir repoyu başka bir sunucuya taşıdığınızda dosya sahipliği sorunsuz çalışır. chown sorunları olmaz.
• Repo başına Docker daemon: Her repo kendi izole Docker daemon’una sahiptir. docker ps yalnızca BU reponun konteynerlerini gösterir.
• Landlock + OverlayFS sandbox: VS Code kabuğu dosya sistemiyle sınırlıdır. Diğer repoları okuyamazsınız. $HOME dizinine yapılan yazmalar repo bazında katmanlardır.

İzolasyonun çalışma prensibi: Mimari. Rediaccfile yaşam döngüsü: Servisler.

7. Terminal, Senkronizasyon ve Tünel

Terminal:

rdc term connect -m my-server -r my-app                            # Repo sandbox'una SSH bağlantısı
rdc term connect -m my-server -r my-app -c "curl localhost:3000"   # Komut çalıştır ve çık
rdc term connect -m my-server                                   # Makineye SSH (sandbox yok)

Dosya Senkronizasyonu (SSH üzerinden rsync):

rdc repo sync upload -m my-server -r my-app --local ./src       # Yerel dosyaları repoya gönder
rdc repo sync download -m my-server -r my-app --local ./backup  # Repo dosyalarını yerele çek
rdc repo sync download -m my-server -r my-app --local ./backup --dry-run  # Önce önizleme yap

Tünel (Konteynere SSH port yönlendirme):

rdc repo tunnel -m my-server -r my-app  # Konteyner ve portu otomatik algıla
rdc repo tunnel -m my-server -r my-app --port 5432  # Postgres tüneli
rdc repo tunnel -m my-server -r my-app --port 5432 --local 15432  # Özel yerel port

Tünel çalıştırın → tarayıcıda localhost:3000 açın → uzak sunucudan canlı uygulama.

Senkronizasyon, terminal, VS Code detayları: Araçlar.

---

Çatallama ve Yedekleme

1. Grand ve Fork Repoları

rdc repo fork --parent my-app -m my-server --tag experiment --up  # Anında CoW klonu + başlat
rdc repo list -m my-server                                  # Gösterir: my-app (grand) + my-app:experiment (fork)
rdc repo delete --name my-app:experiment -m my-server  # Fork'u sil, grand'a dokunulmaz

Anında, sıfır kopya klonlama. CoW (copy-on-write). Mikrosaniyeler, veri kopyalanmaz. Bir taraf yazana kadar bloklar paylaşılır.

Kullanım senaryoları:

• AI / ML: Üretim veri setini çatalla, deney yap, at veya terfi ettir
• DevOps: Çatalla → geçişi test et → kötüyse sil, iyiyse terfi ettir
• Yedekleme: Fork = anlık görüntü, uzak konuma gönder

Fork yaşam döngüsü, makineler arası fork: Depolar.

2. Başka Bir Makineye Gönderme

# Repoyu başka bir makineye gönder
rdc repo push --name my-app -m my-server --to backup-server

# Gönder ve hedefte otomatik dağıt
rdc repo push --name my-app -m my-server --to backup-server --up

# CRIU kontrol noktası ile gönder (canlı geçiş, bellek durumunu korur)
rdc repo push --name my-app -m my-server --to new-server --checkpoint --up

# Yeni bir makineye gönder (bulut sağlayıcı ile otomatik kurulum)
rdc repo push --name my-app -m my-server --to new-server --provision linode --up

3. Bulut Depolamaya Gönderme (OneDrive, Google Drive, S3)

# rclone yapılandırmanızı depolama arka ucu olarak içe aktarın
rdc config storage import --file ~/rclone.conf

# Kullanılabilir depolamaları listeleyin
rdc storage list

# Repoyu bulut depolamaya gönderin
rdc repo push --name my-app -m my-server --to my-s3-backup

# Depolamadaki yedekleri listeleyin
rdc repo backup list --from my-s3-backup -m my-server

--to hedefin bir makine mi yoksa depolama arka ucu mu olduğunu otomatik algılar. rclone destekli tüm sağlayıcılarla çalışır: S3, R2, B2, OneDrive, Google Drive, SFTP, vb.

4. Uzaktan Çekme

# Bir bulut makinesinden yerel sunucunuza repo çekin
rdc repo pull --name my-app -m my-local-server --from cloud-server

# Bulut depolamadan çekin
rdc repo pull --name my-app -m my-local-server --from my-s3-backup

# Çek ve hemen başlat
rdc repo pull --name my-app -m my-local-server --from my-s3-backup --up

Neden pull? Yerel makineniz NAT arkasındadır. Bulut size push yapamaz. Ama siz buluta ulaşabilirsiniz. Pull, repoyu eve getirir.

Tam döngü: Geliştirmede oluştur → buluta gönder → üretimde çek → --up. Tek repo, herhangi bir makine, herhangi bir bulut.

Zamanlama, otomatik yedekleme, geri yükleme: Yedekleme ve Geri Yükleme.

---

Proxy ve SSL

1. Altyapı Yapılandırması

rdc config infra set -m my-server  # Yapılandır: temel alan adı, genel IP'ler, port aralıkları
rdc config infra show -m my-server  # Yapılandırmayı incele
rdc config infra push -m my-server  # Proxy yapılandırmasını uzak sunucuya gönder

Yönlendirme nasıl çalışır:

• Traefik, rediacc.service_name ve rediacc.service_port etiketleri aracılığıyla konteynerleri otomatik keşfeder
• Yönlendirme: {service}-{networkId}.{baseDomain} → konteyner IP:port
• SSL: Cloudflare DNS-01 doğrulaması ile Let’s Encrypt (otomatik yenileme, wildcard sertifikaları)

2. Proxy Şablonu

rdc repo template apply --name proxy -m my-server -r infra  # Proxy'yi bir repoya dağıt
rdc repo up --name infra -m my-server  # Traefik'i başlat

Traefik artık bu makinedeki tüm repolara gelen dış trafiği yönlendirir. Her konteyner otomatik olarak bir HTTPS uç noktası alır.

# https://my-app.example.com adresine gidin → konteynere yönlendirilir
# Veritabanları için TCP/UDP yönlendirme:
#   rediacc.tcp_ports=3306,5432 → otomatik atanan harici portlar

Yönlendirme kuralları, DNS, TLS yapılandırması: Ağ.

---

Sonraki Adımlar

• Geçiş Rehberi - Mevcut projeleri Rediacc depolarına taşıma
• İzleme - Makine sağlığı, konteynerler, servisler, tanılamalar
• CLI Referansı - Eksiksiz komut referansı
• Hızlı Referans Kartı - Hızlı komut arama
• Sorun Giderme - Yaygın sorunların çözümleri
• Rediacc Kuralları - Rediaccfile en iyi uygulamaları ve dağıtım kontrol listesi