Rediacc CLI Referansı
Genel Bakış
**Rediacc CLI** (`rdc`), kendi barındırdığınız altyapıyı yönetmek için bir komut satırı arayüzüdür — makineler, depolar, depolama, yedeklemeler ve daha fazlası.
Kurulum
Platformunuz için en son ikili dosyayı [Rediacc sürümler sayfasından](https://www.rediacc.com) indirin veya paket yöneticiniz aracılığıyla kurun:
# macOS / Linux
curl -fsSL https://www.rediacc.com | sh
# Or use the packaged binary directly
./rdc --help
Genel Seçenekler
Her komut bu genel bayrakları destekler:
| Bayrak | Açıklama |
|---|---|
--output | Çıkış biçimi (table|json|yaml|csv). Varsayılanı REDIACC_DEFAULT_OUTPUT ile değiştir. |
--config | Bu komut için belirli bir yapılandırma kullanın |
--lang | Dil geçersiz kılması ({{languages}}) |
--force | Onay istemlerini atla |
1. Yapılandırma Yönetimi
Yapılandırma dosyalarını yönetin: oluşturun, geçiş yapın, düzenleyin, durumu uzlaştırın ve çapraz kesen özellikleri kullanın (alanlar, denetim, SSH anahtarları, uzak senkronizasyon).
Yapılandırma dosyaları bağlantı ayrıntılarını (API URL'si, kimlik bilgileri, varsayılan takım/bölge/köprü) saklar; böylece ortamlar arasında hızlıca geçiş yapabilirsiniz.
1.1 prune
~/.config/rediacc/<config>.json dosyasındaki yerel yapılandırmadaki ölü ağırlığı kaldırır. Üç kategori temizlenir, hepsi yerel (SSH/renet çağrısı yok): (1) çapası GUID/repo/makine artık etkin yapılandırmada olmayan ACME sertifika önbellek girişleri; (2) erteleme süresi dolmuş arşivlenmiş depolar (varsayılan 7 gün, defaults.pruneGraceDays bakın); (3) askıdaki çapraz referanslar (machine→strategy, strategy→repo). Kullanımdaki kaynaklar, kimlik bilgileri, depolama belirteçleri ve known-hosts asla dokunulmaz. Varsayılan davranış değişiklikleri uygulamaktır; sadece önizleme için --dry-run kullanın.
rdc config prune [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Yapılandırma dosyasını değiştirmeden neyin kaldırılacağını önizler. Diğer prune komutlarının varsayılan-kapalı semantiğini yansıtır. | Hayır | - |
--certs-only | ACME sertifika önbellek kovasına sınırla. Arşiv temizliğini ve çapraz referans temizliğini atlar. --archives-only ve --refs-only ile karşılıklı dışlayıcıdır. | Hayır | - |
--archives-only | Süresi dolmuş arşiv temizlemeyle sınırla. Sertifika önbelleği ve çapraz referans temizliğini atlar. --certs-only ve --refs-only ile dışlayıcıdır. | Hayır | - |
--refs-only | Askıdaki çapraz referanslarla (machine→strategy, strategy→repo excludes/includes) sınırla. Sertifika önbelleği ve arşivleri atlar. --certs-only ve --archives-only ile dışlayıcıdır. | Hayır | - |
--purge-archived | Yaştan bağımsız olarak TÜM arşivlenmiş depoları düşür, yalnızca erteleme süresini aşmış olanları değil. Her arşivlenmiş depo için 'rdc repo admin archive purge' çalıştırmaya eşdeğerdir. Yalnızca depolanan kimlik bilgilerinden hiçbirinin geri yüklemek için gerekli olmadığından emin olduğunuzda kullanın. | Hayır | - |
--orphan-repos | Hiçbir makinede yer almayan depo girişlerini kaldırır. Her giriş o deponun kimlik bilgisini ve SSH anahtarını tutar, bu yüzden bu işlem geri alınamaz. Önce 'rdc config reconcile' komutunu çalıştırarak yerleşimin makineleri yansıtmasını sağlayın. | Hayır | - |
--grace-days <days> | Bu çağrı için arşiv erteleme penceresini (gün cinsinden) geçersiz kıl. Yapılandırmadaki defaults.pruneGraceDays değerine geri döner, hiçbiri ayarlanmazsa 7'ye düşer. | Hayır | - |
1.2 init
Yeni bir adlandırılmış yapılandırma dosyası oluşturun
Yerel modda makineleri doğrudan ekleyebilirsiniz:
rdc config init [name] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--ssh-key <path> | SSH özel anahtarının yolu (örn. ~/.ssh/id_rsa) | Hayır | - |
--renet-path <path> | Renet ikili dosyasının yolu (varsayılan: PATH'te renet) | Hayır | - |
--master-password <password> | Kaynakları bir ana şifreyle şifreleyin | Hayır | - |
--server <url> | Hesap sunucusu URL'si | Hayır | - |
1.3 list
Tüm yapılandırma dosyalarını listeleyin
rdc config list
1.4 show
Geçerli yapılandırma ayrıntılarını gösterin
rdc config show [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--reveal | Hassas değerler için düz metni göster (yalnızca etkileşimli modda) | Hayır | - |
1.5 current
Etkin yapılandırmayı göster: ad, dosya, çözümlenmiş sunucu ve kanal, jeton durumu
rdc config current
1.6 delete
Bir yapılandırma dosyasını silin
rdc config delete <name>
1.7 set
Varsayılan bir değer belirleyin (takım, bölge, köprü)
rdc config set <key> <value>
1.8 clear
Varsayılanları temizleyin (tümü veya belirli bir anahtar)
rdc config clear [key]
1.9 recover
Yapılandırmayı yedek dosyasından (.bak) geri yükle
rdc config recover [name] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
1.10 ssh
SSH anahtar yapılandırmasını yönet
set
Geçerli yapılandırma için SSH anahtarını ayarla
rdc config ssh set [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--key <path> | SSH özel anahtar dosyasının yolu | Evet | - |
--embed | Yol saklamak yerine anahtar içeriğini yapılandırmaya göm | Hayır | - |
show
Geçerli SSH anahtar yapılandırmasını göster
rdc config ssh show
remove
Geçerli yapılandırmadan SSH anahtarını kaldır
rdc config ssh remove
1.11 remote
Uzak yapılandırma depolama bağlantısını yönet
enable
Bu yapılandırmayı uzak şifreli depolamaya bağla
rdc config remote enable [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--headless | Cihaz kodu akışını kullan (arayüzsüz sunucular için) | Hayır | - |
--password | Önceden hazırlanmış bir password slot ile headless kaydol (tarayıcısız) | Hayır | - |
--api-url <url> | Hesap sunucusu URL'si | Hayır | - |
--force | Farklı olan yerel içeriği onay almadan sunucu kopyasıyla değiştir | Hayır | - |
disable
Uzak depolamadan bağlantıyı kes ve yapılandırmayı yerel olarak kaydet
rdc config remote disable
status
Uzak bağlantı durumunu göster
rdc config remote status
refresh
Yapılandırmayı uzak depolamadan zorla yeniden al
rdc config remote refresh
1.12 field
İşaretçi adresli yapılandırma alan işlemleri (get/set/unset/rotate/list). /credentials/cfDnsApiToken gibi JSON Pointer (RFC 6901).
get
JSON Pointer ile tek bir yapılandırma değerini oku. --reveal olmadıkça hassas alanlar maskelenir (yalnızca insan).
rdc config field get [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--pointer <pointer> | Alana işaret eden JSON Pointer (örn. /credentials/cfDnsApiToken) | Evet | - |
--reveal | Hassas değerleri açık metin olarak göster (yalnızca etkileşimli TTY; denetlenir) | Hayır | - |
--digest | Değer yerine SHA-256 özetini yaz (ajanlarla paylaşmak için güvenli) | Hayır | - |
set
JSON Pointer konumuna yapılandırma değeri yaz. Hassas yollar --current gerektirir (bilgi kapısı).
rdc config field set [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--pointer <pointer> | Alana işaret eden JSON Pointer (örn. /credentials/cfDnsApiToken) | Evet | - |
--new <value> | Yeni değer ({, [, ", true/false/null veya sayı ile başlıyorsa JSON olarak ayrıştırılır) | Evet | - |
--current <value> | Mevcut açık metin değer — hassas yol değişikliklerinde gerekli (bilgi kapısı kanıtı) | Hayır | - |
unset
JSON Pointer konumundaki yapılandırma değerini sil. Hassas yollar --current gerektirir.
rdc config field unset [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--pointer <pointer> | Alana işaret eden JSON Pointer (örn. /credentials/cfDnsApiToken) | Evet | - |
--current <value> | Mevcut açık metin değer — hassas yol silmelerinde gerekli | Hayır | - |
rotate
Hassas bir değeri --current olmadan döndür. Yalnızca etkileşimli TTY; belirgin şekilde denetlenir.
rdc config field rotate [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--pointer <pointer> | Hassas alana işaret eden JSON Pointer (örn. /credentials/cfDnsApiToken) | Evet | - |
--new <value> | Yeni değer | Evet | - |
list
Kaydedilmiş tüm duyarlılık pointer şablonlarını türü ve commit/şifreleme politikasıyla listele.
rdc config field list [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--sensitive | Yalnızca hassas (genel olmayan) şablonları göster | Hayır | - |
1.13 edit
Aktif yapılandırmayı $EDITOR içinde redakte edilmiş JSONC yansıması olarak aç. Yalnızca insan; ajanlar reddedilir.
rdc config edit [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--reveal | Hassas değerleri açık metin olarak göster (yalnızca etkileşimli TTY; denetlenir) | Hayır | - |
--dump | Editörü açmak yerine mevcut yapılandırmayı JSONC olarak stdout'a yaz (salt okunur; redakte edildiğinde ajanlar için güvenli) | Hayır | - |
--apply <file> | Düzenlenmiş JSONC dosyasını uygula ($EDITOR başlatmayı atlar) | Hayır | - |
--current-secrets <file> | --apply için bilgi kapısında kullanılan pointer→eski açık metin eşlemesi JSON dosyası | Hayır | - |
--editor <cmd> | Editör komutu geçersiz kılma (git önceliğine uyar: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR) | Hayır | - |
1.14 audit
Yapılandırma denetim günlüğünü incele (~/.config/rediacc/audit.log.jsonl konumunda hash zincirli JSONL)
log
Son denetim girdilerini JSON olarak yaz
rdc config audit log [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--since <spec> | Yalnızca belirtilen zamandan sonraki girdileri göster (örn.: '24h', '7d', ISO zaman damgası) | Hayır | - |
--path <glob> | JSON Pointer glob'una göre filtrele (örn.: /credentials/*) | Hayır | - |
--actor <kind> | Aktör türüne göre filtrele (human|agent) | Hayır | - |
tail
Yazıldıkça yeni denetim girdilerini akıt (durdurmak için Ctrl+C)
rdc config audit tail
verify
Tüm denetim girdilerinde SHA-256 hash zincirinin bütünlüğünü doğrula
rdc config audit verify
1.15 reconcile
Çalışma zamanı durumunu makinelerin gerçek durumundan yeniden kurar. Eski bağlama ve yönlendirme verilerini düzeltir.
rdc config reconcile [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--machine <m...> | Uzlaştırmayı bu makinelerle sınırla | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
--accept-observed | Bildirilen bir yerleşimi, imajın gerçekte bulunduğu yere uyacak şekilde yeniden yazar, ancak yalnızca bu belirsizlik içermediğinde (tam olarak bir makinede gözlemlendiğinde) yapar. Kopyalar çakışma olarak kalır. | Hayır | - |
1.16 rotate-cek
Kuruluşun yapılandırma şifreleme anahtarını döndür
rdc config rotate-cek [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--api-url <url> | Hesap sunucusu URL'si | Hayır | - |
2. Veri deposu yönetimi
Depoları barındıran adlandırılmış depolama havuzları. Bir veri deposu taşınabilir (bir makineye bağlayın, başka birine taşıyın) ve tek bağlayıcılıdır (aynı anda yalnızca bir makine tutar). Her makinedeki örtük varsayılan veri deposu burada yönetilmez.
2.1 resize
Bir veri deposunu büyüt veya küçült. Bu çevrimdışı bir işlemdir: içindeki depoların durdurulmuş olması gerekir.
rdc datastore resize <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--size <size> | Yeni boyut (örn. 200G) | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.2 fork
Bir veri deposunu copy-on-write ile çatalla. Çatallama anında gerçekleşir ve maliyeti havuzun boyutuyla artmaz. rbd arka ucunu gerektirir: local bir veri deposunun blok düzeyinde klonu yoktur, bu yüzden içindeki depolar bunun yerine reflink ile teker teker çatallanır (rdc repo fork).
rdc datastore fork <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--tag <tag> | Fork için etiket (sonuç ad:etiket olur) | Evet | - |
--attach-to <machine> | Fork'u hemen bu makineye bağla (--writes gerektirir) | Hayır | - |
--writes <disposition> | Fork'un yazmalarının nereye gideceği: local (anında, geçici) veya ceph (kalıcı klon) | Hayır | - |
--cow-size <size> | --writes local için overlay boyutu | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.3 status
Tek bir veri deposunu göster: arka ucu, bağlantısı, kullanımı, depoları ve anlık görüntüleri. Ayrık bir veri deposu bile kaydını raporlamaya devam eder.
rdc datastore status <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.4 create
Bir makinede ek, adlandırılmış bir veri deposu oluştur. Local arka uç, o makinede dosya tabanlı bir havuzdur ve orada kalır. rbd arka ucu Ceph içinde yaşar, bu yüzden aynı kümeye erişen herhangi bir makineye taşınabilir. Onu kubernetes dünyasına ait bir veri deposu yapmak için --cluster geçirin; bu referans oluşturulduğunda sabitlenir.
rdc datastore create <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Veri deposunun oluşturulacağı makine | Evet | - |
--size <size> | Veri deposu boyutu (örn. 100G) | Evet | - |
--backend <type> | Depolama arka ucu: local (dosya tabanlı, bu makinede kalır) veya rbd (Ceph, taşınabilir) | Hayır | local |
--pool <name> | rbd arka ucu için Ceph havuzu (varsayılan: rbd) | Hayır | - |
--image <name> | rbd arka ucu için RBD imaj adı (varsayılan: veri deposu adı) | Hayır | - |
--cluster <name> | Bu veri deposunun ait olduğu Kubernetes kümesi. Ayarlanmışsa yalnızca kubernetes depoları; ayarlanmamışsa yalnızca docker depoları anlamına gelir. Oluşturulduğunda sabitlenir. | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.5 list
Adlandırılmış veri depolarını, nereye bağlı olduklarını ve neyi barındırdıklarını listele.
rdc datastore list [place]
2.6 attach
Bir veri deposunu bir makineye bağla. Bir veri deposunu aynı anda yalnızca bir makine tutar, bu yüzden başka bir yere bağlamak onu taşır: eski sahip önce bırakır ve başarısız bir aktarım orijinal bağlantıyı bozulmadan bırakır. Bir fork'un yazmalarının nereye gideceğini belirtmesi gerekir.
rdc datastore attach <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--to <machine> | Veri deposunun bağlanacağı makine | Evet | - |
--writes <disposition> | Bir fork'un yazmalarının nereye gideceği: local (anında, geçici, ayrılınca kaybolur) veya ceph (havuzda kalıcı klon). Bir fork için zorunludur. | Hayır | - |
--cow-size <size> | --writes local için overlay boyutu | Hayır | - |
--no-auto | Bu veri deposunu önyüklemede otomatik olarak yeniden bağlama | Hayır | - |
--force | Veri deposunu düzgün bırakmayan eski sahibi zorla ayır | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.7 detach
Bir veri deposunu makinesinden ayır. İçindeki depolar önce durdurulur. --writes local ile bağlanmış bir fork'un overlay'ini geri yazacağı bir yer yoktur, bu yüzden ayırmak overlay'i atar ve --discard gerektirir.
rdc datastore detach <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--discard | Local yazmalı bir fork'u ve overlay'ini at. Veriler kurtarılamaz. | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.8 snapshot
Bir veri deposunun belirli zaman noktası anlık görüntülerini al ve listele. Bir anlık görüntü boştayken hiçbir şeye mal olmaz ve bir fork'un klonlandığı kaynaktır.
create
Bir veri deposunun belirli bir zaman noktasındaki anlık görüntüsünü al. Hiçbir şey durmaz. Bu an çökme tutarlıdır (crash-consistent), uygulama tutarlı (application-consistent) değildir: belirli bir yazmanın anlık görüntüde yer alması gerekiyorsa, önce onu senkronize edin.
rdc datastore snapshot create <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--snapshot <label> | Anlık görüntü etiketi (varsayılan: bir UTC zaman damgası) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
list
Bir veri deposunun anlık görüntülerini listele.
rdc datastore snapshot list <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
2.9 delete
Bir veri deposunu ve içindeki her şeyi yok et. Önce ayrılır; düzgün ayrılamazsa, bağlı bir havuzu sahipsiz bırakmak yerine silme işlemi başarısız olur.
rdc datastore delete <datastore> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
--force | Hâlâ ona işaret eden depolar olsa bile sil. Verileri onunla birlikte gider. | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3. Makine Yönetimi
Uzak makine durumunu incele: sistem kaynakları, çalışan konteynerler, systemd servisleri, dağıtılmış depolar ve sağlık tanılaması. Salt okunur sorgulardır; depoları değiştirmek için `repo` kullanın. Temel alt komutlar: status (--system, --containers, --repositories, --services ile daraltılan tam durum), health, list, add, remove, setup, prune, provision, deprovision.
3.1 list
Makineleri listeleyin
rdc machine list [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--search <text> | {{field}} içinde ara | Hayır | - |
--sort <field> | Alana göre sırala | Hayır | - |
--desc | Azalan sırada sıralayın | Hayır | - |
3.2 health
CI/CD pipeline'ları için makine sağlığını kontrol edin
Health komutu sistem metriklerini, konteyner durumunu, servis kararlılığını ve depolama bilgilerini çıktılar — CI/CD hattı kontrolleri için kullanışlıdır.
rdc machine health <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-t, --team <name> | Takım adı | Hayır | - |
3.3 provision
OpenTofu kullanarak bir bulut sağlayıcıda yeni makine oluştur
rdc machine provision <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--provider <name> | Bulut sağlayıcı adı (machine provider add'dan) | Evet | - |
--region <region> | Varsayılan bölgeyi geçersiz kıl | Hayır | - |
--type <type> | Varsayılan örnek türünü geçersiz kıl | Hayır | - |
--image <image> | Varsayılan işletim sistemi imajını geçersiz kıl | Hayır | - |
--ssh-user <user> | Yeni VM için SSH kullanıcı adı (varsayılan: root) | Hayır | - |
--base-domain <domain> | Altyapı için temel alan adı (ör. example.com). --infra'yı içerir | Hayır | - |
--no-infra | Altyapı yapılandırmasını atla (proxy + DNS) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.4 deprovision
Bulutta oluşturulan makineyi yok et ve yapılandırmadan kaldır
rdc machine deprovision <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--force | Onay istemini atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.5 prune
Bir makineden sahipsiz veri deposu kaynaklarını ve eski anlık görüntüleri kaldır
rdc machine prune <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Değişiklik yapmadan nelerin kaldırılacağını göster | Hayır | - |
--orphaned-repos | Makinedeki, yerel CLI yapılandırmanızda bulunmayan her depo görüntüsünü sil. Kaba bir davranıştır — renet aynası onları fork olarak doğru şekilde tanısa bile, yerel yapılandırma girişi olmayan ve başka araçlarca oluşturulmuş forkları da kaldırır. Aynayı dikkate alan daha dar kapsamlı davranış için --prune-unknown kullanın. | Hayır | - |
--prune-unknown | Sadece renet .interim/state aynasının sınıflandıramadığı depoları sil (yerel yapılandırmada yok VE fork işaretli ayna yok). --orphaned-repos seçeneğinden kesinlikle daha dardır: ayna onları tanımladığında yapılandırması olmayan fork'lar korunur. Pre-mirror eski yetimler ve yapılandırma girişi silinmiş eski grands ikisi de bu kovaya düşer. | Hayır | - |
--force-delete-mounted | Bağlama güvenlik ön kontrolünü geçersiz kıl ve şu anda bağlı olsalar veya çalışan Docker konteynerleri olsalar bile depoları sil. --force seçeneğinden farklıdır (yalnızca arşiv erteleme süresini geçersiz kılar). Hem --orphaned-repos hem de --prune-unknown seçeneklerine uygulanır. | Hayır | - |
--force | Onay istemlerini atla | Hayır | - |
--grace-days <days> | Son arşivlenen depolar için gün cinsinden ek süre (varsayılan: 7) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.6 add
Mevcut yapılandırmaya makine ekle
rdc machine add <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--ip <address> | Makine IP adresi veya ana bilgisayar adı | Evet | - |
--user <username> | SSH kullanıcı adı | Evet | - |
--port <port> | SSH bağlantı noktası | Hayır | 22 |
3.7 infra
Altyapı yapılandırmasını yönet (proxy, DNS, sertifikalar)
cert
Önbelleğe alınmış TLS sertifikalarını yönet
Sertifika önbelleğini kaldır
rdc machine infra cert clear
Bir makineden TLS sertifikalarını indir ve önbelleğe al
rdc machine infra cert pull <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--no-prune | Eski ağ kimliği sertifikalarının temizliğini atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
Önbelleğe alınmış TLS sertifikalarını bir makineye yükle
rdc machine infra cert push <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
Önbelleğe alınmış sertifika envanterini göster
rdc machine infra cert status
push
Altyapı yapılandırmasını makineye gönderin (Traefik proxy, yönlendirici, Cloudflare DNS). Önce 'machine infra set <machine>' çalıştırın
rdc machine infra push <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
set
Makine için altyapı yapılandırmasını ayarlayın (makineye özel: IP'ler, alan adı, portlar; paylaşılan: sertifika e-postası, CF DNS belirteci)
rdc machine infra set <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--public-ipv4 <ip> | Genel IPv4 adresi (makine başına) | Hayır | - |
--public-ipv6 <ip> | Genel IPv6 adresi (makine başına) | Hayır | - |
--base-domain <domain> | Uygulamalar için temel alan adı (makine başına) | Hayır | - |
--cert-email <email> | TLS sertifika bildirimleri için e-posta (makineler arasında paylaşılır) | Hayır | - |
--cf-dns-token <token> | ACME DNS-01 doğrulaması için Cloudflare DNS API anahtarı (makineler arasında paylaşılır) | Hayır | - |
--tcp-ports <ports> | Yönlendirilecek TCP portları (virgülle ayrılmış, örn., 25,143,465) | Hayır | - |
--udp-ports <ports> | Yönlendirilecek UDP portları (virgülle ayrılmış, örn., 53) | Hayır | - |
show
Bir makine için altyapı yapılandırmasını göster
rdc machine infra show <machine>
3.8 provider
Otomatik makine oluşturma için bulut sağlayıcıları yönet
add
Bulut sağlayıcı ekle
rdc machine provider add <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--provider <source> | Bilinen sağlayıcı kaynağı (örn., linode/linode, hetznercloud/hcloud) | Hayır | - |
--source <source> | Özel OpenTofu sağlayıcı kaynağı (örn., vultr/vultr) | Hayır | - |
--token <token> | Bulut sağlayıcı için API anahtarı | Evet | - |
--region <region> | Yeni makineler için varsayılan bölge | Hayır | - |
--type <type> | Varsayılan örnek türü/boyutu | Hayır | - |
--image <image> | Varsayılan işletim sistemi imajı | Hayır | - |
--ssh-user <user> | Yeni VM'ler için SSH kullanıcı adı (varsayılan: root) | Hayır | - |
--resource <type> | Özel: VM için OpenTofu kaynak türü | Hayır | - |
--label-attr <attr> | Özel: VM etiketi için öznitelik adı | Hayır | - |
--region-attr <attr> | Özel: bölge için öznitelik adı | Hayır | - |
--size-attr <attr> | Özel: örnek türü için öznitelik adı | Hayır | - |
--image-attr <attr> | Özel: işletim sistemi imajı için öznitelik adı | Hayır | - |
--ipv4-output <attr> | Özel: IPv4 adresi için çıktı özniteliği | Hayır | - |
--ipv6-output <attr> | Özel: IPv6 adresi için çıktı özniteliği | Hayır | - |
--ssh-key-attr <attr> | Özel: SSH anahtarları için öznitelik adı | Hayır | - |
--ssh-key-format <format> | Özel: SSH anahtar biçimi (inline_list veya resource_id) | Hayır | - |
--ssh-key-resource <type> | Özel: SSH anahtarları için OpenTofu kaynak türü | Hayır | - |
list
Yapılandırılmış bulut sağlayıcıları listele
rdc machine provider list
remove
Bulut sağlayıcı yapılandırmasını kaldır
rdc machine provider remove <name>
3.9 remove
Mevcut yapılandırmadan makine kaldır
rdc machine remove <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
--force | Depolar hâlâ üzerinde yerleşikken bile makineyi kaldır, bu yerleşimleri askıda bırak. | Hayır | - |
3.10 scan-keys
Mevcut yapılandırmadaki makineler için SSH ana bilgisayar anahtarlarını tara
rdc machine scan-keys [name]
3.11 setup
Uzak makineyi depolar için hazırla (renet kurar, Docker yapılandırır, BTRFS veri deposu). Tekrarlanabilir. config machine add sonrası ve repo create öncesi gereklidir
rdc machine setup <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--datastore-path <path> | Uzak makinedeki veri deposu yolu | Hayır | /mnt/rediacc |
--datastore-size <size> | Veri deposu boyutu (ör.: 95%, 100G) | Hayır | 95% |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.12 status
Tam makine durumunu göster (sistem, depolar, konteynerler, servisler)
rdc machine status [name] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--system | Yalnızca sistem bilgilerini dahil et | Hayır | - |
--repositories | Yalnızca depoları dahil et | Hayır | - |
--containers | Yalnızca konteynerleri dahil et | Hayır | - |
--services | Yalnızca servisleri dahil et | Hayır | - |
--network | Yalnızca ağ arayüzlerini dahil et | Hayır | - |
--block-devices | Yalnızca blok aygıtları dahil et | Hayır | - |
--licenses | Depo lisans durumlarını dahil et | Hayır | - |
--storage-health | Depo başına BTRFS parçalanma ve reflink tasarruflarını göster | Hayır | - |
--datastores | Bağlı veri depolarını göster (bağlama, ekleme, kullanım) | Hayır | - |
--health-check | Sağlık kontrolü modu - sağlıksız varsa kod 2 ile çıkar | Hayır | - |
--stability-check | Kararlılık kontrolü modu - başarısız/yeniden başlayan varsa kod 2 ile çıkar | Hayır | - |
--search <text> | Depoları ada göre filtreleyin | Hayır | - |
--sync-certs | Sorgu sonrasında makineden ACME sertifika önbelleğini de çek | Hayır | - |
--strict | Herhangi bir konteyner sağlık sapma eşiğini aştıysa sıfır olmayan kodla (kod 2) çık | Hayır | - |
4. Küme Yönetimi
Kümeleri hazırla ve yönet: özel bir ağ üzerinde adlandırılmış düğüm havuzu kümeleri (ceph, k8s-server, k8s-agent, hyperconverged). Havuz üyeleri makinelere dönüşür, bu nedenle her -m komutu bunlar üzerinde çalışır.
4.1 create
Bir kümeyi tanımlayın ve hazırlayın: makineler, Ceph havuzları ve Kubernetes. Tek adımda tanımlamak için --provider ve --pool geçirin; seçeneksiz bir create, zaten tanımlanmış bir kümeyi hazırlar.
rdc cluster create <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--provider <provider> | Sağlayıcı: bir cloudProviders anahtarı veya 'kvm' | Hayır | - |
--pool <spec...> | Havuz belirtimi ad:rol:sayı[:boyut] (rol: ceph|k8s-server|k8s-agent|hyperconverged) | Hayır | - |
--declare-only | Kümeyi hazırlamadan yalnızca yapılandırmaya kaydet | Hayır | - |
--network-cidr <cidr> | Özel ağ CIDR'i (ör. 10.0.0.0/24) | Hayır | - |
--network-primitive <primitive> | Ağ ilkeli (ör. vlan, vpc, network) | Hayır | - |
--control-node <machine> | Açık kontrol düğümü makinesi (varsayılan: ilk k8s-server üyesi) | Hayır | - |
--net-name <name> | KVM: bu küme için libvirt ağı (ör. renet12) | Hayır | - |
--net-base <prefix> | KVM: ağ öneki, ilk üç oktet (ör. 192.168.112) | Hayır | - |
--net-offset <n> | KVM: adresini türetirken her VM id'sine eklenen ofset | Hayır | - |
--control-id <n> | KVM: kontrol ve registry düğümünün VM id'si (varsayılan: 1) | Hayır | - |
--docker-registry <endpoint> | KVM: bu küme için VM içindeki Docker registry uç noktası | Hayır | - |
--ssh-user <user> | Hazırlanan üyeler için SSH kullanıcısı | Hayır | - |
--base-domain <domain> | Kümenin genel DNS'i için temel alan adı (aksi takdirde bir kardeş makineden devralınır) | Hayır | - |
--control-ds-size <size> | Çapa kontrol veri deposu boyutu (varsayılan 10G) | Hayır | - |
--control-ds-backend <backend> | Çapa kontrol veri deposu arka ucu: local | ceph (varsayılan: kümede ceph varsa ceph, yoksa local) | Hayır | - |
--control-ds-pool <pool> | Çapa kontrol veri deposu için Ceph rbd havuzu (ceph arka ucu) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.2 status
Tüm kümeleri listeler veya --name ile bir kümenin tam yapılandırmasını gösterir.
rdc cluster status [cluster]
4.3 scale
Bir havuzun üye sayısını değiştirir (makine ekler/kaldırır ve düğümleri katılır/boşaltır). k8s-agent havuzları yerinde ölçeklenir; ceph havuzunun büyümesi doğrudan cephadm aracılığıyla yapılır.
rdc cluster scale <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--pool <pool> | Havuz adı | Evet | - |
--count <n> | İstenen üye sayısı | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.4 destroy
Hazırlanmış üyeleri kaldırır ve kümeyi ile makinelerini yapılandırmadan çıkarır.
rdc cluster destroy <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--force | Onayı atla ve kaldırma hatalarına rağmen devam et | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.5 kubeconfig
Kubeconfig'i küme kontrol düğümünden SSH üzerinden alır ve kubectl için yerel olarak (0600) önbelleğe kaydeder.
rdc cluster kubeconfig <cluster>
4.6 fork
Depolarının verileri dahil olmak üzere tüm bir kümeyi yeni bir kümeye klonlar: küme ve PV imajlarının koordineli copy-on-write'ı, ardından fork'un yeni adreslerde ayağa kalkması için düğüm kimliğinin yeniden yazılması. Ebeveyn çalışmaya devam eder.
rdc cluster fork <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--tag <tag> | Fork etiketi | Evet | - |
--to <dest-cluster> | Fork'u barındıracak düğümlere sahip hedef küme (kontrol düğümü ve agent'ları; bir küme kendi makinelerine fork'lanamaz, çünkü iki k3s aynı ana bilgisayar ağ ad alanını paylaşamaz) | Evet | - |
--writes <disposition> | Fork yazma düzeni: local (geçici dm-COW overlay, Ceph üzerinde sıfır ayak izi) | ceph (kalıcı klon). Varsayılan local | Hayır | - |
--up | Fork'lanan depoları ayağa kaldır ve fork ayağa kalktıktan sonra küme sağlığını kontrol et | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.7 migrate
Depolarının verileri dahil olmak üzere tüm bir kümeyi, kısa bir kesinti süresiyle (sıcak ön kopya, ardından hedefte durdur-ve-yeniden-başlat) başka bir makineye veya veri merkezine taşır.
rdc cluster migrate <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--to <dest-cluster> | Hedef | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.8 join
Var olan kayıtlı bir makineyi, çapalama (anchor) ve yeniden katılmada (rejoin) kullanılanla aynı CA kökenli katılım jetonunu kullanarak kümenin bir Kubernetes ajan düğümü olarak sahiplen.
rdc cluster join <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--cluster <name> | Makinenin katılacağı küme | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.9 evict
Düğümü boşalt, Node nesnesini sil ve küme üyeliğini temizle. Küme, makineden türetilir; hâlâ bir veri deposu bağlı olan makine reddedilir.
rdc cluster evict <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--force | Düğüm zaten ölüyse boşaltmayı atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.10 rehearse
Bir sürüm/yükseltmeyi prova et: kümeyi bir hedefe geçici, atılabilir bir kopya olarak fork'la (writes=local, sırsız role=rehearsal), ayağa kaldır, sağlık kontrolünden geçir, ardından at. Ebeveyne asla dokunulmaz.
rdc cluster rehearse <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--on <dest-cluster> | Kullan-at provanın ayağa kaldırılacağı hedef küme | Evet | - |
--tag <tag> | Prova fork'u için isteğe bağlı etiket (varsayılan: zaman damgalı) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
4.11 snapshot
Kümenin tamamının belirli bir zaman noktasındaki anlık görüntüleri. Kümenin sahip olduğu her rbd tabanlı veri deposunda, Ceph'in grup anlık görüntüsü aracılığıyla alınan tek bir çökme tutarlı (crash-consistent) an: hiçbir şey durmaz ve küme bunu fark etmez. Local arka uçlu veri depolarının blok düzeyinde bir grup ilkesi yoktur, bu yüzden bu anın dışında kalır ve öyle raporlanır. Bu an çökme tutarlıdır (crash-consistent), uygulama tutarlı (application-consistent) değildir: belirli bir yazmanın anlık görüntüde yer alması gerekiyorsa, önce onu senkronize edin.
create
Kümedeki rbd tabanlı her veri deposunun anlık görüntüsünü TEK bir anda alır. Hiçbir şey durdurulmaz. Kümedeki local arka uçlu veri depoları bu anın dışında listelenir: anlık görüntünün parçası değildir. Bu an çökme tutarlıdır (crash-consistent), uygulama tutarlı (application-consistent) değildir: belirli bir yazmanın anlık görüntüde yer alması gerekiyorsa, önce onu senkronize edin.
rdc cluster snapshot create <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--snapshot <label> | Anlık görüntü etiketi (varsayılan: bir UTC zaman damgası) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
list
Kümenin grup anlık görüntülerini listele.
rdc cluster snapshot list <cluster> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
5. MCP Sunucusu
Yapay zeka agentları için Model Context Protocol sunucusu
5.1 serve
MCP sunucusunu başlat (stdio aktarımı)
rdc mcp serve [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--config <name> | Tüm komutlar için kullanılacak yapılandırma adı | Hayır | - |
--timeout <ms> | Milisaniye cinsinden varsayılan komut zaman aşımı | Hayır | 120000 |
6. Depo Yaşam Döngüsü
Makinelerde şifreli depoları dağıt ve yönet. Temel alt komutlar: create, up (dağıt), down (durdur), fork (anında CoW klonu), delete, push/pull (yedekleme), sync (dosya aktarımı). Yaşam döngüsü: repo create → repo up → repo down. Mimari, yönlendirme ve ortam değişkeni ayrıntıları için rdc --help çıktısındaki Temel Kavramlar bölümüne bakın.
6.1 up
Bir depoyu dağıt veya güncelle (bağla, renet compose'u çağıran Rediaccfile up'ı çalıştır). Makine, referansın yerleşiminden belirlenir. Proxy rotalarının dağıtımdan sonra aktif hale gelmesi ~3 saniye sürer. Tamamlandığında HTTP ile açığa çıkan servisler için URL desenini yazdırır (rediacc.service_port etiketi). İlk dağıtım ve çatallar otomatik olarak bağlanır. CRIU checkpoint geri yüklemesi otomatik algılanır; temiz bir başlangıcı zorlamak için --skip-checkpoint kullanın. Bir makinedeki tüm depoları dağıtmak için --all --machine <m> kullanın.
rdc repo up [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--no-start | up() adımlarını çalıştırmadan depoyu bağla ve hazırla (kullanımdan kaldırılan 'repo mount' komutunu içerir; LUKS açma ve küme depoları için PV üretimi). | Hayır | - |
--skip-checkpoint | Checkpoint verileri mevcut olsa bile CRIU checkpoint geri yüklemesini atla (temiz başlatmayı zorla) | Hayır | - |
--tls | Bu depo için özel TLS sertifikası talep et (fork'lar varsayılan olarak paylaşılan makine sertifikasını kullanır) | Hayır | - |
--no-wait | Konteynerler başlar başlamaz dön; sağlık kontrolleri arka planda devam eder | Hayır | - |
--all | Barındığı yer --machine olan tüm depoları dağıt (toplu biçim) | Hayır | - |
-m, --machine <name> | --all ile birlikte: toplu işlemin uygulanacağı depolara sahip makine | Hayır | - |
--include-forks | Çatallanmış depoları da bağla/başlat | Hayır | - |
--parallel | Depoları eş zamanlı başlat | Hayır | - |
--concurrency <n> | Maksimum eş zamanlı depo sayısı (varsayılan: 3) | Hayır | 3 |
-y, --yes | Toplu işlemler için onayı atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
6.2 down
Depo Docker konteynerlerini durdur (renet compose aracılığıyla Rediaccfile down çalıştırır). Makine, referansın yerleşiminden belirlenir. Şifreli birimi AYIRMAZ: depo bağlı kalır ve 'repo up' ile yeniden başlatılabilir. Durdurduktan sonra LUKS konteynerini de kapatmak için --unmount kullanın (kullanımdan kaldırılan 'repo unmount' komutunu içerir). Durdurmadan önce CRIU süreç durumunu kaydetmek için --checkpoint kullanın (bir sonraki 'repo up' otomatik olarak geri yükler). Bir makinedeki tüm depoları durdurmak için --all --machine <m> kullanın.
rdc repo down [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--unmount | Durdurduktan sonra ayrıca ayır (LUKS konteynerini kapat). 'repo resize' öncesinde veya birimi tamamen güvence altına almak için zorunludur | Hayır | - |
--checkpoint | Durdurmadan önce CRIU checkpoint oluştur (işlem bellek durumunu 'repo up' ile geri yüklemek üzere kaydet) | Hayır | - |
--all | Barındığı yer --machine olan tüm depoları durdur (toplu biçim) | Hayır | - |
-m, --machine <name> | --all ile birlikte: toplu işlemin uygulanacağı depolara sahip makine | Hayır | - |
--parallel | Depoları eş zamanlı başlat | Hayır | - |
--concurrency <n> | Maksimum eş zamanlı depo sayısı (varsayılan: 3) | Hayır | 3 |
-y, --yes | Toplu işlemler için onayı atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
6.3 status
Depo durumunu al
rdc repo status <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.4 cat
Depo içindeki bir dosyanın sınırlı bir penceresini oku ve stdout'a yaz (sunucu tarafında sınırlı; tanılama bilgileri stderr'e gider)
rdc repo cat <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--remote-file <path> | Okunacak dosya yolu, depo bağlama köküne göreli | Evet | - |
--max-bytes <n> | Okunacak ve yazdırılacak maksimum bayt sayısı (varsayılan 1 MiB, üst sınır 50 MiB) | Hayır | - |
--offset <n> | Okumaya başlanacak bayt ofseti | Hayır | - |
--head <lines> | Yalnızca ilk N satırı yazdır (bayt aralığıyla birleştirilemez) | Hayır | - |
--tail <lines> | Yalnızca son N satırı yazdır (bayt aralığıyla birleştirilemez) | Hayır | - |
--stat | Yalnızca boyut, tür ve değiştirme zamanını yazdır; içerik okuma | Hayır | - |
--force-binary | İkili (NUL içeren) içeriğin okunmasına izin ver | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.5 diff
Kopyala-yazma ile forklanmış iki depo arasında git tarzı dosya seviyesinde diff. Eklenen, değiştirilen, silinen ve yeniden adlandırılan dosyaları raporlar. --name ile verilen depoyu (hedef / yeni taraf) yerel yapılandırmadan çözülen ebeveyniyle veya açık bir --base deposu ile (taban / eski taraf) karşılaştırır. Yalnızca üst veri ve boyuttan bağımsız: şifreli LUKS imajlarını şifre çözmeden blok seviyesinde karşılaştırır; bu sayede 1 GB ve 100 GB depo aynı milisaniyelerde karşılaştırılır.
rdc repo diff <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--base <ref> | Karşılaştırılacak depo (taban / eski taraf); varsayılan olarak --name ebeveyni | Hayır | - |
--name-only | Yalnızca değişen dosya yollarını her satıra bir tane yaz (durum harfleri olmadan) | Hayır | - |
--stat | Dosya başına değişim büyüklüğünü (bayt ve blok delta'ları) ve toplamları göster | Hayır | - |
--content [path] | Tek bir dosya için birleşik metin diffi göster (dosya yolu gerekir) | Hayır | - |
--fast | Blok filtresine güven; içerik hash onayını atla ("Değiştirildi" sayısı abartılı olabilir) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.6 list
Bir makinedeki depoları listele
rdc repo list [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Hayır | - |
--datastore <name> | Bu veri deposundaki depoları listele (şu anda onu tutan makineye göre çözümlenir) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.7 create
Yeni bir depo oluştur. Barınacağı yeri bir kez belirtin: bir makine veya bir veri deposu.
rdc repo create <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Hayır | - |
--datastore <name> | Depoyu barındıran adlandırılmış veri deposu (docker katmanlaması veya küme biçimi) | Hayır | - |
--size <size> | Depo boyutu (ör. 10G, 100G, 1T) | Hayır | - |
--no-docker | Oluşturmadan sonra Docker daemon'ı başlatmayı atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.8 delete
Bir depoyu ve verilerini sil. Yapılandırma girişi korunur; kimlik bilgilerini 'repo admin archive restore' ile kurtarmak üzere deletedRepositories'e taşımak için --archive-config kullanın. Konumsal bir <ref> alır; yalnızca bir ad, grand hatta çözümlenir ve birden fazla depo aynı taban adı paylaştığında reddedilir, bu yüzden bir fork'u hedeflemek için ad:etiket geçirin.
rdc repo delete <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--archive-config | Yapılandırma girdisini daha sonra kurtarmak için deletedRepositories'e taşı | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
6.9 commit
Bağlı (mounted) bir çalışan fork'un mevcut durumunu yeni, değişmez bir commit olarak dondurun (git tarzı). Commit; mesajını, yazarını, zaman damgasını ve üst öğesini birim içinde (in-volume) kaydeder (böylece push sırasında birlikte taşınır) ve salt okunur olarak işaretlenir — mount edilmeyi reddeder. Çalışan fork, git'in çalışma ağacını olduğu gibi bırakması gibi değişmeden devam eder. Yazılabilir bir kopya elde etmek için bir commit'i 'rdc repo checkout' ile checkout edin.
rdc repo commit <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--message <msg> | Commit mesajı | Evet | - |
--author <author> | Commit yazarı | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.10 branch
Çalışan fork'un mevcut commit'ini (ucunu) gösteren, adlandırılmış bir branch ref'i oluşturun. Branch ref'leri CLI yapılandırmasında bulunur (machine = nesne deposu, config = ref deposu).
rdc repo branch <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--branch <branch> | Yeni dalın adı | Evet | - |
6.11 checkout
Değişmez bir commit'i (veya bir branch ucunu) yeni, yazılabilir bir çalışan fork'a reflink ile klonlayın ve HEAD'i ona yöneltin. Neredeyse anlık ve sabit zamanlı (BTRFS reflink).
rdc repo checkout <commit-or-branch-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--tag <name> | Yeni yazılabilir çalışan fork için ad | Evet | - |
--from <workingFork> | Konumsal <commit-or-branch-ref> değerini bu çalışma çatalındaki bir dal adı olarak çöz | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.12 log
Bir çalışan fork'un mevcut commit'inden (veya bir commit referansından) erişilebilen commit geçmişini, 'rdc repo commit' tarafından kaydedilen üst zinciri izleyerek yazdırın. Birim dışı (out-of-volume) yansımayı okur, bu yüzden hiçbir commit kilidi açılmaz.
rdc repo log <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.13 merge
Bir kaynak commit veya fork'u hedef çalışma fork'una merge eder. Canlı hedef yerinde asla değiştirilmez: sonuç bir reflink klonunda oluşturulur ve atomik olarak yerine takılır. Bağlı (mounted) veya çalışan bir hedef, --force kullanılmadıkça reddedilir; --force ise hedefi önce temiz biçimde durdurur. --resolve olmadan, tüm imaj üzerinde take-theirs uygulanır (hedef, kaynağın aynısı olur); --resolve ours|theirs ile, ortak ataya karşı dosya başına üç yönlü (three-way) merge yapılır; her tarafın benzersiz değişiklikleri alınır ve iki taraflı çakışmalar bayrağa göre çözülür.
rdc repo merge <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--from <source> | Merge için kaynak commit veya fork | Evet | - |
--force | Bağlı/çalışan hedefi önce durdurup ardından merge eder (canlı bir mount'u asla değiştirmez) | Hayır | - |
| `—resolve <ours | theirs>` | Üç yönlü birleştirme için dosya bazında çakışma çözümü: 'ours' hedefin sürümünü korur, 'theirs' kaynağınkini alır. Tüm imaj için fast-forward (take-theirs) yapmak istiyorsanız atlayın. | Hayır |
--base <guid> | three-way (üç yönlü) merge için ortak ata commit GUID'i (--resolve ile kullanılır). Varsayılan olarak kaynak commit'in ebeveyni veya hedefin mevcut commit'idir. | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.14 gc
Bir makinede hiçbir dalın veya HEAD'in erişemediği değişmez commit nesnelerini sil (erişilebilirlik GC'si). Makine nesne deposudur; CLI yapılandırması ref deposudur. Varsayılan olarak deneme çalıştırması yapar: silmek için --apply geçin. Bağlı bir nesneye veya çalışan bir fork'a asla dokunmaz.
rdc repo gc [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
--apply | Erişilemez commit'leri gerçekten sil (varsayılan, deneme çalıştırması önizlemesidir) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.15 fork
Bir deponun CoW (Copy-on-Write) çatalını oluştur. ÇATALLAMA, depo boyutundan bağımsız olarak NEREDEYSE ANINDA VE SABİT SÜRELİDİR: BTRFS reflink alttaki imajı klonlar, bu yüzden 100 GB'lık bir depo ile 1 GB'lık bir depo aynı ~saniyelerde çatallanır. Çatal YENİ bir GUID, networkId, IP aralığı ve otomatik yönlendirme alan adı alır ({service}-fork-{tag}.{repo}.{machine}.{baseDomain}) ve tamamen bağımsız bir kopyadır. Çevrimiçi çatallama desteklenir, ebeveyn çalışmaya devam edebilir. Çatal, ebeveynin şifreleme kimlik bilgilerini otomatik olarak devralır. Çatallamadan önce CRIU süreç durumunu yakalamak için --checkpoint kullanın, çatal ilk 'repo up' sırasında otomatik olarak geri yüklenir (bellek içi durum korunur). MAKİNELER ARASI ÇATALLAMA: önce yerel olarak çatallayın, sonra aktarın: (1) rdc repo fork <parent-ref> --tag <ad>, (2) rdc repo push <fork-ref> --to <hedef-makine>, (3) rdc backup restore <fork-ref> --as <fork-adı> -m <hedef-makine> --up. UYARI: çatallamak için yalnızca "repo push" kullanmayın, bu AYNI GUID ile ham bir kopya oluşturur (bağımsız bir çatal değil). Yeni bir kimlik elde etmek için her zaman önce çatallayın. Otomatik yönlendirmeler depo adını kullanır, bu yüzden her çatal otomatik olarak benzersiz bir alan adı alır.
rdc repo fork <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--tag <name> | Çatal için etiket (isim:etiket oluşturur) | Evet | - |
--checkpoint | fork öncesinde kaynakta CRIU checkpoint oluştur (fork üzerinde geri yükleme için işlem bellek durumunu yakala) | Hayır | - |
--immutable | Çatalı salt okunur olarak işaretler: bağlanmayı reddeder ve görüntüsünü kalıcı olarak bayt düzeyinde sabit tutar (makineler arası delta push için dondurulmuş bir commit/temel) | Hayır | - |
--up | Fork sonrası bağlayıp servisleri başlat (fork + mount + up tek komutta) | Hayır | - |
--no-wait | --up ile: konteynerler başlar başlamaz döner; sağlık kontrolleri arka planda devam eder (kullan-at çatallar için ideal) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.16 replicate
Veritabanı boyutundan bağımsız olarak, saniyeler içinde bir deponun N okuma replikasını oluştur. TEK bir veri deposu anlık görüntüsü alır, ardından kümenin düğümlerine yayılmış N adet sabit zamanlı fork-attach (copy-on-write, atılabilir yerel yazmalar) yapar ve üretilmiş bir overlay uygular: replika başına sabitlenmiş bir PersistentVolume, bir StatefulSet ve iki Service ({repo}-rw birincile, {repo}-ro replikalara). Replikalar BELİRLİ BİR ZAMAN NOKTASININ kopyalarıdır: replikasyon akışı yoktur, kendi yazdığını okuma garantisi (read-your-writes) yoktur; her replika hizmet vermeye başlamadan önce bir çökme kurtarma (crash-recovery) turu çalıştırır. Bunları 'repo replicate refresh' ile tazeleyin. Replika kümeleri yönetilen bir durumdur: 'repo replicate status' ile görüntüleyin, 'repo replicate remove' ile kaldırın.
status
Yönetilen replika kümelerini göster: replikalar, barındıran düğümler, fork veri depoları, anlık görüntü ve tazeleme zaman damgaları.
rdc repo replicate status <ref>
remove
Bir replika kümesini kaldır: üretilen k8s nesnelerini sil (etikete göre kapsamlı), fork veri depolarını at, anlık görüntüsünü düşür ve durumu unut. Altyapı adımları en iyi çaba (best-effort) esasına dayanır, böylece kaldırma işlemi kısmen kaybolmuş bir kümede bile sonuca ulaşır.
rdc repo replicate remove <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
refresh
Her replikayı taze bir zaman noktası anlık görüntüsüne, BİRER BİRER geçir: replika pod'unu yeniden başlat, veri deposunu aynı yol altında at ve yeniden fork'la, ardından hazır olma (readiness) kontrolünün onu yeniden kabul etmesine izin ver. Bu süreç boyunca N-1 replika hizmet vermeye devam eder.
rdc repo replicate refresh <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.17 canary
Kararlı imajın yanında YENİ bir imaj çalıştır ve canlı trafiği aralarında yüzdeyle böl (sürüm merdiveninin 2. basamağı). Aynı canlı veri üzerinde tek bir canary Deployment + Service oluşturur (fork yok: fork'lanmış veri üzerindeki canary kullanıcıları eski veri okur ve sonunda atılacak bir kopyaya yazardı) ve Rediacc proxy'sine, kararlı ana bilgisayar adının trafiğinin verilen yüzdesini buraya yönlendirmesini söyler. Ağırlık 0, canary'yi trafiksiz (dark) bırakır; ağırlık 100 blue/green geçişidir. Her canary değişikliğinden önce, evrensel geri alma olarak kümenin veri depolarının otomatik bir grup anlık görüntüsü alınır (sürüm merdiveninin 0. basamağı). İki sürüm arasındaki şema uyumluluğu (expand-contract) uygulamanın sorumluluğundadır. Şemayı BOZAN sürümler için bunun yerine blue/green kullanın: depoyu fork'layın (anında, veriyi de içerir), fork'un Service'ini buraya ağırlık 100 ile yönlendirin ve dokunulmamış ebeveyni yeniden başlatarak geri alın; geçişten sonra yapılan yazmalar yalnızca yeni kopyada var olur, bu yüzden geri alma penceresi bir politika kararıdır.
status
Yönetilen canary kümelerini göster: ağırlık, imajlar, kararlı service ve en son sürüm geri alma anlık görüntüsü.
rdc repo canary status <ref>
weight
Bir canary'ye yönlendirilen trafik yüzdesini değiştir. Önce taze bir sürüm geri alma grup anlık görüntüsü alır, ardından overlay'i yeniden uygular; proxy yeni bölüşümü bir sonraki yenileme turunda alır. Ağırlık 100, tüm trafiği yeni sürüme gönderir (blue/green geçişi).
rdc repo canary weight <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--weight <percent> | Canary'ye yönlendirilen trafik yüzdesi (0-100 arası tam sayı; 0 = devre dışı, 100 = tam geçiş) | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
remove
Bir canary'nin Deployment'ını ve Service'ini kaldır (etikete göre kapsamlı); kararlı Service yeniden %100'e hizmet verir. Sürüm geri alma anlık görüntüleri saklanır; bunları veri deposu anlık görüntü komutlarıyla temizleyin.
rdc repo canary remove <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
create
Kararlı imajın yanında YENİ bir imaj çalıştırın ve ona canlı trafiğin bir yüzdesini gönderin. Canary, deponun canlı verisini paylaşır (fork yok), bu yüzden iki sürüm arasındaki şema uyumluluğu uygulamanın sorumluluğundadır. Geri alma olarak önce kümenin veri depolarının bir grup anlık görüntüsü alınır.
rdc repo canary create <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--image <image> | Canary Deployment'ın çalıştıracağı yeni imaj (paylaşılan canlı veriye karşı) | Evet | - |
--port <port> | Uygulamanın hizmet verdiği port (kararlı Service ile eşleşmeli) | Evet | - |
--weight <percent> | Canary'ye yönlendirilen trafik yüzdesi (0-100 arası tam sayı; 0 = devre dışı, 100 = tam geçiş) | Evet | - |
--service <name> | Trafiği bölüştürülecek kararlı Service (varsayılan: depo adı) | Hayır | - |
--replicas <n> | Canary Deployment replika sayısı (varsayılan: 1) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.18 resize
Depoyu çevrimdışı yeniden boyutlandır (büyütme ve küçültme destekler)
rdc repo resize <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--size <size> | Yeni depo boyutu (ör. 10G, 100G, 1T) | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.19 expand
Bağlı depoyu çevrimiçi genişlet (sıfır kesinti)
rdc repo expand <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--size <size> | Yeni depo boyutu (ör. 10G, 100G, 1T) | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.20 trim
Bağlı depolardan datastore havuzuna alan geri kazandırır (çevrimiçi, kesintisiz). Depo içinde silinen bloklar fstrim ile havuza geri döner. Referans verilmezse -m üzerindeki bağlı tüm depolar ve veri deposunun kendisi trimlenir. Aktif yedeklemesi olan depolarda fstrim atlanır; --docker geri kazanımı yine de çalışır
rdc repo trim [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--docker | Docker alanını geri kazan (durmuş konteynerler, sahipsiz imajlar, derleme önbelleği); etkin bir yedek anlık görüntüsü sırasında bile çalışır | Hayır | - |
--docker-volumes | Ayrıca kullanılmayan Docker birimlerini temizle | Hayır | - |
--report-only | Trim yapmadan discard durumunu ve geri kazanılabilir tahmini göster | Hayır | - |
-m, --machine <name> | Hedef makine adı | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.21 policy
Makinenin depolama bakımcısının uyguladığı otomatik boyut politikasını yönetir: depo dolduğunda kotayı çevrimiçi büyütür (asla max-quota üzerine çıkmaz, havuz azaldığında büyütmez) ve planlı trimler çalıştırır. Otomatik küçültme yoktur; bunun için 'repo resize' kullanın. Referans verilmezse -m üzerindeki makine geneli varsayılan politika hedeflenir
set
Boyut politikası alanlarını ayarlar. Yalnızca geçirdiğiniz bayraklar değişir; diğer kayıtlı alanlar değerlerini korur. Otomatik büyütmeyi etkinleştirmek --max-quota gerektirir: tavan, havuzun aşırı tahsisine verdiğiniz açık onaydır
rdc repo policy set [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--auto-grow <bool> | Otomatik çevrimiçi kota büyütmeyi etkinleştir (true/false) | Hayır | - |
--max-quota <size> | Otomatik büyütme tavanı (örn. 200G); otomatik büyütme için zorunlu | Hayır | - |
--grow-threshold <percent> | Büyümeyi tetikleyen dosya sistemi doluluk yüzdesi (varsayılan 85) | Hayır | - |
--grow-step <step> | Adım başına büyüme: mutlak (10G) veya kota yüzdesi (20%) | Hayır | - |
--auto-trim <bool> | Planlı trimi etkinleştir (true/false) | Hayır | - |
--trim-interval <hours> | Otomatik trimler arasındaki en az saat (varsayılan 24) | Hayır | - |
-m, --machine <name> | Hedef makine adı | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
get
Kayıtlı makine varsayılanını, depo geçersiz kılmasını (bir referansla) ve bakımcının uyguladığı birleşik etkin politikayı gösterir
rdc repo policy get [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.22 push
Depoyu uzak hedefe (makine veya depolama) gönder. Hedef türü yapılandırmadan otomatik algılanır. Makineler arası transferde şifrelenmiş depo görüntüsü aynı GUID ile kopyalanır — bu yedekleme/taşımadır, fork değildir. Bağımsız fork oluşturmak için önce 'repo fork' kullanın, sonra push yapın. Gönderilen kopya bir yedekleme artefaktı olarak iner: hedefte 'backup restore <ref> --as <name> -m <target> --up' ile önyükleyin
rdc repo push <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--to <remote> | Hedef makine veya depolama adı (yapılandırmadan otomatik algılanır) | Hayır | - |
--to-machine <machine> | — | Hayır | - |
--provision <provider> | Hedef makine yoksa bulut sağlayıcısı üzerinden otomatik olarak oluştur | Hayır | - |
--checkpoint | Yedekleme öncesi CRIU checkpoint oluştur (canlı taşıma için işlem bellek durumunu yakalar) | Hayır | - |
--force | Mevcut yedeğin üzerine yazmaya zorla | Hayır | - |
-w, --watch | Değişiklikleri izleyin | Hayır | - |
--bwlimit <limit> | rsync aktarımı için bant genişliği sınırı (ör. "6M", "10M") | Hayır | - |
--delta-base <guid> | Her iki makinede de bayt düzeyinde birebir bulunan değişmez temel GUID; yalnızca değişen blokları aktar (makine hedefi). Otomatik temel için boş bırakın | Hayır | - |
--strategy <strategy> | Delta temeli kullanırken blok-delta stratejisi: auto, physical veya shared | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.23 pull
Depoyu uzak kaynaktan (makine veya depolama) çek. Tüm depoları çekmek için adı atlayın. Kaynak türü yapılandırmadan otomatik algılanır. Pull sonrası dağıtım için --up kullanın
rdc repo pull <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--from <remote> | Kaynak makine veya depolama adı (yapılandırmadan otomatik algılanır) | Hayır | - |
--from-machine <machine> | — | Hayır | - |
--force | Mevcut deponun üzerine yazmaya zorla | Hayır | - |
--up | Pull sonrası bu makinede depoyu bağla ve dağıt | Hayır | - |
-w, --watch | Değişiklikleri izleyin | Hayır | - |
--bwlimit <limit> | rsync aktarımı için bant genişliği sınırı (ör. "6M", "10M") | Hayır | - |
--delta-base <guid> | Her iki makinede de bayt düzeyinde birebir bulunan değişmez temel GUID; yalnızca değişen blokları al (makine kaynağı) | Hayır | - |
--strategy <strategy> | Delta temeli kullanırken blok-delta stratejisi: auto, physical veya shared | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.24 migrate
Bir depoyu minimum kesinti süresiyle bir makineden diğerine canlı olarak taşır. İki aşamalı rsync: çalışırken toplu aktarım, ardından delta senkronizasyonu için kısa bir durdurma. Depoyu bütünüyle taşır (yönlendirme yeni konuma yeniden işaret eder) ve taşıma başarılı olduktan sonra kaynak imajları siler (korumak için --keep-source kullanın). Süreç bellek durumu taşıma için CRIU checkpoint'i ve hedef makinelerin otomatik provizyonlanmasını destekler
rdc repo migrate <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--to <place> | Hedef makine veya küme | Evet | - |
--provision <provider> | Bulut sağlayıcı aracılığıyla hedefi otomatik oluştur (ör. hetzner, linode) | Hayır | - |
--bwlimit <limit> | rsync aktarımı için bant genişliği sınırı (ör. 10M) | Hayır | - |
--checkpoint | CRIU canlı taşıma: süreç belleği durumunu yakala ve geri yükle | Hayır | - |
--delta-base <guid> | Geçiş deltası için değişmez temel GUID (gelişmiş; varsayılan olarak Aşama 1 temeli kullanılır) | Hayır | - |
--strategy <strategy> | Geçiş için blok-delta stratejisi: auto, physical veya shared | Hayır | - |
--skip-dns | Taşıma sonrası DNS kaydı geçişini atla | Hayır | - |
--keep-source | Başarılı bir taşımadan sonra kaynak imajları koru (varsayılan olarak silinirler; kalan kopyalar herhangi bir yapılandırma kaydıyla adreslenemez ve reconcile bunları başıboş olarak işaretler) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.25 sync
Depoları ve dosyaları senkronize et (toplu push/pull, dosya aktarımı)
upload
Depoya dosya yükle
rdc repo sync upload <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--local <paths...> | Bir veya daha fazla yerel dosya veya dizin yolu (varsayılan: geçerli dizin) | Hayır | - |
--remote <path> | Depo içinde uzak alt dizin yolu | Hayır | - |
--remote-file <path> | Yüklenecek tek uzak dosya yolu (depo köküne göre). --remote ile birlikte kullanılamaz. | Hayır | - |
--mirror | Ayna modu - yerel olarak bulunmayan uzak dosyaları silin | Hayır | - |
--verify | Senkronizasyondan sonra dosyaları sağlama toplamı kullanarak doğrulayın | Hayır | - |
--confirm | Değişiklikleri önizleyin ve senkronizasyondan önce onay isteyin | Hayır | - |
--exclude <patterns...> | Senkronizasyondan hariç tutulacak desenler | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
download
Depodan dosya indir
rdc repo sync download <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--local <path> | Yerel dizin yolu (varsayılan: güncel dizin) | Hayır | - |
--remote <path> | Depo içinde uzak alt dizin yolu | Hayır | - |
--remote-file <path> | Depodaki uzak dosya yolu (tek dosya aktarımları için --remote yerine kullanılır) | Hayır | - |
--mirror | Ayna modu - uzakta bulunmayan yerel dosyaları silin | Hayır | - |
--verify | Senkronizasyondan sonra dosyaları sağlama toplamı kullanarak doğrulayın | Hayır | - |
--confirm | Değişiklikleri önizleyin ve senkronizasyondan önce onay isteyin | Hayır | - |
--exclude <patterns...> | Senkronizasyondan hariç tutulacak desenler | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
status
Senkronizasyon durumunu kontrol et ve yerel/uzak dosyaları karşılaştır
rdc repo sync status <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--local <path> | Yerel dizin yolu (varsayılan: güncel dizin) | Hayır | - |
--remote <path> | Depo içinde uzak alt dizin yolu | Hayır | - |
--remote-file <path> | Depodaki uzak dosya yolu (tek dosya aktarımları için --remote yerine kullanılır) | Hayır | - |
6.26 tunnel
Uzak makinedeki bir konteynerin portuna SSH port yönlendirme tüneli oluştur. Belirsizlik yoksa konteyner ve port otomatik algılanır. Tünel Ctrl+C'ye basana kadar açık kalır
rdc repo tunnel <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-c, --container <name> | Konteyner adı (yalnızca biri çalışıyorsa otomatik algılanır) | Hayır | - |
--port <port> | Yönlendirilecek uzak konteyner portu | Hayır | - |
--local <port> | Yerel port (varsayılan: uzak port ile aynı) | Hayır | - |
--url-only | Tünel hazır olduğunda yalnızca yerel URL'yi yazdır (makine tarafından okunabilir) | Hayır | - |
6.27 secret
Dağıtım sırasında enjekte edilen depo başına sırları yönet. İki mod: env (compose ${VAR} enterpolasyonu ile REDIACC_SECRET_<KEY>) ve file (ana bilgisayarda tmpfs, /var/run/rediacc/secrets/<networkId>/<KEY>, Docker compose `secrets:` bloğu ile bağlanır). Sırlar hiçbir zaman şifreli LUKS imajına girmez, bu yüzden fork'lar hiçbirini miras almaz — dış sistemler fork'u farklı bir kimlik (principal) olarak görür.
get
Tek bir gizli anahtarı oku. Politikadan bağımsız olarak, aracı bağlamında redakte edilmiş bir stub döndürür (`<redacted:secret>:<digest8>`).
rdc repo secret get <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--key <KEY> | UPPER_SNAKE_CASE biçiminde gizli anahtar (maks 64 karakter). env modu için REDIACC_SECRET_<KEY> olarak veya file modu için konteynerlerde /run/secrets/<key> olarak gösterilecek. | Evet | - |
list
Gizli anahtarları ve modları listele (asla değer, asla özet).
rdc repo secret list <ref>
set
Bir gizli anahtarı ayarla veya üzerine yaz. Fork'lar miras almaz; fork üzerinde açıkça ayarla. Aracı bağlamı altında, --current özet eşleşmesi gerektirir (passwd tarzı).
rdc repo secret set <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--key <KEY> | UPPER_SNAKE_CASE biçiminde gizli anahtar (maks 64 karakter). env modu için REDIACC_SECRET_<KEY> olarak veya file modu için konteynerlerde /run/secrets/<key> olarak gösterilecek. | Evet | - |
--value <value> | Gizli değer. stdin'den okumak için `-` geçin (kabuk geçmişine maruz kalmayı önler). | Evet | - |
--mode <mode> | Teslim modu: 'env' (konteyner ortamında görünür, docker inspect) veya 'file' (tmpfs dosyası, asla env'de değil). Varsayılan: file. | Hayır | file |
--current <value> | Önceki değerin SHA-256 özeti (passwd tarzı önkoşul). Aracı bağlamında üzerine yazma için zorunludur; ilk yazma için isteğe bağlıdır. | Hayır | - |
--rotate-secret | Döndürmeyi onayla; --current ön koşulunu atla (döndürme olarak denetlenir). Önceki değeri doğrulamadan kasıtlı olarak döndürürken kullanın. | Hayır | - |
unset
Bir gizli anahtarı sil. Aracı bağlamı altında, --current özet eşleşmesi gerektirir.
rdc repo secret unset <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--key <KEY> | UPPER_SNAKE_CASE biçiminde gizli anahtar (maks 64 karakter). env modu için REDIACC_SECRET_<KEY> olarak veya file modu için konteynerlerde /run/secrets/<key> olarak gösterilecek. | Evet | - |
--current <value> | Önceki değerin SHA-256 özeti (passwd tarzı önkoşul). Aracı bağlamında üzerine yazma için zorunludur; ilk yazma için isteğe bağlıdır. | Hayır | - |
--rotate-secret | Döndürmeyi onayla; --current ön koşulunu atla (döndürme olarak denetlenir). Önceki değeri doğrulamadan kasıtlı olarak döndürürken kullanın. | Hayır | - |
6.28 admin
Depo yönetimi ve bakım komutları.
archive
Arşivlenmiş depo kayıtlarının yönetimi.
Arşivlenmiş depo kimlik bilgilerini listele
rdc repo admin archive list
Tüm arşivlenmiş kimlik bilgilerini kalıcı olarak sil
rdc repo admin archive purge [name] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
Arşivlenmiş depo kimlik bilgisini geri yükle
rdc repo admin archive restore <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--new-name <name> | Yeni kaynak adı | Hayır | - |
validate
Depo bütünlüğünü doğrula
rdc repo admin validate <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
fsck
CLI yapılandırma ref'lerini (dallar, HEAD) bir makinede gerçekten mevcut olan nesnelere karşı doğrula. Sarkan ref'leri (eksik bir nesneyi gösteren bir ref) ve yetim commit'leri (hiçbir ref'in erişemediği değişmez bir commit) raporlar. Salt okunur.
rdc repo admin fsck [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
ownership
Depo dizini sahipliğini değiştir
rdc repo admin ownership <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--uid <uid> | Sahip UID'si (varsayılan: 7111) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
autostart
Önyüklemede otomatik depo başlatmayı yönet
Bir depo için otomatik başlatmayı etkinleştir
rdc repo admin autostart enable [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
Bir depo için otomatik başlatmayı devre dışı bırak
rdc repo admin autostart disable [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
Otomatik başlatma etkin olan depoları listele
rdc repo admin autostart list [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
template
Depoya şablon uygula
CLI ile gelen tüm yerleşik dağıtım şablonlarını listele
rdc repo admin template list
Bir depoya şablon uygulayın. Yerleşik bir şablon adı (ör. app-postgres) veya özel bir JSON şablonu için --file kullanın. Rediaccfile yaşam döngüsü: up() konteynerleri başlatır (imajları çekin, yapılandırmaları burada oluşturun), down() durdurur. Minimal Rediaccfile: up() { renet compose -- pull; renet compose -- up -d; } down() { renet compose -- down; }. ÖNEMLİ: Rediaccfile 'renet compose' KULLANMALIDIR: 'docker compose' reddedilir. ORTAM DEĞİŞKENLERİ: iki seviye: (a) Rediaccfile shell: ${SVCNAME_IP} (ör. APP_IP), ${REDIACC_WORKING_DIR}, ${REDIACC_NETWORK_ID}. (b) Konteynerler içinde: renet otomatik olarak SERVICE_IP ve REDIACC_NETWORK_ID ortam değişkenlerini enjekte eder. eBPF bind yeniden yazımı IP izolasyonunu şeffaf biçimde yönetir, böylece uygulamalar 0.0.0.0'a bağlanabilir ve çekirdek bunu doğru loopback IP'sine yeniden yazar. Health check'ler localhost kullanabilir. network_mode:host enjekte edilir ve ports: yok sayılır. DEPOLAMA: Hem ${REDIACC_WORKING_DIR}/... bind mount'ları hem de adlandırılmış Docker birimleri güvenlidir: Docker data-root'u şifreli LUKS bağlama noktasının içindedir. YENİDEN BAŞLATMA POLİTİKASI: Yeniden başlatma politikaları güvenlidir: renet bunları CRIU uyumluluğu için otomatik olarak kaldırır ve watchdog kurtarmayı yönetir. Compose: network_mode veya rediacc.* etiketlerini EKLEMEYİN (renet bunları enjekte eder). Çoklu proje: her alt projeyi kendi Rediaccfile'ıyla birlikte kendi alt dizinine yerleştirin: renet bunları otomatik olarak keşfeder ve sırayla çalıştırır. HTTPS yönlendirme: (A) Otomatik rota (fork dostu, önerilen): traefik.enable EKLEMEYİN. Renet otomatik olarak https://{serviceName}.{repoName}.{machineName}.{baseDomain} üretir. 80 dışındaki portlar için rediacc.service_port=<port> etiketini ekleyin. Her fork benzersiz bir alan adı alır. (B) Traefik etiketleri (özel alan adı, fork dostu DEĞİL): traefik.enable=true, traefik.http.routers.<n>.rule=Host(`alanadi`), traefik.http.routers.<n>.entrypoints=websecure,websecure-v6, traefik.http.routers.<n>.tls.certresolver=letsencrypt, traefik.http.services.<n>.loadbalancer.server.port=<port>. TCP/UDP için: rediacc.tcp_ports=3306 / rediacc.udp_ports=53
rdc repo admin template apply <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--template <name> | Uygulanacak şablon | Evet | - |
--file <path> | Özel şablon JSON dosyasının yolu ({"version":"2","files":{"Rediaccfile":"...","docker-compose.yml":"..."}}): yerleşik şablon adının yerine geçer | Hayır | - |
--grand <name> | Ana depo adı (GUID'ye otomatik çözümlenir) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.29 promote
Grand deponun verilerini bir çatalın verileriyle değiştir. Grand, kimliğini (GUID, networkId, alan adları, otomatik başlatma, yedekleme zinciri) korur ancak çatalın güncellenmiş verilerini alır. Eski üretim verileri yedek çatal olarak saklanır. Kullanım: çatalda yükseltmeyi test et → doğrula → üretime devir.
rdc repo promote <fork-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
6.30 logs
Bir deponun konteynerlerinden uygulama günlüklerini göster. Docker depoları deponun kendi Docker daemon'ından okur; kubernetes depoları deponun ad alanındaki pod günlüklerini okur. Depo birden fazla konteyner çalıştırıyorsa, istediğinizi --container ile belirtin.
rdc repo logs <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-c, --container <name> | Okunacak konteyner (depo birden fazla çalıştırdığında gerekir) | Hayır | - |
-f, --follow | Kesilene kadar yeni satırları akıtmaya devam et | Hayır | - |
--lines <n> | Gösterilecek geçmiş satır sayısı (varsayılan: 100) | Hayır | 100 |
--timestamps | Her satırın başına zaman damgasını ekle | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.31 exec
Bir depo konteyneri içinde bir komut çalıştır. Komutun kendi çıkış kodu doğrudan iletilir, bu yüzden betiklerde ve koşullu ifadelerde çalışır. Docker depoları bunu deponun kendi Docker daemon'ı üzerinden çalıştırır; kubernetes depoları deponun ad alanında çalıştırır.
rdc repo exec <ref> <cmd...> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-c, --container <name> | İçinde çalıştırılacak konteyner (depo birden fazla çalıştırdığında gerekir) | Hayır | - |
-i, --interactive | Bir terminal ayır (bunu bekleyen bir komut için) | Hayır | - |
-u, --user <user> | Komutun çalıştırılacağı kullanıcı | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
7. Ayrık işler
Bir makinedeki bağımsız görevleri yönetin: listeleyin, durumlarını görüntüleyin, olay günlüklerini yeniden oynatın veya canlı izleyin, birini iptal edin ya da tamamlananları temizleyin. Bağımsız bir görev makinede systemd altında çalıştığı için bağlantı kesilse bile çalışmaya devam eder ve daha sonra yeniden bağlanılabilir.
7.1 list
Bir makinedeki bağımsız görevleri en yeniden en eskiye listeler
rdc job list [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
7.2 status
Bağımsız bir görevin durumunu gösterir
rdc job status <job-id> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
7.3 logs
Bağımsız bir görevin olay günlüğünü yeniden oynatır veya canlı izler
rdc job logs <job-id> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
-f, --follow | Görev tamamlanana kadar akışı sürdürür | Hayır | - |
--since-line <n> | Bu satır sayısından sonra devam eder (zaten aldığınız satır sayısı) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
7.4 cancel
Çalışan bağımsız bir görevi iptal eder
rdc job cancel <job-id> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
-y, --yes | Onay istemini atla | Hayır | - |
7.5 gc
Tamamlanmış görevleri ve günlüklerini kaldırır
rdc job gc [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
--older-than <duration> | Bu saatten daha uzun süre önce tamamlanmış görevleri toplar (varsayılan: 168) | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
8. Yedekleme ve Geri Yükleme
Yedekleme stratejilerini, zamanlanmış çalıştırmalarını ve oluşturdukları artefaktları yönet: bir depo için strateji tanımla, istediğin an çalıştır veya geri yükle, ve depolama uç noktasına yazdığı arşivleri incele.
8.1 schedule
Uzak makineye yedekleme zamanlaması dağıt (systemd zamanlayıcıları)
rdc backup schedule [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Evet | - |
--dry-run | Dağıtmadan oluşturulan birimleri önizle | Hayır | - |
--force | Şu anda bir yedekleme çalışıyor olsa bile devam et (yeni birim sonraki tetiklemede uygulanır; çalışan işlem eski birimini korur) | Hayır | - |
--reset-failed | Başarılı dağıtım sonrası etkilenen servislerin failed durumunu temizle (varsayılan kapalı, hata sinyalini korur) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.2 cancel
Uzak makinede çalışan bir yedeklemeyi iptal et
rdc backup cancel [strategy] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.3 list
Bir makine veya depolama üzerindeki yedek artefaktlarını listele.
rdc backup list [artifact-ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Hayır | - |
--storage <name> | Bu depolama uç noktasındaki artefaktları listele | Hayır | - |
--path <subdir> | Depolama kökü içindeki alt dizin. Belirtilmezse hot/ ve cold/ listelenip birleştirilir. | Hayır | - |
-w, --watch | Değişiklikleri izleyin | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.4 restore
Bir yedek artefaktını canlı bir depoya dönüştürün. Yerleşim burada belirtilir.
rdc backup restore <artifact-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--as <name> | Geri yüklenen depo için ad (varsayılan: artefakt adı) | Hayır | - |
-m, --machine <name> | Makine adı | Hayır | - |
--datastore <name> | Bu adlandırılmış veri deposuna geri yükle (bağlı olduğu makine onu barındırır) | Hayır | - |
--up | Aktarımdan sonra geri yüklenen depoyu dağıt | Hayır | - |
--health-window <seconds> | Toplam sağlık kapısı penceresi, saniye cinsinden (varsayılan 300) | Hayır | - |
--health-timeout <seconds> | Deneme başına sağlık kontrolü zaman aşımı, saniye cinsinden (varsayılan 30) | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.5 run
Uzak makinede hemen bir yedekleme başlat
rdc backup run [strategy] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Evet | - |
-w, --watch | Değişiklikleri izleyin | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.6 status
Uzak makinede yedekleme durumunu ve zamanlayıcı durumunu göster
rdc backup status [strategy] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Evet | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.7 strategy
Adlandırılmış yedekleme stratejilerini yönet (sıcak/soğuk modlar, hedefler, zamanlama)
set
Yedekleme stratejisi oluştur veya güncelle
rdc backup strategy set <strategy> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--destination <name> | Strateji içindeki hedef adı | Hayır | - |
--storage <name> | Depolama yapılandırma adı (rclone kimlik bilgileri) | Hayır | - |
--cron <expression> | Cron zamanlaması (ör. "0 * * * *" saatlik için) | Hayır | - |
--mode <mode> | Yedekleme modu: "hot" (kesintisiz) veya "cold" (durdur, anlık görüntü, yeniden başlat) | Hayır | - |
--bwlimit <limit> | Rclone bant genişliği sınırı (ör. "6M", "10M:off", "08:00,3M;22:00,10M") | Hayır | - |
--include <repos> | Yalnızca bu depoları yedekle (virgülle ayrılmış adlar) | Hayır | - |
--exclude <repos> | Bu depoları yedeklemeden hariç tut (virgülle ayrılmış adlar) | Hayır | - |
--folder <path> | Bu hedef için depolama kovasındaki alt klasör (ör. hot, cold) | Hayır | - |
--enable | Stratejiyi veya hedefi etkinleştir | Hayır | - |
--disable | Stratejiyi veya hedefi devre dışı bırak | Hayır | - |
bind
Bir yedekleme stratejisini bir makineye bağla, böylece zamanlaması orada dağıtılır
rdc backup strategy bind <strategy> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
unbind
Bir yedekleme stratejisinin bir makineyle bağlantısını kes
rdc backup strategy unbind <strategy> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı | Evet | - |
remove
Yedekleme stratejisini veya hedefi kaldır
rdc backup strategy remove <strategy> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--destination <name> | Yalnızca bu hedefi kaldır (diğer hedefler korunur) | Hayır | - |
list
Tüm yedekleme stratejilerini listele
rdc backup strategy list
show
Yedekleme stratejisi ayrıntılarını göster
rdc backup strategy show [strategy]
9. Depolama Yönetimi
Harici yedekleme depolama uç noktalarını yönet (S3 ve diğer rclone uyumlu hedefler): uç noktaları kaydet ve kaldır, kayıtlıları listele, tuttukları artefaktlara göz at ve sahipsiz yedekleri temizle.
9.1 list
Depolama uç noktalarını listele. Tam ayrıntı için bir ad verin.
rdc storage list [name] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--reveal | Depolama yapılandırmasını açık metin olarak göster (yalnızca etkileşimli TTY; denetlenir) | Hayır | - |
9.2 browse
Bir depolama sistemindeki dosyaları göz at
rdc storage browse <storage> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--path <subpath> | Listelenecek alt dizin yolu | Hayır | “ |
9.3 prune
Hiçbir yapılandırmada bulunmayan sahipsiz yedekleri depolamadan sil. Çoklu yapılandırma güvenli, ek süre korumalı.
rdc storage prune <storage> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Yürütücü makine: depoya karşı rclone list/delete çağrılarını çalıştırır. Müşterilerin yerel olarak rclone'un kurulu olması beklenmediği için gereklidir; depolama kimlik bilgileri yine yerel yapılandırmanızdan gelir. | Evet | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
--force | Onay istemlerini atla | Hayır | - |
--force-delete-mounted | Bağlama güvenlik kontrolünü geçersiz kıl ve kaynak GUID şu anda yürütücü makinede bağlı olsa veya çalışan bir konteyneri olsa bile bulut yedeklerini sil. --force seçeneğinden farklıdır (yalnızca arşivlenmiş depolar için erteleme süresini geçersiz kılar). | Hayır | - |
--grace-days <days> | Son arşivlenen depolar için gün cinsinden ek süre (varsayılan: 7) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
--skip-router-restart | İkili güncelleme sonrası yönlendirme sunucusunu yeniden başlatmayı atla | Hayır | - |
9.4 add
Bir depolama uç noktası kaydet.
rdc storage add <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--vault <json> | Kasa içeriği JSON dizesi olarak | Evet | - |
9.5 import
Bir rclone yapılandırma dosyasından depoları içe aktar
rdc storage import <file> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--name <name> | Yalnızca belirtilen bölümü içe aktar | Hayır | - |
9.6 remove
Yapılandırmadan bir depolama uç noktasını kaldır.
rdc storage remove <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
10. VS Code Entegrasyonu
Bir makine veya depoya VS Code Remote SSH ile bağlanın
10.1 connect
Bir makinede veya bir depo içinde VS Code açın.
rdc vscode connect <target> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-f, --folder <path> | Uzak klasör yolu | Hayır | - |
--url-only | VS Code URI'sini yazdırın, başlatmayın | Hayır | - |
-n, --new-window | Yeni VS Code penceresinde aç | Hayır | - |
--skip-env-setup | Uzak ortam kurulumunu atla | Hayır | - |
--insiders | VS Code Insiders ayarlarını kullanın | Hayır | - |
--browser | Depo sandbox'ı içinden tarayıcı VS Code sun (yerel VS Code gerekmez) | Hayır | - |
--no-open | Yerel tarayıcıyı açmadan URL'yi yazdır | Hayır | - |
--local <port> | Yerel port (varsayılan: uzak port ile aynı) | Hayır | - |
--server-provider <id> | Tarayıcı VS Code sunucu uygulaması (openvscode, code-server) | Hayır | - |
--server-archive <file> | Makinede önceden konumlandırılmış sunucu tarball yolu (ağ dışı kurulumlar için) | Hayır | - |
10.2 list
Yapılandırılmış VS Code SSH bağlantılarını listeleyin
rdc vscode list
10.3 cleanup
VS Code SSH yapılandırmalarını kaldırın
rdc vscode cleanup [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--all | Tüm rediacc SSH yapılandırmalarını kaldırın | Hayır | - |
-c, --connection <name> | Belirli bir bağlantıyı kaldırın | Hayır | - |
10.4 check
VS Code yüklemesi ve yapılandırmasını kontrol edin
rdc vscode check [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--insiders | VS Code Insiders ayarlarını kullanın | Hayır | - |
10.5 serve
Sandbox içindeki tarayıcı VS Code sunucusunu yönet
status
Tarayıcı VS Code sunucusunun çalışıp çalışmadığını göster
rdc vscode serve status <target> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--server-provider <id> | Tarayıcı VS Code sunucu uygulaması (openvscode, code-server) | Hayır | - |
stop
Tarayıcı VS Code sunucusunu durdur
rdc vscode serve stop <target> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--server-provider <id> | Tarayıcı VS Code sunucu uygulaması (openvscode, code-server) | Hayır | - |
11. SSH Terminal Erişimi
Bir makineye veya depoya SSH terminali açın. Hedef bir makine adı veya bir depo referansıdır ve depo bağlamı (DOCKER_HOST, çalışma dizini, ortam) otomatik olarak ayarlanır. Tek bir komutu etkileşimsiz çalıştırmak için `-c` kullanın. Konteyner günlükleri veya bir konteynerde tek seferlik bir komut için `repo logs` ve `repo exec` kullanın. VS Code için `vscode` kullanın.
11.1 connect
Bir makinede veya Docker'ı kurulmuş bir depo içinde bir kabuk açın.
rdc term connect <target> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-c, --command <cmd> | Etkileşimli kabuk yerine bir komut yürütün | Hayır | - |
--external | Dış terminal penceresinde başlatmaya zorla | Hayır | - |
--reset-home | Temiz bir başlangıç için repo bazlı home katmanını sıfırla | Hayır | - |
12. Hızlı Komutlar (Kısayollar)
12.1 run
Bir işlevi çalıştırın (kısayol: queue create)
rdc run
12.2 trace
Bir görevi izle (kısayol: queue trace)
rdc trace
12.3 cancel
Bir görevi iptal et (kısayol: queue cancel)
rdc cancel
12.4 retry
Başarısız bir görevi yeniden dene (kısayol: queue retry)
rdc retry
13. Abonelik Yönetimi
Lisanslama ve abonelik jetonlarını yönet. login ile giriş yapın, status ile inceleyin, refresh ile lisansları yeniden verin.
13.1 login
Web portaldan alınan API belirteci ile kimlik doğrulama
rdc subscription login [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-t, --token <token> | API belirteci (rdt_...) | Hayır | - |
--server <url> | Hesap sunucusu URL'si | Hayır | - |
13.2 logout
Kayıtlı abonelik jetonunu temizle
rdc subscription logout
13.3 status
Bir makine için aboneliği ve lisans durumunu göster.
rdc subscription status [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Hayır | - |
13.4 refresh
Lisansları hesap sunucusundan yenile.
rdc subscription refresh [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Hayır | - |
--repo <ref> | Depo referansı: ad, veya ad:etiket, isteğe bağlı olarak @makine ile (örn. shop veya shop:test) | Hayır | - |
14. CLI Güncellemeleri
CLI güncellemelerini kontrol et ve uygula
rdc update [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--force | Güncel olsa bile güncellemeyi zorla | Hayır | - |
--check-only | Sadece güncellemeleri kontrol et, indirme | Hayır | - |
--rollback | Önceki sürüme geri al | Hayır | - |
--status | Otomatik güncelleme durumunu ve tanılama bilgilerini göster | Hayır | - |
--channel <channel> | Yayın kanalını ayarla (stable veya edge) | Hayır | - |
15. Üçüncü Taraf Katkıları
rdc ile birlikte paketlenen üçüncü taraf bileşenleri yazdırır: renet'in gömdüğü ve taşıdığı ikili dosyalar (CRIU, rsync, rclone), gömülü Node.js çalışma zamanı ve paketlenmiş npm bağımlılıkları. Sürümleri, SPDX lisans tanımlayıcılarını ve GPL uyumluluğu için gereken tam sürüm kaynak arşivi URL'lerini gösterir. Sürüm derlemeleriyle paketlenen tam THIRD_PARTY_LICENSES metnini yazdırmak için --licenses kullanın.
rdc credits [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--licenses | Sürüm derlemeleriyle paketlenen tam THIRD_PARTY_LICENSES metnini yazdır | Hayır | - |
16. Sistem Tanılama
CLI ortamını ve renet entegrasyonunu tanıla
rdc doctor
17. Yerel VM İşlemleri
KVM/QEMU/Hyper-V kullanarak yerel VM sağlama ve yönetimi (platform otomatik algılanır). Uzak makineler için değildir — onlar için `machine` kullanın. Temel alt komutlar: up (VM'leri başlat), down (durdur), status (çalışan VM'leri listele), ssh (VM'ye bağlan), setup (önkoşulları kur), check (ana bilgisayar hazırlığını doğrula).
17.1 up
VM kümesini yerel olarak oluştur
rdc ops up [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--force | Tüm VM'leri zorla yeniden başlat | Hayır | - |
--parallel | VM'leri paralel olarak oluştur | Hayır | - |
--basic | Minimal küme (köprü + 1 işçi) | Hayır | - |
--lite | VM hazırlamayı atla (yalnızca durum) | Hayır | - |
--skip-orchestration | Küme orkestrasyonunu atla | Hayır | - |
--backend <backend> | Sanallaştırma arka ucu (kvm|qemu, otomatik algılanır) | Hayır | - |
--os <name> | VM işletim sistemi (ör. ubuntu-24.04, debian-12) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
17.2 down
VM kümesini yok et
rdc ops down [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--backend <backend> | Sanallaştırma arka ucu (kvm|qemu, otomatik algılanır) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
17.3 status
VM kümesi durumunu göster
rdc ops status [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--backend <backend> | Sanallaştırma arka ucu (kvm|qemu, otomatik algılanır) | Hayır | - |
17.4 ssh
Bir VM'ye SSH ile bağlan
rdc ops ssh [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--vm-id <id> | Sanal makine kimliği | Evet | - |
-c, --command <cmd> | Etkileşimli kabuk yerine bir komut yürütün | Hayır | - |
--backend <backend> | Sanallaştırma arka ucu (kvm|qemu, otomatik algılanır) | Hayır | - |
--user <user> | VM bağlantısı için SSH kullanıcı adı | Hayır | - |
17.5 setup
Sanallaştırma ön koşullarını kur
rdc ops setup [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
17.6 check
Sanallaştırma ön koşullarını doğrula
rdc ops check
18. Yürütücü hizmeti
İstemcilerin SSH üzerinden kendileri bağlanmak yerine komutları bu süreç üzerinden çalıştırabilmesi için bu süreci yürütücü olarak çalıştır
rdc serve [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-p, --port <port> | Dinlenecek port | Hayır | 8080 |
--host <host> | Bağlanılacak adres | Hayır | 0.0.0.0 |
--mode <mode> | Konum: daemon (müşteri sunucusu) veya container | Hayır | daemon |
Yaygın Hata Mesajları
Bir şeyler ters gittiğinde, CLI net hata mesajları sağlar:
| Hata | Anlam |
|---|---|
| Kimlik doğrulama gerekli. Çalıştırın: rdc subscription login | Önce giriş yapmanız gerekiyor |
| Etkin yapılandırma yok. Şununla oluşturun: rdc config init <name> | Etkin yapılandırma yok — `rdc config init` ile bir tane oluşturun |
| İzin reddedildi | Hesabınız gerekli izinlere sahip değil |
| Makine adı gerekli. --machine <name> kullanın | `--machine` ile bir makine belirtin veya bağlam varsayılanı ayarlayın |
| Takım adı gerekli. --team kullanın veya varsayılanı şu komutla ayarlayın: rdc config set team <name> | `--team` ile bir takım belirtin veya bağlam varsayılanı ayarlayın |
| Bölge adı gerekli. --region kullanın veya varsayılanı şu komutla ayarlayın: rdc config set region <name> | `--region` ile bir bölge belirtin veya bağlam varsayılanı ayarlayın |
Çıktı Formatları
Tüm listeleme/alma komutları `--output` aracılığıyla birden fazla çıktı formatını destekler:
rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table # default
Bu, Rediacc CLI'yi betiklere, CI/CD hatlarına ve otomasyon iş akışlarına entegre etmeyi kolaylaştırır.