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 |
|---|---|---|---|
--master-password | Önceden hazırlanmış bir password slot ile headless kaydol (tarayıcısız) | Hayır | - |
--master-password-stdin | --master-password gibi, ancak ana parolayı stdin'den okur | 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 | - |
--config-id <id> | Yeni kayıt oluşturmak yerine depodaki bu mevcut yapılandırmaya bağlan | Hayır | - |
disable
Uzak depolamadan bağlantıyı kes ve yapılandırmayı yerel olarak kaydet
rdc config remote disable [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--local | Sunucuya bağlanmadan, önbellekteki kopyadan, yalnızca bu cihazda bağlantıyı kaldır | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
status
Uzak bağlantı durumunu göster
rdc config remote status
master-password
Bu üyenin ana parolasını yönetin (password slot)
Ana parolayı değiştirin: yapılandırma anahtarını bu cihazın kaydından alıp yeni bir password slot altında yeniden sarar
rdc config remote master-password change [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--new-master-password-stdin | Yeni ana parolayı stdin'den okuyun (aksi halde REDIACC_NEW_STORE_MASTER_PASSWORD veya TTY'de bir istem) | Hayır | - |
refresh
Yapılandırmayı uzak depolamadan zorla yeniden al
rdc config remote refresh
versions
Sunucuda saklanan bu yapılandırmanın önceki sürümlerini listeler
rdc config remote versions [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--explain | Sunucunun sakladığı sürümlerden, her sürümün değiştirdiği JSON işaretçilerini gösterir | Hayır | - |
restore
Bu yapılandırmanın önceki bir sürümünü en yeni sürümü olarak yayımlar
rdc config remote restore <version> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-y, --yes | Onay istemini atla | Hayır | - |
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 | - |
1.17 access
Yapılandırmanın erişim anahtarlarını yönet: CLI'nın bir makinenin authorized_keys dosyasına, bildirilen IPv4 ve IPv6 aralıklarına from= kısıtlamasıyla yazdığı açık SSH anahtarları. Bir anahtarı 'machine access set' ile makineye bağla, sonra 'machine access push' ile uygula
add
Bir erişim anahtarı ekle ya da mevcut olanı makine bağlarını koruyarak yerinde güncelle. Burada verilen aralıklar, bir bağ kendi aralığını belirlemedikçe anahtar için tüm makinelerde geçerlidir; aralık verilmezse yapılandırma genelindeki aralıklar uygulanır
rdc config access add <key> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--public-key <key> | OpenSSH açık anahtar satırı veya onu içeren dosyanın yolu | Evet | - |
--hosted-executor | Gözlemlenen barındırılan yürütücü çıkış aralıklarını ekle (104.28.0.0/16 ve 2a09:bac0::/29) | Hayır | - |
--ipv4 <cidrs> | CIDR gösteriminde IPv4 aralıkları (virgülle ayrılmış, ör. 203.0.113.0/24) | Hayır | - |
--ipv6 <cidrs> | CIDR gösteriminde IPv6 aralıkları (virgülle ayrılmış, ör. 2001:db8::/32) | Hayır | - |
--no-restrict | no-forwarding, no-pty ve no-user-rc kısıtlamaları olmadan yalnızca from= yaz | Hayır | - |
remove
Bir erişim anahtarını yapılandırmadan kaldır
rdc config access remove <key>
ranges
Anahtar veya makine bağı kendi aralığını belirlemedikçe her erişim anahtarının kullandığı kaynak aralıklarını belirle. Seçenek verilmezse aralıkları gösterir
rdc config access ranges [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--hosted-executor | Gözlemlenen barındırılan yürütücü çıkış aralıklarını ekle (104.28.0.0/16 ve 2a09:bac0::/29) | Hayır | - |
--ipv4 <cidrs> | CIDR gösteriminde IPv4 aralıkları (virgülle ayrılmış, ör. 203.0.113.0/24) | Hayır | - |
--ipv6 <cidrs> | CIDR gösteriminde IPv6 aralıkları (virgülle ayrılmış, ör. 2001:db8::/32) | Hayır | - |
--clear | Yapılandırma genelindeki aralıkları kaldır | Hayır | - |
list
Yapılandırmanın erişim anahtarlarını listele
rdc config access list
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 converge
Hâlâ eski runtime düzeniyle çalışan her depo daemon'unu, güncel düzene geçmesi için tek tek yeniden başlatır. CLI bunu renet yüklemesinden sonra kendiliğinden yapar; elle çalıştırmak planı önceden görmek, yarım kalan bir turu sürdürmek ya da --policy always ile renet ikili dosyasındaki herhangi bir değişiklikten sonra yeniden başlatmak için işe yarar.
rdc machine converge <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Hiçbir şeyi yeniden başlatmadan yalnızca planı göster | Hayır | - |
--json | Eşitleme raporunu JSON olarak göster | Hayır | - |
--include-unknown | Yerel yapılandırmada bulunmayan eski depoları da yeniden başlat (ortam sırları bilinmiyor) | Hayır | - |
--policy <policy> | Yeniden başlatma ilkesi: epoch (yalnızca düzen değişiklikleri) ya da always (renet ikili dosyasındaki her değişiklik de) | Hayır | epoch |
--continue-on-error | Bir depo başarısız olduğunda turu durdurmak yerine devam et | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.7 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.8 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.9 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-env <var> | Sağlayıcı API belirtecini tutan ortam değişkeninin adı; belirtecin kendisi asla komut satırına yazılmaz | 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.10 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 üzerinde yerleşikken veya yedekleme stratejileri makineye bağlıyken bile makineyi kaldır, bu referansları askıda bırak. | Hayır | - |
3.11 restart-services
Hâlâ değiştirilmiş bir ikili dosyayı çalıştıran renet daemon'larını teker teker kurulu sürümle yeniden başlatır; bir sonrakine geçmeden önce her birimin yeni ikili dosyayla etkin olduğunu doğrular. --include-docker ile her deponun rediacc-docker-N denetleyicisi de depo depo yeniden başlatılır, bu da o deponun konteynerlerini yeniden başlatır.
rdc machine restart-services <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--include-docker | Her deponun rediacc-docker-N denetleyicisini de yeniden başlat (deponun konteynerlerini yeniden başlatır) | Hayır | - |
--json | Raporu JSON olarak yazdır | Hayır | - |
3.12 scan-keys
Mevcut yapılandırmadaki makineler için SSH ana bilgisayar anahtarlarını tara
rdc machine scan-keys [name]
3.13 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% |
--no-converge | Hâlâ eski runtime düzeninde çalışan depo daemon'larını yeniden başlatma (REDIACC_SKIP_RUNTIME_CONVERGE=1 ile aynı) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.14 status
Tam makine durumunu göster (sistem, depolar, konteynerler, servisler). Salt okunur: makinedeki renet'i hiçbir zaman güncellemez; sürümü farklıysa uyarı verir.
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 | - |
3.15 gpu
Bir makinenin depolara verebileceği GPU'ları, sunduğu CDI cihazlarını ve her birinin hangi depoda olduğunu gösterir.
list
Bir makinede algılanan GPU'ları, spec dosyalarının tanımladığı CDI cihaz adlarını ve her cihazın verildiği depoları listeler. Bir cihazı vermek için 'rdc repo gpu grant' kullanın.
rdc machine gpu list <name> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
3.16 access
Yapılandırmanın erişim anahtarlarını bir makineye bağla ve her birini kaynak aralıklarıyla kısıtlayarak makinenin authorized_keys dosyasına yaz
set
Bir erişim anahtarını makineye bağla. Burada verilen aralıklar, anahtarın aralıklarının yerine yalnızca bu makinede geçer. 'machine access push' ile uygula
rdc machine access set <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--key <key> | Erişim anahtarı adı ('config access list' çıktısına bak) | Evet | - |
--ipv4 <cidrs> | CIDR gösteriminde IPv4 aralıkları (virgülle ayrılmış, ör. 203.0.113.0/24) | Hayır | - |
--ipv6 <cidrs> | CIDR gösteriminde IPv6 aralıkları (virgülle ayrılmış, ör. 2001:db8::/32) | Hayır | - |
--clear-ranges | Bu makineye özel aralıkları bırak; böylece anahtarın veya yapılandırmanın aralıkları geçerli olur | Hayır | - |
remove
Bir erişim anahtarının makineyle bağını kaldır. Sonraki 'machine access push' satırını siler
rdc machine access remove <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--key <key> | Erişim anahtarı adı ('config access list' çıktısına bak) | Evet | - |
show
Bir makineye bağlı erişim anahtarlarını ve her birinin orada geçerli aralıklarını göster
rdc machine access show <machine>
push
Bir makineye bağlı erişim anahtarlarını authorized_keys dosyasına yaz, aynı anahtarı taşıyan mevcut satırı devral ve artık bağlı olmayan anahtarlara ait bu yapılandırmanın satırlarını sil. rdc'nin kendi oturumunun erişimini kesecek bir değişikliği reddeder; gönderim sırasında dosya değiştiyse hiçbir şey yazmaz
rdc machine access push <machine> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Değişiklikleri yazmadan göster | 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 küme adı verilirse o 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. konumsal <ref> 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 <ref> 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. Bir fork'un yapılandırma girişi deletedRepositories'e taşınır; böylece ad serbest kalır ve GUID 'repo admin archive restore' ile kurtarılabilir durumda kalır. Grand deponun veya başka makinelere gönderilmiş deponun girişi, --archive-config verilmedikçe korunur. 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 | - |
--purge-backups | Deponun bulut yedeklerini süresinin dolmasını beklemeden hemen sil | 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, bu yüzden 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 prune
Bir deponun Docker depolamasını sınıflandırır ve geri kazanır: kullanılmayan imajlar, derleme önbelleği, durdurulmuş kapsayıcılar ve hiçbir imajın ya da kapsayıcının başvurmadığı overlay2 dizinleri. --apply olmadan deneme çalıştırmasıdır. --apply, depo çevrimiçiyken Docker API'si üzerinden alan kazanır; --apply --offline ayrıca çalışma süresince deponun Docker daemon'unu durdurur ve sahipsiz dizinleri karantinaya alır. Başvuru verilmezse -m üzerindeki bağlı tüm depoları inceler (yalnızca deneme çalıştırması)
rdc repo prune [ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--apply | Alan kazan; bu seçenek olmadan çalıştırma yalnızca rapor verir | Hayır | - |
--offline | Deponun Docker daemon'unu durdur ve sahipsiz dizinleri karantinaya al (--apply gerekir) | Hayır | - |
--all-images | Hiçbir kapsayıcının kullanmadığı etiketli imajları da kaldır | Hayır | - |
--no-trim | Alan kazandıktan sonra fstrim adımını atla | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
-m, --machine <name> | Hedef makine adı | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
6.22 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.23 push
Depoyu başka bir makineye gönder. Depolama hedefleri kaldırıldı; belirli bir ana yedek için `rdc backup snapshot` kullanın. Makineler arası transferde şifrelenmiş depo görüntüsü aynı GUID ile kopyalanır: bu yedekleme veya 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 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 | - |
--bwlimit <limit> | Aktarım hızı sınırı: saniyede bayt, ondalık birimler (12.5M = 12,5 MB/s), ikili birimler (12Mi) ya da bit (100Mbps). Verilmezse sınır uygulanmaz | 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.24 pull
Depoyu başka bir makineden çek. Depolama kaynakları kaldırıldı; belirli bir ana geri dönüş için `rdc backup restore` kullanı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 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 | - |
--bwlimit <limit> | Aktarım hızı sınırı: saniyede bayt, ondalık birimler (12.5M = 12,5 MB/s), ikili birimler (12Mi) ya da bit (100Mbps). Verilmezse sınır uygulanmaz | 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.25 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> | Aktarım hızı sınırı: saniyede bayt, ondalık birimler (12.5M = 12,5 MB/s), ikili birimler (12Mi) ya da bit (100Mbps). Verilmezse sınır uygulanmaz | 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.26 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.27 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.28 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/net-<networkId>/secrets/<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.29 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.30 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.31 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.32 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 | - |
6.33 gpu
Bir depoya CDI cihazı verir (örneğin nvidia.com/gpu=all); böylece konteynerleri onu isteyebilir. İzni geri de alabilir. İzni makine uygular; özel izin cihazı tek bir depoya ayırır.
grant
Deponun konteynerlerinin bir CDI cihazı istemesine izin verir. Cihaz adlarını 'rdc machine gpu list' gösterir.
rdc repo gpu grant <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--device <cdi-name> | Tam nitelikli CDI cihaz adı (örn. nvidia.com/gpu=all) | Evet | - |
--exclusive | Cihazı bu depoya ayır: bu sürede başka bir depoya verilemez | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
revoke
Bir CDI cihazını deponun konteynerlerinden çeker. Cihaza zaten sahip konteynerler yeniden başlayana kadar onu korur.
rdc repo gpu revoke <ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--device <cdi-name> | Tam nitelikli CDI cihaz adı (örn. nvidia.com/gpu=all) | Evet | - |
--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ı (bu yapılandırmanın bekleyen görev biletlerini listelemek için boş bırakın) | Hayır | - |
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ı (bu yapılandırmada görevin bileti varsa isteğe bağlı) | Hayır | - |
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ı (bu yapılandırmada görevin bileti varsa isteğe bağlı) | Hayır | - |
-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ı (bu yapılandırmada görevin bileti varsa isteğe bağlı) | Hayır | - |
-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 | - |
7.6 wait
Bir görevi biletinden devam ederek izlemeye al, ardından onayla ve görevin çıkış koduyla çık
rdc job wait <job-id> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Hedef makine adı (bu yapılandırmada görevin bileti varsa isteğe bağlı) | Hayır | - |
--timeout <duration> | Bu süre sonunda beklemeyi bırak (30s, 5m, 2h; yalnız sayı saniye demektir). Görev çalışmaya devam eder. | 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 browse
Bir deponun içerdiği dosyaları listeler. Varsayılan olarak depo imajında yerel, salt okunur bir gezinti yapar: hesap sunucusu da ağ da gerekmez. Şifreli bir depo açılmadan önce bağlanmış olmalı ya da anahtar dosyası dağıtılmış olmalıdır; browse boş liste göstermek yerine bunu söyler. --at <zaman|anlık görüntü> ile bunun yerine, geri yüklemeden, parça deposundaki bir anlık görüntüyle saklanan dosya listesini gösterir.
rdc backup browse <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--path <subdir> | Listelemeyi bu alt ağaçla sınırla | Hayır | - |
--depth <n> | İnişi N seviyeyle sınırla (sınırsız için 0) | Hayır | - |
--limit <n> | Döndürülecek maksimum girdi sayısı (sınırsız için 0) | Hayır | - |
| `—at <time | snapshot>` | Bu zamanda veya öncesinde alınan anlık görüntüyü ya da bu anlık görüntü kimliğini listele (parça deposunu okur) | 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 üzerindeki yedek artefaktlarını listele.
rdc backup list [artifact-ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
-m, --machine <name> | Makine adı | Hayır | - |
--path <subdir> | Listelemeyi tek bir alt dizinle sınırla; tüm veri deposunu listelemek için belirtme | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.4 manifests
Sunucuya kaydedilen yedek anlık görüntü manifestlerini listele
rdc backup manifests [repo-ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--limit <n> | Sayfa başına satır (varsayılan ve en çok 500) | Hayır | - |
--before <cursor> | Önceki bir listeden sayfa imleci (nextBefore) | Hayır | - |
--include-deleted | Ertelenmiş silmesi bekleyen anlık görüntüleri de dahil et | Hayır | - |
8.5 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 | - |
--at <time> | Belirli bir zamana geri yükle: bir anlık görüntü kimliği veya RFC3339 saati (parça depolamadan geri yükleme) | Hayır | - |
--any-stream | --at ile birlikte, başka makinelerin ve bu soyun fork'larının yazdığı anlık görüntüleri de dikkate alır (varsayılan: yalnızca bu depo, kaynak makinesinde) | Hayır | - |
--no-seed | Yerel çapaları veya depo imajlarını yeniden kullanmak yerine her parçayı depodan getir (deponun okunabildiğini kanıtlar) | Hayır | - |
--allow-unopenable | Depo parolası açmasa bile imajı yerleştir (parola değişiminden önceki bir anlık görüntü) | Hayır | - |
--salvage | Kayıp veya bozuk parçaları aşıp devam et ve hücrelerini boşluk olarak bırak (--as gerekir) | Hayır | - |
--path <file-or-dir> | Tüm depoyu geri yüklemeden, anlık görüntüden yalnızca bu dosyayı veya dizini geri yükle (--at gerekir) | Hayır | - |
--to <dir> | Geri yüklenen yolun yerleştirileceği dizin (varsayılan: makinenin bu anlık görüntü için geri yükleme klasö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.6 retention
Sunucunun uyguladığı anlık görüntü saklama politikasını gösterir.
clear
Tanımlı politikayı kaldırır, böylece planın ya da sunucunun varsayılanı yeniden geçerli olur.
rdc backup retention clear <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--stream <id> | Yalnızca bu yedek akışına uygula (bir akış kimliği); verilmezse tüm depo için varsayılan geçerli olur | Hayır | - |
set
Kaç anlık görüntü saklanacağını belirtin. Her ayar birleştirilmez, tamamen değiştirilir.
rdc backup retention set <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--keep-last <n> | En yeni anlık görüntülerden bu kadarını sakla | Hayır | - |
--keep-hourly <n> | Bu kadar saatin her birinden en yeni anlık görüntüyü sakla | Hayır | - |
--keep-daily <n> | Bu kadar günün her birinden en yeni anlık görüntüyü sakla | Hayır | - |
--keep-weekly <n> | Bu kadar haftanın her birinden en yeni anlık görüntüyü sakla | Hayır | - |
--keep-monthly <n> | Bu kadar ayın her birinden en yeni anlık görüntüyü sakla | Hayır | - |
--keep-yearly <n> | Bu kadar yılın her birinden en yeni anlık görüntüyü sakla | Hayır | - |
--keep-within <duration> | En yeni anlık görüntüden bu süre içindeki her anlık görüntüyü sakla, örn. 24h | Hayır | - |
--stream <id> | Yalnızca bu yedek akışına uygula (bir akış kimliği); verilmezse tüm depo için varsayılan geçerli olur | Hayır | - |
preview
Bir sonraki temizliğin hangi anlık görüntüleri sileceğini ve ne kadar yer açacağını gösterir.
rdc backup retention preview <repo-ref>
8.7 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 | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.8 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.9 snapshot
Parça depolamaya bir anlık görüntü yükle: önce tam envanter, sonra değişen hücreler
rdc backup snapshot <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--reseed | Yerel çıpaya güvenme ve tam envanteri yeniden yükle (her şeyi yeniden yükler ve kotayı yeniden düşer) | Hayır | - |
--dry-run | Yalnızca planla: yükleme yapılmaz. Nelerin taşınacağını bildirir | Hayır | - |
--cold | Konteynerleri durdurur, dondurur, yeniden başlatır ve ancak ondan sonra yükler. Kısa ama gerçek bir kesinti karşılığında uygulama tutarlı bir anlık görüntü verir; --dry-run ile birlikte kullanılamaz | Hayır | - |
--accept-identity-change | LUKS kimliği değiştiğinde veya imaj küçüldüğünde bu imajı yeni temel kabul et; tam bir anlık görüntü yükler | Hayır | - |
--bwlimit <rate> | Yükleme hızı sınırı: saniyede bayt, ondalık birimler (12.5M = 12,5 MB/s), ikili birimler (12Mi) ya da bit (100Mbps). Verilmezse sınır uygulanmaz | Hayır | - |
--parallelism <n> | Aynı anda yüklenecek parça sayısı (varsayılan 4) | Hayır | - |
--read-bwlimit <rate> | Karma ve hücre okuma hız sınırı: --bwlimit ile aynı birimler; varsayılan 50M, 0 = sınırsız | Hayır | - |
--hash-parallelism <n> | Aynı anda karması alınacak hücre sayısı (varsayılan 1; 0 = CPU başına bir, en fazla 16) | Hayır | - |
--cpu-limit <percent> | Bu anlık görüntü için CPU üst sınırı: tüm çekirdeklerin yüzdesi, 1-100 (varsayılan 50; 100 = sınır yok) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.10 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.11 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ı. Bir Rediacc parça depolama hedefi oluşturur | Hayır | - |
--cron <expression> | Cron zamanlaması (ör. "0 * * * *" saatlik için) | Hayır | - |
--mode <mode> | Yedekleme modu: "hot" her şey çalışırken anlık görüntü alır, "cold" görüntü alınırken konteynerleri durdurur | Hayır | - |
--bwlimit <limit> | Saniye başına bayt cinsinden yükleme bant genişliği sınırı, isteğe bağlı K/M/G son ekiyle (ör. "6M", "500K") | Hayır | - |
--read-bwlimit <limit> | Bu stratejinin snapshot'ları için okuma hız sınırı: --bwlimit ile aynı birimler; none sınırı kaldırır | Hayır | - |
--cpu-limit <percent> | Bu stratejinin anlık görüntüleri için CPU üst sınırı: tüm çekirdeklerin yüzdesi, 1-100 (varsayılan 50); none kaldırır | 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 | - |
--retention <spec> | Anlık görüntü saklama, örneğin last=7,daily=7,weekly=4,monthly=6 ("none" kaldırır) | Hayır | - |
--rpo <duration> | Bildirilen koruma hedefi, örneğin 15m (en az 5m; none kaldırır) | Hayır | - |
--repo-rpo <ref=duration> | Depo başına hedef, <ref>=<süre> biçiminde, tekrarlanabilir (none kaldırır); name:* ailedir | Hayır | - |
--repo-cell-size <ref=size> | Depo başına hücre boyutu, <ref>=<boyut> biçiminde, tekrarlanabilir. Değişiklik depoyu yeniden tohumlar | Hayır | - |
--no-estimate | Değişim ve maliyet tahminini atla | Hayır | - |
--dry-run | Neyin değişeceğini göster, hiçbir şey yazma | 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 | - |
--unbind | Stratejiyi onu bağlayan her makineden de çıkar | 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]
8.12 reconcile
Bir deponun depolanan bayt kaydını mağazadaki gerçek duruma getirir (hiçbir parçayı silmez)
rdc backup reconcile [repo-ref] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Kaydı değiştirmeden rakamları göster | Hayır | - |
--check | Kayıt mağazadan farklıysa 1 koduyla biten deneme çalıştırması | Hayır | - |
8.13 usage
Yedek depolama kotasını, saklanan bayt sayısını ve depo başına kullanımı göster
rdc backup usage
8.14 verify
Bir deponun yedek çıpasını parça depolamaya karşı doğrula
rdc backup verify <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--deep | Örneklemeli kontrol yerine kayıtlı her hücreyi yeniden özetle (tam doğrulama) | Hayır | - |
--store | Sunucunun bu deponun saklanan her parçasını yeniden özetlemesini ve eksik ya da bozuk olanları adıyla bildirmesini sağla | Hayır | - |
--restore-test | Çapa anlık görüntüsünü tek kullanımlık bir adla doğrudan depolamadan geri yükle, çapayla karşılaştır, sonucu kaydet ve kopyayı sil | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.15 snapshots
Saklanan anlık görüntüleri yönet
delete
Saklanan tek bir anlık görüntüyü siler. Yalnızca ona ait veriler bir sonraki çöp toplamada boşaltılır.
rdc backup snapshots delete <repo-ref> <snapshot-id>
8.16 download
Depo imajlarını bir makineden yerel bir dizine veya harici bir diske kopyalar. Her çalıştırma yalnızca oturum sürdüğü kadar tutulan yeni bir anlık görüntü alır, yerel kopyayı rsync deltasıyla yerinde günceller, kesintiden sonra kaldığı yerden devam eder ve sonucu sha256 ile doğrular.
rdc backup download [refs...] [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--to <dir> | <machine>/<name>.<tag>.img dosyasını alacak, var olan ve yazılabilir dizin (hiçbir zaman oluşturulmaz) | Evet | - |
--all | -m ile belirtilen makinedeki tüm grand depoları kopyala | Hayır | - |
-m, --machine <name> | Makine adı | Hayır | - |
--include-forks | --all ile birlikte fork'ları da kopyala | Hayır | - |
--bwlimit <rate> | 100Mbps veya 12.5M gibi ağ bant genişliği sınırı (varsayılan: sınırsız) | Hayır | - |
--checkpoint | Anlık görüntüden önce depoyu checkpoint ile dondur (sıcak yedekleme) | Hayır | - |
--retries <n> | Ağ hatasından sonra çalıştırma içindeki yeniden deneme sayısı (varsayılan: 3) | Hayır | - |
--skip-verify | rsync sonrası sha256 karşılaştırmasını atla; rsync'in kendi sağlama toplamı yine çalışır | Hayır | - |
--skip-space-check | Hedefte yeterli boş alan olmayabilirse reddetmek yerine uyar | Hayır | - |
--store | Şifreli imajı makine olmadan doğrudan yedek deposundan yeniden oluşturur. REDIACC_TOKEN içinde backup:read + backup:restore kapsamlı bir API belirteci gerekir | Hayır | - |
| `—at <time | snapshot>` | --store ile alınacak anlık görüntü: bir zaman (ISO 8601) veya anlık görüntü kimliği (varsayılan: en yenisi) | Hayır |
8.17 upload
'rdc backup download' ile oluşturulmuş yerel bir depo imajını bir makineye gönderir ve yeni bir depo olarak kaydeder. Aktarım kesintiden sonra kaldığı yerden devam eder; makine imajı yerleştirmeden önce sha256 ve LUKS başlığını denetler.
rdc backup upload <image-file> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--to <machine> | İmajı alacak makine | Evet | - |
--as <name> | Yeni deponun adı (varsayılan: imajın depo adı) | Hayır | - |
--datastore <name> | İmajı makinenin varsayılanı yerine bu adlı veri deposuna yerleştir | Hayır | - |
--from-repo <name> | Durum dosyası kaybolduğunda veya bilinmeyen bir depoyu gösterdiğinde kimlik bilgisini ve soy bilgisini sağlayan yapılandırma deposu | Hayır | - |
--bwlimit <rate> | 100Mbps veya 12.5M gibi ağ bant genişliği sınırı (varsayılan: sınırsız) | Hayır | - |
--retries <n> | Ağ hatasından sonra çalıştırma içindeki yeniden deneme sayısı (varsayılan: 3) | Hayır | - |
--up | Depoyu kaydedildikten sonra başlat | Hayır | - |
--skip-verify | Yerel imajı indirilirken kaydedilen sha256 ile karşılaştırmayı atla | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.18 purge
Bir deponun depolanan tüm yedek anlık görüntülerini parça deposundan tek seferde siler. Deponun kendisi korunur.
rdc backup purge <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Değişiklik yapmadan ne yapılacağını göster | Hayır | - |
-y, --yes | Onay istemini atla | Hayır | - |
--cancel | Ertelenmiş tam temizlemeyi yürürlüğe girmeden iptal et | Hayır | - |
8.19 check
Bir dosyayı geri yükleyerek anlık görüntünün parola ile açıldığını kanıtlar
rdc backup check <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--path <file> | Geri yüklenip karşılaştırılacak dosya (varsayılan: boş olmayan en küçük dosya) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.20 repair
Depoda kaybolan veya yanlış olan parçaları bu makinenin çapasından yeniden yükler
rdc backup repair <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--dry-run | Nelerin silinip yeniden yükleneceğini bildirir; hiçbir şeyi değiştirmez | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.21 toc-key
Bir deponun gözatma listesi anahtarını yönetir
rdc backup toc-key
8.22 churn
Bir deponun imajının çalıştırmalar arasında ne kadar değiştiğini ölçer, hücre boyutu başına yüklemeyi öngörür ve birini önerir. Çalışırken makinede bir reflink tabanı tutulur ve her zaman kaldırılır.
rdc backup churn <repo-ref> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--samples <n> | Alınacak ölçüm sayısı (varsayılan 3) | Hayır | - |
--interval <duration> | Yoklamalar arası bekleme, örneğin 10m (varsayılan 10m) | Hayır | - |
--debug | Hata ayıklama çıkışını etkinleştir (yerel mod) | Hayır | - |
8.23 immutability
Saklanan yedeklerin ertelenmiş silme penceresini göster veya ayarla
show
Geçerli ertelenmiş silme penceresini göster
rdc backup immutability show
set
Ertelenmiş silme penceresini gün olarak ayarla (0 ile 30)
rdc backup immutability set <days>
8.24 undelete
Bir anlık görüntünün ertelenmiş silmesini yürürlüğe girmeden iptal et
rdc backup undelete <snapshot-id>
9. VS Code Entegrasyonu
Bir makine veya depoya VS Code Remote SSH ile bağlanın
9.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 | - |
9.2 list
Yapılandırılmış VS Code SSH bağlantılarını listeleyin
rdc vscode list
9.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 | - |
9.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 | - |
9.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 | - |
10. 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.
10.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 | - |
11. Hızlı Komutlar (Kısayollar)
11.1 run
UYARI: Yalnızca hata ayıklama ve deneme amaçlı düşük seviyeli bir komuttur, üretimde kullanılmamalıdır. Günlük işler için üst seviye komutlar (repo up, repo down vb.) vardır. Bir makinede ham bir renet fonksiyonu çalıştırır.
rdc run
11.2 trace
Bir görevi izle (kısayol: queue trace)
rdc trace
11.3 cancel
Bir görevi iptal et (kısayol: queue cancel)
rdc cancel
11.4 retry
Başarısız bir görevi yeniden dene (kısayol: queue retry)
rdc retry
12. Abonelik Yönetimi
Lisanslama ve abonelik jetonlarını yönet. login ile giriş yapın, status ile inceleyin, refresh ile lisansları yeniden verin.
12.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_...). stdin'den okumak için `-` geçin (belirteç süreç listesinde görünmez). | Hayır | - |
--password-stdin | Hesap parolasını stdin'den okuyarak tarayıcısız oturum aç (REDIACC_LOGIN_EMAIL gerekir) | Hayır | - |
--server <url> | Hesap sunucusu URL'si | Hayır | - |
12.2 logout
Kayıtlı abonelik jetonunu temizle
rdc subscription logout
12.3 proxy-token
--proxy için bu cihazdaki oturumdan kısa ömürlü bir proxy:exec belirteci üret
rdc subscription proxy-token [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--json | Belirteci ve expiresAt değerini JSON olarak yazdır | Hayır | - |
12.4 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 | - |
12.5 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 | - |
13. 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 | - |
14. Üçü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), 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 | - |
15. Sistem Tanılama
CLI ortamını ve renet entegrasyonunu tanıla
rdc doctor
16. Yerel araçlar
rdc'nin bu makinede çalıştırdığı yerel araçları yönetir. `rdc tools install tofu`, sabitlenmiş OpenTofu sürümünü indirir, açmadan önce SHA-256 değerini rdc'ye gömülü sağlama toplamıyla karşılaştırır ve ikili dosyayı rdc'nin araç dizinine yerleştirir. `rdc tools list` her aracı sürümü ve bulunduğu yerle birlikte gösterir.
16.1 install
Bu CLI'de sabitlenmiş OpenTofu sürümünü indirir, SHA-256 sağlama toplamını doğrular ve rdc'nin araç dizinine kurar. Sağlama toplamı tutmazsa indirilen dosya silinir ve hiçbir şey kurulmaz. Terraform asla kurulmaz; PATH'te zaten varsa olduğu gibi kullanılır.
rdc tools install <tool> [options]
| Bayrak | Açıklama | Gerekli | Varsayılan |
|---|---|---|---|
--force | Sabitlenmiş sürüm zaten varsa bile yeniden kur | Hayır | - |
16.2 list
rdc'nin çalıştıracağı hazırlama motorunu (OpenTofu veya Terraform) ve rdc'nin araç dizinindeki her OpenTofu sürümünü; sürümü, kaynağı ve yoluyla birlikte listeler.
rdc tools list
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.