Geçiş Rehberi

Mevcut bir projeyi, dosyalar, Docker servisleri, veritabanları, geleneksel bir sunucudan veya yerel geliştirme ortamından şifrelenmiş bir Rediacc deposuna taşıyın.

Ön Koşullar

• rdc CLI kurulu (Kurulum)
• Bir makine eklenmiş ve hazırlanmış (Kurulum)
• Sunucuda projeniz için yeterli disk alanı (rdc machine status ile kontrol edin)

Adım 1: Depo Oluşturma

Projenize uygun boyutta şifrelenmiş bir depo oluşturun. Docker imajları ve konteyner verileri için ek alan ayırın.

rdc repo create --name my-project -m server-1 --size 20G

Ipucu: Daha sonra rdc repo resize ile yeniden boyutlandırabilirsiniz, ancak deponun önce bağlantısının kesilmesi gerekir. Yeterli alanla başlamak daha kolaydır.

Adım 2: Dosyalarınızı Yükleme

Proje dosyalarınızı depoya aktarmak için rdc repo sync upload kullanın.

# Ne aktarılacağını önizleyin (değişiklik yapılmaz)
rdc repo sync upload -m server-1 -r my-project --local ./my-project --dry-run

# Dosyaları yükleyin
rdc repo sync upload -m server-1 -r my-project --local ./my-project

Yüklemeden önce depo bağlı olmalıdır. Henüz bağlı değilse:

rdc repo mount --name my-project -m server-1

Uzak dizinin yerel dizininizle tam olarak eşleşmesini istediğiniz sonraki senkronizasyonlar için:

rdc repo sync upload -m server-1 -r my-project --local ./my-project --mirror

--mirror bayrağı, yerel olarak bulunmayan uzak dosyaları siler. Doğrulamak için önce --dry-run kullanın.

Adım 3: Dosya Sahipliğini Düzeltme

Yüklenen dosyalar yerel kullanıcınızın UID’si ile gelir (örn. 1000). Rediacc, VS Code, terminal oturumları ve araçların tutarlı erişime sahip olması için evrensel bir kullanıcı (UID 7111) kullanır. Dönüştürmek için sahiplik komutunu çalıştırın:

rdc repo ownership --name my-project -m server-1

Docker-Duyarlı Istisna

Docker konteynerleri çalışıyorsa (veya çalıştıysa), sahiplik komutu otomatik olarak yazılabilir veri dizinlerini algılar ve atlar. Bu, dosyalarını farklı UID’lerle yöneten konteynerlerin bozulmasını önler (örn. MariaDB UID 999, Nextcloud UID 33 kullanır).

Komut ne yaptığını raporlar:

Excluding Docker volume: database/data
Excluding Docker volume: redis/data
Ownership set to UID 7111 (245 changed, 4 skipped, 0 errors)

Ne Zaman Çalıştırılmalı

• Dosyaları yükledikten sonra, yerel UID’nizi 7111’e dönüştürmek için
• Konteynerleri başlattıktan sonra, Docker birim dizinlerinin otomatik olarak hariç tutulmasını istiyorsanız. Konteynerler henüz başlatılmadıysa, hariç tutulacak birim yoktur ve tüm dizinler değiştirilir (bu normaldir, konteynerler ilk başlatmada verilerini yeniden oluşturur)

Zorunlu Mod

Docker birim algılamasını atlayıp konteyner veri dizinleri dahil her şeyi değiştirmek için:

rdc repo ownership --name my-project -m server-1

Uyari: Bu, çalışan konteynerleri bozabilir. Gerekirse önce rdc repo down ile durdurun.

Özel UID

Varsayılan 7111 dışında bir UID ayarlamak için:

rdc repo ownership --name my-project -m server-1 --uid 1000

Adım 4: Rediaccfile Kurulumu

Proje kök dizininizde bir Rediaccfile oluşturun. Bu Bash betiği, servislerinizin nasıl başlatılacağını ve durdurulacağını tanımlar.

#!/bin/bash

up() {
    renet compose -- up -d
}

down() {
    renet compose -- down
}

Iki yaşam döngüsü fonksiyonu:

Fonksiyon	Amaç	Hata Davranışı
up()	Servisleri başlatma	Kök başarısızlığı kritiktir; alt dizin başarısızlıkları günlüğe kaydedilir ve devam eder
down()	Servisleri durdurma	En iyi çaba: her zaman hepsini dener

Önemli: Rediaccfile’ınızda docker compose yerine her zaman renet compose -- kullanın. renet compose sarmalayıcısı host ağını, CRIU checkpoint/restore yeteneklerini, IP tahsisini ve renet-proxy tarafından gereken servis keşfini zorunlu kılar. docker compose’u doğrudan kullanmak bunların hepsini atlar ve doğrulama sırasında reddedilir.

Asla sudo docker da kullanmayın, sudo, DOCKER_HOST dahil ortam değişkenlerini sıfırlar, bu da konteynerlerin deponun izole daemon’u yerine sistem Docker daemon’unda oluşturulmasına neden olur. Rediaccfile fonksiyonları zaten yeterli ayrıcalıklarla çalışır.

Rediaccfile’lar, çoklu servis düzenleri ve yürütme sırası hakkında tam ayrıntılar için Servisler bölümüne bakın.

Adım 5: Servis Ağını Yapılandırma

Rediacc, depo başına izole bir Docker daemon’u çalıştırır. Servisler network_mode: host kullanır ve benzersiz geri döngü IP’lerine bağlanır, böylece depolar arasında çakışma olmadan standart portları kullanabilirler.

docker-compose.yml Dosyanızı Uyarlama

Önce (geleneksel):

services:
  postgres:
    image: postgres:16
    ports:
      - "5432:5432"
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: secret

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

  app:
    image: my-app:latest
    ports:
      - "8080:8080"
    environment:
      DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb
      REDIS_URL: redis://redis:6379

Sonra (Rediacc):

services:
  postgres:
    image: postgres:16
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: secret

  redis:
    image: redis:7-alpine

  app:
    image: my-app:latest
    environment:
      DATABASE_URL: postgresql://postgres:secret@postgres:5432/mydb
      REDIS_URL: redis://redis:6379
      LISTEN_ADDR: 0.0.0.0:8080

Temel değişiklikler:

1. ports: eşlemelerini kaldırın - renet compose host ağını kullanır ve port eşlemelerini otomatik olarak kaldırır
2. network_mode: host kaldırın - renet compose bunu sizin için ekler
3. Yeniden başlatma politikaları saklamak güvenlidir - renet bunları CRIU uyumluluğu için otomatik olarak kaldırır ve router watchdog durdurulan konteynerleri otomatik olarak kurtarır
4. Servisler arası bağlantılar için servis adlarını kullanın (örn. postgres, redis) - renet her servis adını çözümlenebilir bir ana bilgisayar adı olarak enjekte eder. Veritabanlarında veya yapılandırma dosyalarında saklanan bağlantı dizelerine ham IP’ler yerleştirmeyin; fork izolasyonunu korumak için servis adını kullanın
5. Bağlama otomatiktir - kernel bind() çağrılarını doğru geri döngü IP’sine yeniden yazar. Servisler 0.0.0.0 veya localhost kullanabilir

{SERVICE}_IP değişkenleri ihtiyaç duyulduğunda hâlâ kullanılabilir, ancak açık bağlama artık gerekli değildir. Adlandırma kuralı: büyük harf, tireler alt çizgiyle değiştirilir, _IP son eki. Örneğin, listmonk-app LISTMONK_APP_IP olur.

IP ataması ve .rediacc.json hakkında ayrıntılar için Servis Ağı bölümüne bakın.

Adım 6: Servisleri Başlatma

Depoyu bağlayın (henüz bağlı değilse) ve tüm servisleri başlatın:

rdc repo up --name my-project -m server-1

Bu işlem:

1. Şifrelenmiş depoyu bağlar
2. Izole Docker daemon’unu başlatır
3. Servis IP atamalarıyla .rediacc.json dosyasını otomatik oluşturur
4. Tüm Rediaccfile’lardan up() fonksiyonunu çalıştırır

Konteynerlerinizin çalıştığını doğrulayın:

rdc machine containers --name server-1

Adım 7: Otomatik Başlatmayı Etkinleştirme (Isteğe Bağlı)

Varsayılan olarak, sunucu yeniden başlatıldıktan sonra depolar manuel olarak bağlanmalı ve başlatılmalıdır. Servislerinizin otomatik olarak başlaması için otomatik başlatmayı etkinleştirin:

rdc repo autostart enable --name my-project -m server-1

Depo parolası sorulacaktır.

Güvenlik notu: Otomatik başlatma, sunucuda bir LUKS anahtar dosyası depolar. Root erişimi olan herkes depoyu parola olmadan bağlayabilir. Ayrıntılar için Otomatik Başlatma bölümüne bakın.

Yaygın Geçiş Senaryoları

WordPress / PHP ve Veritabanı

my-wordpress/
├── Rediaccfile
├── docker-compose.yml
├── app/                    # WordPress dosyaları (çalışırken UID 33)
├── database/data/          # MariaDB verileri (çalışırken UID 999)
└── wp-content/uploads/     # Kullanıcı yüklemeleri

1. Proje dosyalarınızı yükleyin
2. Önce servisleri başlatın (rdc repo up) böylece konteynerler veri dizinlerini oluştursun
3. Sahiplik düzeltmesini çalıştırın, MariaDB ve uygulama veri dizinleri otomatik olarak hariç tutulur

Node.js / Python ve Redis

my-api/
├── Rediaccfile
├── docker-compose.yml
├── src/                    # Uygulama kaynak kodu
├── node_modules/           # Bağımlılıklar
└── redis-data/             # Redis kalıcılığı (çalışırken UID 999)

1. Projenizi yükleyin (node_modules hariç tutmayı ve up() içinde çekmeyi düşünün)
2. Konteynerler başladıktan sonra sahiplik düzeltmesini çalıştırın

Özel Docker Projesi

Docker servisleri olan herhangi bir proje için:

1. Proje dosyalarını yükleyin
2. docker-compose.yml dosyasını uyarlayın (Adım 5’e bakın)
3. Yaşam döngüsü fonksiyonlarıyla bir Rediaccfile oluşturun
4. Sahiplik düzeltmesini çalıştırın
5. Servisleri başlatın

Sorun Giderme

Yüklemeden Sonra Erişim Reddedildi

Dosyalar hâlâ yerel UID’nize sahip. Sahiplik komutunu çalıştırın:

rdc repo ownership --name my-project -m server-1

Konteyner Başlamıyor

Servislerin çalışıp çalışmadığını kontrol edin ve günlüklerini inceleyin:

# Atanmış IP'leri kontrol edin
rdc term connect -m server-1 -r my-project -c "cat .rediacc.json"

# Konteyner günlüklerini kontrol edin
rdc term connect -m server-1 -r my-project -c "docker logs <container-name>"

Depolar Arasında Port Çakışması

Her depo benzersiz geri döngü IP’leri alır ve kernel bind() çağrılarını otomatik olarak doğru IP’ye yeniden yazar. Depolar arasında port çakışmaları olmamalıdır. Beklenmedik davranış görürseniz, servislerin docker compose yerine renet compose aracılığıyla başlatıldığını doğrulayın. Diğer servislere bağlanırken ham IP’ler yerine servis adını (örn. postgres) kullanın; servis adları her fork’ta doğru şekilde çözümlenir.

Sahiplik Düzeltmesi Konteynerleri Bozuyor

rdc repo ownership çalıştırdıysanız ve bir konteyner çalışmayı durdurduysa, konteynerin veri dosyaları değiştirilmiştir. Konteyneri durdurun, veri dizinini silin ve yeniden başlatın, konteyner onu yeniden oluşturacaktır:

rdc repo down --name my-project -m server-1
# Konteynerin veri dizinini silin (örn. database/data)
rdc repo up --name my-project -m server-1