Rediacc CLI viide
Ülevaade
**Rediacc CLI** (`rdc`) on käsurea liides isemajutatud infrastruktuuri haldamiseks -- masinad, repositooriumid, salvestus, varukoopiad ja palju muud.
Paigaldamine
Laadi oma platvormile sobiv uusim binaarne fail alla [Rediacc väljaannete lehelt](https://www.rediacc.com) või paigalda pakihalduri kaudu:
# macOS / Linux
curl -fsSL https://www.rediacc.com | sh
# Or use the packaged binary directly
./rdc --help
Globaalsed valikud
Iga käsk toetab neid globaalseid lipukesi:
| Lipuke | Kirjeldus |
|---|---|
--output | Väljundvorming (table|json|yaml|csv). Vaikeväärtuse alistamiseks kasuta REDIACC_DEFAULT_OUTPUT. |
--config | Kasuta selle käsu jaoks konkreetset konfiguratsiooni |
--lang | Keele alistamine ({{languages}}) |
--force | Jäta kinnitusviibad vahele |
1. Konfiguratsiooni haldus
Halda konfiguratsioonifaile: loomine, vahetamine, muutmine, oleku tasakaalustamine ja läbivad tugifunktsioonid (väljad, audit, SSH-võtmed, kaugsünkroonimine).
Konfiguratsioonifailid salvestavad ühenduse andmed (API URL, mandaadid, vaikimisi meeskond/piirkond/sild), et saaksid keskkondade vahel kiiresti vahetada.
1.1 prune
Eemalda vananenud kirjed kohalikust konfiguratsioonifailist asukohast ~/.config/rediacc/<config>.json. Puhastatakse kolm ämbrit, kõik puhtalt kohalikud (SSH/renet-kõnesid ei tehta): (1) ACME sertifikaadi vahemälu kirjed, mille ankur GUID/repo/masin ei ole enam aktiivses konfiguratsioonis; (2) arhiveeritud hoidlad, mille kaitsevali on aegunud (vaikimisi 7 päeva, vt defaults.pruneGraceDays); (3) ripuvad ristviited (machine→strategy, strategy→repo). Kasutusel olevaid ressursse, mandaate, salvestustõeneid ja teadaolevaid hoste ei puudutata kunagi. Vaikimisi käitumine on muudatuste rakendamine; kasuta --dry-run ainult eelvaateks.
rdc config prune [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--dry-run | Kuva, mida eemaldataks, ilma konfiguratsioonifaili muutmata. Peegeldab teiste prune-käskude vaikimisi-väljas semantikat. | Ei | - |
--certs-only | Piirdu ainult ACME sertifikaadi vahemälu ämbrisse. Jäta vahele arhiivi puhastamine ja ristviidete koristamine. Vastastikku välistav lipuga --archives-only ja --refs-only. | Ei | - |
--archives-only | Piirdu ainult aegunud arhiivide puhastamisega. Jäta vahele sertifikaadi vahemälu ja ristviidete koristamine. Vastastikku välistav lipuga --certs-only ja --refs-only. | Ei | - |
--refs-only | Piirdu ainult ripuvate ristviidete puhastamisega (machine→strategy, strategy→repo excludes/includes). Jäta vahele sertifikaadi vahemälu ja arhiivid. Vastastikku välistav lipuga --certs-only ja --archives-only. | Ei | - |
--purge-archived | Eemalda KÕIK arhiveeritud hoidlad sõltumata vanusest, mitte ainult kaitsevalist üle läinud. Samaväärne käsu 'rdc repo admin archive purge' käivitamisega iga arhiveeritud hoidla jaoks. Kasuta ainult siis, kui oled kindel, et ei vaja ühtegi salvestatud mandaati taastamiseks. | Ei | - |
--orphan-repos | Eemaldab repositooriumikirjed, mis ei ole ühelegi masinale määratud. Iga kirje sisaldab selle repo ligipääsuandmeid ja SSH-võtit, seega on kustutamine pöördumatu. Käivita kõigepealt 'rdc config reconcile', et määramine vastaks tegelikele masinatele. | Ei | - |
--grace-days <days> | Tühista arhiivi kaitsevali aken (päevades) selle käivituse jaoks. Langeb tagasi väärtusele defaults.pruneGraceDays konfiguratsioonis, seejärel 7-le, kui kumbagi ei ole seatud. | Ei | - |
1.2 init
Loo uus nimeline konfiguratsioonifail
Saad masinad otse lisada:
rdc config init [name] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--ssh-key <path> | Tee SSH-privaatvõtmeni (nt ~/.ssh/id_rsa) | Ei | - |
--renet-path <path> | Tee renet-binaarini (vaikimisi: renet PATH-is) | Ei | - |
--master-password <password> | Krüpteeri ressursid peaparooliga | Ei | - |
--server <url> | Kontoserveri URL | Ei | - |
1.3 list
Loetle kõik konfiguratsioonifailid
rdc config list
1.4 show
Kuva praeguse konfiguratsiooni üksikasjad
rdc config show [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--reveal | Kuva tundlike väärtuste lihttekst (ainult interaktiivselt) | Ei | - |
1.5 current
Näita aktiivset konfiguratsiooni: nimi, fail, lahendatud server ja kanal, tõendi olek
rdc config current
1.6 delete
Kustuta konfiguratsioonifail
rdc config delete <name>
1.7 set
Määra vaikeväärtus (meeskond, piirkond, sild)
rdc config set <key> <value>
1.8 clear
Tühjenda vaikeväärtused (kõik või konkreetne võti)
rdc config clear [key]
1.9 recover
Taasta konfiguratsioon varukoopifailist (.bak)
rdc config recover [name] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
1.10 ssh
Halda SSH-võtme konfiguratsiooni
set
Määra SSH-võti praeguse konfiguratsiooni jaoks
rdc config ssh set [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--key <path> | Tee SSH-privaatvõtme failini | Jah | - |
--embed | Manusta võtme sisu konfiguratsiooni tee asemel | Ei | - |
show
Kuva praegune SSH-võtme konfiguratsioon
rdc config ssh show
remove
Eemalda SSH-võti praegusest konfiguratsioonist
rdc config ssh remove
1.11 remote
Halda kaugsalvestuse konfiguratsiooniühendust
enable
Seo see konfiguratsioon kaugega krüpteeritud salvestusega
rdc config remote enable [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--headless | Kasuta seadmekoodi voogu (päiseta serveritele) | Ei | - |
--password | Registreeru pealevaatamiseta eelnevalt jagatud password slot'iga (ilma brauserita) | Ei | - |
--api-url <url> | Kontoserveri URL | Ei | - |
--force | Asenda erinev kohalik sisu serveri koopiaga ilma kinnituseta | Ei | - |
disable
Katkesta ühendus kaugsalvestusega ja salvesta konfiguratsioon kohalikult
rdc config remote disable
status
Kuva kaugühenduse olek
rdc config remote status
refresh
Sunni konfiguratsiooni uuesti toomist kaugsalvestusest
rdc config remote refresh
1.12 field
Osutiga adresseeritud konfiguratsioonivälja toimingud (get/set/unset/rotate/list). JSON-osutid (RFC 6901) nagu /credentials/cfDnsApiToken.
get
Loe üks konfiguratsiooni väärtus JSON-osuti kaudu. Tundlikud väljad on peidetud, välja arvatud --reveal (ainult inimestele).
rdc config field get [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--pointer <pointer> | JSON-osuti väljale (nt /credentials/cfDnsApiToken) | Jah | - |
--reveal | Kuva tundlike väärtuste lihttekst (ainult interaktiivne TTY; auditeeritakse) | Ei | - |
--digest | Trüki SHA-256 räsi väärtuse asemel (ohutu agentidega jagamiseks) | Ei | - |
set
Kirjuta konfiguratsiooni väärtus JSON-osutil. Tundlikud teed nõuavad --current (teadmisvärav).
rdc config field set [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--pointer <pointer> | JSON-osuti väljale (nt /credentials/cfDnsApiToken) | Jah | - |
--new <value> | Uus väärtus (parsitakse JSON-ina, kui näeb välja nagu JSON: {, [, ", true/false/null/number) | Jah | - |
--current <value> | Praegune lihttekstiline väärtus -- nõutav tundlike teede mutatsioonide jaoks (teadmisvärava tõend) | Ei | - |
unset
Kustuta konfiguratsiooni väärtus JSON-osutil. Tundlikud teed nõuavad --current.
rdc config field unset [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--pointer <pointer> | JSON-osuti väljale (nt /credentials/cfDnsApiToken) | Jah | - |
--current <value> | Praegune lihttekstiline väärtus -- nõutav tundlike teede kustutamiseks | Ei | - |
rotate
Pööra tundlik väärtus ilma --current liputa. Ainult interaktiivne TTY; auditeeritakse häälekalt.
rdc config field rotate [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--pointer <pointer> | JSON-osuti tundlikule väljale (nt /credentials/cfDnsApiToken) | Jah | - |
--new <value> | Uus väärtus | Jah | - |
list
Loetle kõik registreeritud tundlikkusosuti mallid koos liigi ja kinnitamis/krüpteerimispoliitikaga.
rdc config field list [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--sensitive | Kuva ainult tundlikud (mitte-avalikud) mallid | Ei | - |
1.13 edit
Ava aktiivne konfiguratsioon $EDITOR-is maskeeritud JSONC-projektsioonina. Ainult inimestele; agentidel keelatud.
rdc config edit [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--reveal | Kuva tundlike väärtuste lihttekst (ainult interaktiivne TTY; auditeeritakse) | Ei | - |
--dump | Trüki praegune konfiguratsioon JSONC-na stdout-i (ainult lugemiseks; ohutu agentidele maskeerimisel) | Ei | - |
--apply <file> | Rakenda redigeeritud JSONC-fail (jätab $EDITOR käivitamise vahele) | Ei | - |
--current-secrets <file> | JSON-fail, mis vastendab osuti→vana lihtteksti teadmisvärava jaoks --apply puhul | Ei | - |
--editor <cmd> | Redaktori käsu tühistamine (järgib git-prioriteeti: lipp > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR) | Ei | - |
1.14 audit
Vaata konfiguratsiooni auditilogi (räsiaheldatud JSONL asukohas ~/.config/rediacc/audit.log.jsonl)
log
Trüki hiljutised auditikirjed JSON-ina
rdc config audit log [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--since <spec> | Kuva ainult kirjed, mis on uuemad (nt '24h', '7d', ISO ajatempel) | Ei | - |
--path <glob> | Filtreeri JSON-osuti globi järgi (nt /credentials/*) | Ei | - |
--actor <kind> | Filtreeri osaleja liigi järgi (human|agent) | Ei | - |
tail
Voogedasta uued auditikirjed kirjutamisel (Ctrl+C peatamiseks)
rdc config audit tail
verify
Kinnita SHA-256 räsiahela terviklikkus kõigi auditikirjete üleselt
rdc config audit verify
1.15 reconcile
Ehita töötamisaegne olek uuesti masina tõe põhjal. Parandab aegunud ühendus- ja marsruutimisandmed.
rdc config reconcile [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--machine <m...> | Piira tasakaalustamine nende masinatega | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
--accept-observed | Kirjuta deklareeritud asukoht ümber vastavaks image'i tegelikule asukohale, kuid ainult siis, kui see on ühemõtteline (täheldatud täpselt ühel masinal). Duplikaadid jäävad konfliktideks. | Ei | - |
1.16 rotate-cek
Rotatsioon organisatsiooni konfiguratsiooni krüpteerimisvõtme jaoks
rdc config rotate-cek [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--api-url <url> | Kontoserveri URL | Ei | - |
2. Andmehoidla haldus
Nimega salvestuspuulid, mis hoiavad hoidlaid. Andmehoidla on liigutatav (ühenda see masinaga, liiguta teisele) ja üheühenduseline (täpselt üks masin hoiab seda korraga). Iga masina kaudset vaikimisi andmehoidlat siin ei hallata.
2.1 resize
Kasvata või kahanda andmehoidlat. See on võrguühenduseta toiming: selles olevad hoidlad tuleb peatada.
rdc datastore resize <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--size <size> | Uus suurus (nt 200G) | Jah | - |
--debug | Luba silumisväljund | Ei | - |
2.2 fork
Forgi andmehoidla copy-on-write viisil. Fork on hetkeline ja selle kulu ei kasva koos puuli suurusega. Vajab rbd-taustaprogrammi: local-andmehoidlal puudub plokitaseme kloon, seega forgivad selle sees olevad hoidlad selle asemel ükshaaval reflinki kaudu (rdc repo fork).
rdc datastore fork <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--tag <tag> | Forgi silt (tulemus on name:tag) | Jah | - |
--attach-to <machine> | Ühenda fork kohe selle masinaga (vajab lippu --writes) | Ei | - |
--writes <disposition> | Kuhu forgi kirjutused lähevad: local (hetkeline, ajutine) või ceph (püsiv kloon) | Ei | - |
--cow-size <size> | Ülekatte suurus lipu --writes local jaoks | Ei | - |
--debug | Luba silumisväljund | Ei | - |
2.3 status
Näita üht andmehoidlat: selle taustaprogrammi, ühendust, kasutust, hoidlaid ja hetktõmmiseid. Lahtiühendatud andmehoidla annab endiselt oma kirje teada.
rdc datastore status <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
2.4 create
Loo täiendav nimega andmehoidla masinal. Local-taustaprogramm on failipõhine puul sellel masinal ja jääb sinna. Rbd-taustaprogramm elab Cephis, seega saab see liikuda igale masinale, mis pääseb ligi samale klastrile. Anna --cluster, et muuta see Kubernetese-maailma andmehoidlaks; see tagasiviide on loomisel fikseeritud.
rdc datastore create <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masin, millele andmehoidla luua | Jah | - |
--size <size> | Andmehoidla suurus (nt 100G) | Jah | - |
--backend <type> | Salvestuse taustaprogramm: local (failipõhine, jääb sellele masinale) või rbd (Ceph, liigutatav) | Ei | local |
--pool <name> | Ceph-puul rbd-taustaprogrammi jaoks (vaikimisi: rbd) | Ei | - |
--image <name> | RBD-pildi nimi rbd-taustaprogrammi jaoks (vaikimisi: andmehoidla nimi) | Ei | - |
--cluster <name> | Kubernetese klaster, millesse see andmehoidla kuulub. Määratuna tähendab see ainult Kubernetese hoidlaid; määramata jätmine tähendab ainult Dockeri hoidlaid. Fikseeritud loomisel. | Ei | - |
--debug | Luba silumisväljund | Ei | - |
2.5 list
Loetle nimega andmehoidlad, kus need on ühendatud ja mida need sisaldavad.
rdc datastore list [place]
2.6 attach
Ühenda andmehoidla masinaga. Täpselt üks masin hoiab andmehoidlat korraga, seega selle ühendamine mujale liigutab selle: vana hoidja loobub sellest esmalt ning ebaõnnestunud üleandmine jätab algse ühenduse puutumata. Fork peab ütlema, kuhu selle kirjutused lähevad.
rdc datastore attach <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--to <machine> | Masin, millega andmehoidla ühendada | Jah | - |
--writes <disposition> | Kuhu forgi kirjutused lähevad: local (hetkeline, ajutine, kaob lahtiühendamisel) või ceph (püsiv kloon puulis). Forgi jaoks kohustuslik. | Ei | - |
--cow-size <size> | Ülekatte suurus lipu --writes local jaoks | Ei | - |
--no-auto | Ära ühenda seda andmehoidlat buutimisel automaatselt uuesti | Ei | - |
--force | Tõkesta (fence) aegunud hoidja, kes ei loobunud andmehoidlast puhtalt | Ei | - |
--debug | Luba silumisväljund | Ei | - |
2.7 detach
Ühenda andmehoidla masinast lahti. Selles olevad hoidlad peatatakse esmalt. Fork, mis on ühendatud lipuga --writes local, ei saa oma ülekatet kuhugi tagasi kirjutada, seega selle lahtiühendamine viskab ülekatte ära ja vajab lippu --discard.
rdc datastore detach <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--discard | Viska ära local-kirjutustega fork ja selle ülekate. Andmed ei ole taastatavad. | Ei | - |
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
2.8 snapshot
Tee ja loetle andmehoidla ajahetke hetktõmmiseid. Hetktõmmis ei maksa seistes midagi ja sellest fork kloonitakse.
create
Tee andmehoidlast ajahetke hetktõmmis. Midagi ei peatata. Hetk on avarii-järjekindel, mitte rakenduse-järjekindel: kui vajad, et konkreetne kirjutus jõuaks hetktõmmisesse, sünkroniseeri see enne.
rdc datastore snapshot create <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--snapshot <label> | Hetktõmmise silt (vaikimisi: UTC ajatempel) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
list
Loetle andmehoidla hetktõmmised.
rdc datastore snapshot list <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
2.9 delete
Hävita andmehoidla ja kõik selle sisu. See ühendatakse esmalt lahti; kui see ei õnnestu puhtalt, kustutamine ebaõnnestub, selle asemel et jätta ühendatud puul orvuks.
rdc datastore delete <datastore> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--force | Kustuta ka siis, kui hoidlad viitavad ikka sellele. Nende andmed kaovad koos sellega. | Ei | - |
--debug | Luba silumisväljund | Ei | - |
3. Masina haldus
Vaatab kaugmasina olekut: süsteemi ressursid, töötavad konteinerid, systemd teenused, juurutatud repositooriumid ja tervisediagnostika. Ainult lugemiseks; repositooriumide muutmiseks kasuta `repo`. Peamised alamkomandod: status (täisolek, kitsendatav lippudega --system, --containers, --repositories, --services), health, list, add, remove, setup, prune, provision, deprovision.
3.1 list
Loetleb masinaid
rdc machine list [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--search <text> | Otsi väljalt {{field}} | Ei | - |
--sort <field> | Sorteeri välja järgi | Ei | - |
--desc | Sorteeri kahanevas järjekorras | Ei | - |
3.2 health
Kontrollib masina seisundit CI/CD torujuhtmete jaoks
Tervisekäsk väljastab süsteemi mõõdikud, konteinerite oleku, teenuste stabiilsuse ja salvestusteabe -- kasulik CI/CD torujuhtmete kontrollideks.
rdc machine health <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-t, --team <name> | Meeskonna nimi | Ei | - |
3.3 provision
Juurutab uue masina pilveseadmel OpenTofu abil
rdc machine provision <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--provider <name> | Pilvepakkuja nimi (käsust machine provider add) | Jah | - |
--region <region> | Tühistab vaikimisi piirkonna | Ei | - |
--type <type> | Tühistab vaikimisi eksemplari tüübi | Ei | - |
--image <image> | Tühistab vaikimisi OS-pildi | Ei | - |
--ssh-user <user> | SSH-kasutajanimi uuele VM-ile (vaikimisi: root) | Ei | - |
--base-domain <domain> | Infrastruktuuri baasdomeen (nt example.com). Eeldab --infra | Ei | - |
--no-infra | Jätab infrastruktuuri konfiguratsiooni vahele (puhverserver + DNS) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
3.4 deprovision
Hävitab pilves ettevalmistatud masina ja eemaldab konfiguratsioonist
rdc machine deprovision <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--force | Jäta kinnitusviip vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
3.5 prune
Eemaldab orvu jäänud andmesalve ressursid ja aegunud hetktõmmised masinalt. Põhikäivitus koristab renet-i sisemised andmesalve artefaktid (BTRFS-i alamköited, lukufailid, tmpfailid). Allpool olevad valikulised lipud võimaldavad progressiivselt kitsamaid repositooriumide koristusi: --orphaned-repos kasutab kohalikku CLI konfiguratsiooni ainsa signaalina, samas kui --prune-unknown konsulteerib lisaks renet-i .interim/state peeglit, nii et teiste tööriistade loodud seaduslikud forkid säilivad isegi siis, kui need puuduvad kohalikust konfiguratsioonist. Mõlemad kustutamisteed käivitavad ühendusohutuse eelkontrolli; edastage --force-delete-mounted selle tühistamiseks.
rdc machine prune <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--dry-run | Näitab, mida eemaldataks, ilma muudatusi tegemata | Ei | - |
--orphaned-repos | Kustutab kõik masina repositooriumipildid, mis pole kohalikus CLI konfiguratsioonis. Jäme -- eemaldab ka teiste tööriistade loodud forkid, millel pole kohaliku konfiguratsiooni kirjet, isegi kui nende renet peegel tuvastab neid õigesti forkidena. Kasuta --prune-unknown kitsama käitumise jaoks, mis arvestab peeglisse. | Ei | - |
--prune-unknown | Kustutab ainult repositooriumeid, mida renet-i .interim/state peegel ei suuda klassifitseerida (pole kohalikus konfiguratsioonis JA puudub fork-märgistusega peegel). Rangelt kitsam kui --orphaned-repos: forkid ilma konfiguratsioonita säilitatakse, kui peegel neid tuvastab. Nii eelpeegelalised pärandorpad kui ka käsitsi kustutatud grand-repositooriumid kuuluvad sellesse kategooriasse. | Ei | - |
--force-delete-mounted | Tühistab ühendusohutuse eelkontrolli ja kustutab repositooriumid isegi siis, kui need on praegu ühendatud või neil on töötavad Dockeri konteinerid. Erineb lipust --force (mis tühistab ainult arhiivi ooteperioodi). Kehtib nii --orphaned-repos kui ka --prune-unknown puhul. | Ei | - |
--force | Jäta kinnitusviibad vahele | Ei | - |
--grace-days <days> | Hiljuti arhiveeritud repode armuaeg päevades (vaikimisi: 7) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
3.6 add
Lisa masin praegusesse konfiguratsiooni. Skannib automaatselt SSH-hostivõtmeid. Pärast lisamist käivita: config machine setup <nimi>
rdc machine add <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--ip <address> | Masina IP-aadress või hostinimi | Jah | - |
--user <username> | SSH-kasutajanimi | Jah | - |
--port <port> | SSH-port | Ei | 22 |
3.7 infra
Halda infrastruktuuri konfiguratsiooni (puhverserver, DNS, sertifikaadid)
cert
Halda vahemällu salvestatud TLS-sertifikaate
Eemalda sertifikaadi vahemälu
rdc machine infra cert clear
Laadi TLS-sertifikaadid masinalt alla ja vahemällu
rdc machine infra cert pull <machine> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--no-prune | Jäta vanade võrgu-ID sertifikaatide puhastamine vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
Laadi vahemällu salvestatud TLS-sertifikaadid masinale üles
rdc machine infra cert push <machine> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
Kuva vahemällu salvestatud sertifikaatide inventuur
rdc machine infra cert status
push
Lükka infrastruktuuri konfiguratsioon masinale (Traefik-puhverserver, marsruuter, Cloudflare DNS). Käivita kõigepealt 'machine infra set <machine>'
rdc machine infra push <machine> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
set
Määra masina infrastruktuuri konfiguratsioon (masina-spetsiifilised: IP-d, domeen, pordid; ühised: sertifikaadi e-post, CF DNS-tõend)
rdc machine infra set <machine> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--public-ipv4 <ip> | Avalik IPv4-aadress (masina-spetsiifiline) | Ei | - |
--public-ipv6 <ip> | Avalik IPv6-aadress (masina-spetsiifiline) | Ei | - |
--base-domain <domain> | Rakenduste baasdomeen (masina-spetsiifiline) | Ei | - |
--cert-email <email> | E-posti aadress TLS-sertifikaadi teadete jaoks (ühine kõigile masinatele) | Ei | - |
--cf-dns-token <token> | Cloudflare DNS API tõend ACME DNS-01 väljakutse jaoks (ühine kõigile masinatele) | Ei | - |
--tcp-ports <ports> | Edastatavad TCP-pordid (komaga eraldatud, nt 25,143,465) | Ei | - |
--udp-ports <ports> | Edastatavad UDP-pordid (komaga eraldatud, nt 53) | Ei | - |
show
Kuva masina infrastruktuuri konfiguratsioon
rdc machine infra show <machine>
3.8 provider
Halda pilveteenusepakkujaid masinate automaatprovisionimiseks
add
Lisa pilveteenusepakkuja
rdc machine provider add <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--provider <source> | Teadaolev pakkujaallikas (nt linode/linode, hetznercloud/hcloud) | Ei | - |
--source <source> | Kohandatud OpenTofu pakkujaallikas (nt vultr/vultr) | Ei | - |
--token <token> | API-tõend pilveteenusepakkujale | Jah | - |
--region <region> | Vaikimisi piirkond uutele masinatele | Ei | - |
--type <type> | Vaikimisi instantsi tüüp/suurus | Ei | - |
--image <image> | Vaikimisi OS-kujutis | Ei | - |
--ssh-user <user> | SSH-kasutajanimi uutele virtuaalmasinatele (vaikimisi: root) | Ei | - |
--resource <type> | Kohandatud: OpenTofu ressursitüüp virtuaalmasinale | Ei | - |
--label-attr <attr> | Kohandatud: virtuaalmasina sildi atribuudi nimi | Ei | - |
--region-attr <attr> | Kohandatud: piirkonna atribuudi nimi | Ei | - |
--size-attr <attr> | Kohandatud: instantsi tüübi atribuudi nimi | Ei | - |
--image-attr <attr> | Kohandatud: OS-kujutise atribuudi nimi | Ei | - |
--ipv4-output <attr> | Kohandatud: IPv4-aadressi väljundatribuut | Ei | - |
--ipv6-output <attr> | Kohandatud: IPv6-aadressi väljundatribuut | Ei | - |
--ssh-key-attr <attr> | Kohandatud: SSH-võtmete atribuudi nimi | Ei | - |
--ssh-key-format <format> | Kohandatud: SSH-võtme vorming (inline_list või resource_id) | Ei | - |
--ssh-key-resource <type> | Kohandatud: OpenTofu ressursitüüp SSH-võtmetele | Ei | - |
list
Loetle seadistatud pilveteenusepakkujad
rdc machine provider list
remove
Eemalda pilveteenusepakkuja konfiguratsioon
rdc machine provider remove <name>
3.9 remove
Eemalda masin praegusest konfiguratsioonist
rdc machine remove <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--force | Eemalda masin ka siis, kui sellel on veel hoidlaid, jättes need asukohad ripakile. | Ei | - |
3.10 scan-keys
Skanni SSH-hostivõtmeid praeguse konfiguratsiooni masinatele
rdc machine scan-keys [name]
3.11 setup
Provisioni kaugmasin hoidlate jaoks (installib reneti, seadistab Dockeri, BTRFS andmehoidla). Idempotentne. Nõutav pärast käsku 'config machine add' ja enne käsku 'repo create'
rdc machine setup <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--datastore-path <path> | Andmehoidla tee kaugmasinal | Ei | /mnt/rediacc |
--datastore-size <size> | Andmehoidla suurus (nt 95%, 100G) | Ei | 95% |
--debug | Luba silumisväljund | Ei | - |
3.12 status
Näitab masina täisstaatust (infra, süsteem, repositooriumid nime/guid-iga, konteinerid repository/repository_guid/domain/autoRoute-iga, teenused repository/repository_guid-iga)
rdc machine status [name] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
--system | Lisa ainult süsteemiteave | Ei | - |
--repositories | Lisa ainult repositooriumid | Ei | - |
--containers | Lisa ainult konteinerid | Ei | - |
--services | Lisa ainult teenused | Ei | - |
--network | Lisa ainult võrguliidesed | Ei | - |
--block-devices | Lisa ainult plokkseadmed | Ei | - |
--licenses | Lisa repositooriumi litsentsistaatused | Ei | - |
--storage-health | Kuva BTRFS-fragmentatsioon ja reflink-säästud repositooriumi kohta | Ei | - |
--datastores | Näita ühendatud andmehoidlaid (haakimine, ühendus, kasutus) | Ei | - |
--health-check | Seisundikontrolli režiim - väljub koodiga 2, kui mõni on ebaterve | Ei | - |
--stability-check | Stabiilsuse kontrolli režiim - väljub koodiga 2, kui mõni on ebaõnnestunud/taaskäivitav | Ei | - |
--search <text> | Filtreeri repositooriumeid nime järgi | Ei | - |
--sync-certs | Tõmba pärast pärimist masinalt ka ACME-serdi vahemälu | Ei | - |
--strict | Välju mitte-nulliga (kood 2), kui mõni konteiner on ületanud tervisdriifti lävendi | Ei | - |
4. Klastrite haldus
Valmista ette ja halda klastreid: nimega sõlmepesade kogumeid (ceph, k8s-server, k8s-agent, hyperconverged) privaatvõrgus. Pesa liikmed materialiseeruvad masinateks, nii et iga -m käsk töötab nendega.
4.1 create
Deklareeri ja valmista ette klaster: masinad, Ceph-puulid ja Kubernetes. Anna --provider ja --pool, et deklareerida ühe sammuga; pelk create valmistab ette juba deklareeritud klastri.
rdc cluster create <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--provider <provider> | Pakkuja: cloudProviders-i võti või 'kvm' | Ei | - |
--pool <spec...> | Pesa spetsifikatsioon nimi:roll:arv[:suurus] (roll: ceph|k8s-server|k8s-agent|hyperconverged) | Ei | - |
--declare-only | Salvesta klaster konfiguratsiooni seda ette valmistamata | Ei | - |
--network-cidr <cidr> | Privaatvõrgu CIDR (nt 10.0.0.0/24) | Ei | - |
--network-primitive <primitive> | Võrgu primitiiv (nt vlan, vpc, network) | Ei | - |
--control-node <machine> | Selgesõnaline juhtsõlme masin (vaikimisi: esimene k8s-server liige) | Ei | - |
--net-name <name> | KVM: selle klastri libvirt-võrk (nt renet12) | Ei | - |
--net-base <prefix> | KVM: võrgu prefiks, esimesed kolm oktetti (nt 192.168.112) | Ei | - |
--net-offset <n> | KVM: nihe, mis lisatakse iga VM id-le aadressi tuletamisel | Ei | - |
--control-id <n> | KVM: juht- ja registrisõlme VM id (vaikimisi: 1) | Ei | - |
--docker-registry <endpoint> | KVM: selle klastri Docker registri lõpp-punkt VM-i sees | Ei | - |
--ssh-user <user> | SSH-kasutaja ette valmistatud liikmete jaoks | Ei | - |
--base-domain <domain> | Klastri avaliku DNS-i alusdomeen (muidu päritud kõrvalmasinast) | Ei | - |
--control-ds-size <size> | Ankru juhtandmesalve suurus (vaikimisi 10G) | Ei | - |
--control-ds-backend <backend> | Ankru juhtandmesalve taustaprogramm: local | ceph (vaikimisi: ceph, kui klastril on ceph, muidu local) | Ei | - |
--control-ds-pool <pool> | Ceph rbd pool ankru juhtandmesalve jaoks (ceph taustaprogramm) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
4.2 status
Loetle kõik klastrid või kuva ühe klastri täielik konfiguratsioon lipuga --name.
rdc cluster status [cluster]
4.3 scale
Muuda pesa liikmete arvu (lisab/eemaldab masinaid ning ühendab/tühjendab sõlmi). k8s-agent pesad skaleeruvad kohapeal; ceph pesa kasv toimub otse cephadm kaudu.
rdc cluster scale <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--pool <pool> | Pesa nimi | Jah | - |
--count <n> | Soovitud liikmete arv | Jah | - |
--debug | Luba silumisväljund | Ei | - |
4.4 destroy
Lammuta ette valmistatud liikmed ja eemalda klaster ning selle masinad konfiguratsioonist.
rdc cluster destroy <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--force | Jäta kinnitus vahele ja jätka hoolimata lammutamise vigadest | Ei | - |
--debug | Luba silumisväljund | Ei | - |
4.5 kubeconfig
Too kubeconfig klastri juhtsõlmest SSH kaudu ja puhverda see kohalikult (0600) kubectl jaoks.
rdc cluster kubeconfig <cluster>
4.6 fork
Kloonida terve klaster, sealhulgas selle repode andmed, uude klastrisse: klastri- ja PV-piltide koordineeritud copy-on-write, seejärel sõlme identiteedi ümberkirjutamine, nii et fork tõuseb uutel aadressidel. Originaal jätkab töötamist.
rdc cluster fork <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--tag <tag> | Fork'i silt | Jah | - |
--to <dest-cluster> | Sihtklaster, mille sõlmed majutavad forki (selle juhtsõlm ja agendid; klaster ei saa forkida oma masinatele, kuna kaks k3s-i ei saa jagada hosti võrgu nimeruumi) | Jah | - |
--writes <disposition> | Forgi kirjutusrežiim: local (ajutine dm-COW ülekate, null mõju Cephile) | ceph (püsiv kloon). Vaikimisi local | Ei | - |
--up | Juuruta forgitud hoidlad ja kontrolli klastri tervist väravana pärast forgi käivitumist | Ei | - |
--debug | Luba silumisväljund | Ei | - |
4.7 migrate
Liiguta terve klaster, sealhulgas selle repode andmed, teise masinasse või andmekeskusesse lühikese ülemineku ajaga (kuum eelkoopia, seejärel peata-ja-taaskäivita sihtkohas).
rdc cluster migrate <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--to <dest-cluster> | Sihtkoht | Jah | - |
--debug | Luba silumisväljund | Ei | - |
4.8 join
Liida olemasolev registreeritud masin klastri Kubernetese agentsõlmena, kasutades sama CA-lt tuletatud liitumistokenit, mida kasutatakse ankurdamisel ja taasliitumisel.
rdc cluster join <machine> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--cluster <name> | Klaster, millega masin liidetakse | Jah | - |
--debug | Luba silumisväljund | Ei | - |
4.9 evict
Tühjenda sõlm, kustuta selle Node objekt ja eemalda selle klastriliikmesus. Klaster tuletatakse masinast; masin, mis endiselt haagib andmesalve, lükatakse tagasi.
rdc cluster evict <machine> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--force | Jäta tühjendamine vahele, kui sõlm on juba maas | Ei | - |
--debug | Luba silumisväljund | Ei | - |
4.10 rehearse
Proovi väljalasget/uuendust: forgi klaster sihtkohta ajutise äravisatava eksemplarina (writes=local, saladusteta roll: rehearsal), käivita see, kontrolli selle tervist väravana ning seejärel kõrvalda. Originaali ei puudutata kunagi.
rdc cluster rehearse <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--on <dest-cluster> | Sihtklaster, kuhu äravisatav proov käivitatakse | Jah | - |
--tag <tag> | Valikuline silt prooviforgi jaoks (vaikimisi: ajatempel) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
4.11 snapshot
Kogu klastri ajahetke hetktõmmised. Üks avarii-järjekindel hetk üle kõigi klastri omanduses olevate rbd-põhiste andmehoidlate, mis võetakse Cephi rühmasnapshoti kaudu: miski ei peatu ja klaster ei märka seda kunagi. Local-taustaprogrammiga andmehoidlatel puudub plokitaseme rühmaprimitiiv, seega jäävad need hetkest välja ja neist teatatakse vastavalt. Hetk on avarii-järjekindel, mitte rakenduse-järjekindel: kui vajad, et konkreetne kirjutus jõuaks hetktõmmisesse, sünkroniseeri see enne.
create
Tee hetktõmmis igast rbd-põhisest andmehoidlast klastris ÜHEL hetkel. Midagi ei peatata. Iga local-taustaprogrammiga andmehoidla klastris on loetletud selle hetke väliseks: see ei ole hetktõmmise osa. Hetk on avarii-järjekindel, mitte rakenduse-järjekindel: kui vajad, et konkreetne kirjutus jõuaks hetktõmmisesse, sünkroniseeri see enne.
rdc cluster snapshot create <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--snapshot <label> | Hetktõmmise silt (vaikimisi: UTC ajatempel) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
list
Loetle klastri rühmasnapshotid.
rdc cluster snapshot list <cluster> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
5. MCP-server
Paljastab CLI-i mudeli kontekstiprotokollina (MCP) AI agentidega integreerimiseks. Server pakib CLI komandod MCP tööriistadeks struktureeritud JSON-sisendi/väljundiga. Peamine alamkomando: serve (käivitab stdio-põhise MCP serveri).
5.1 serve
Käivitab MCP serveri (stdio transport)
rdc mcp serve [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--config <name> | Konfiguratsioonifaili nimi kõigi komandode jaoks | Ei | - |
--timeout <ms> | Vaikimisi komando aegumine millisekundites | Ei | 120000 |
6. Repositooriumi elutsükkel
Juuruta ja halda krüpteeritud hoidlaid masinatel. Peamised alamkomandod: create, up (juuruta), down (peata), fork (hetkeline CoW-kloon), delete, push/pull (varukoopia), sync (failide ülekanne). Elutsükkel: repo create → repo up → repo down. Vaata arhitektuuri, marsruutimise ja keskkonna muutujate üksikasju käsuga rdc --help.
6.1 up
Juuruta või uuenda hoidlat (haagi külge, käivita Rediaccfile up, mis kutsub välja renet compose). Masin tuletatakse viite asukohast. Puhverserveri marsruudid muutuvad pärast juurutamist aktiivseks umbes 3 sekundiga. Lõppedes kuvab HTTP-teenuste URL-mustri (silt rediacc.service_port). Esmakordne juurutamine ja forgid haagitakse automaatselt. CRIU kontrollpunkti taastamine tuvastatakse automaatselt; kasuta --skip-checkpoint, et sundida värsket käivitust. Kasuta --all --machine <m>, et juurutada iga hoidla masinal.
rdc repo up [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--no-start | Haagi hoidla külge ja valmista ette ilma selle up() sammeta käivitamata (koondab endasse pensionile jäänud 'repo mount'; LUKS avamine ja, klastri hoidlate puhul, PV genereerimine). | Ei | - |
--skip-checkpoint | Jäta CRIU kontrollpunkti taastamine vahele isegi kui kontrollpunkti andmed on olemas (sundi värske käivitus) | Ei | - |
--tls | Taotle sellele hoidlale eraldi TLS-sertifikaati (forkid kasutavad vaikimisi masina ühist sertifikaati) | Ei | - |
--no-wait | Naaseb, kui konteinerid on käivitatud; tervisekontrollid jätkuvad taustal | Ei | - |
--all | Juuruta iga hoidla, mille kodu on --machine (pakkvorm) | Ei | - |
-m, --machine <name> | Koos lipuga --all: masin, mille hoidlate vastu pakktoiming käivitatakse | Ei | - |
--include-forks | Haagi külge ja käivita ka forkitud hoidlad | Ei | - |
--parallel | Käivita hoidlad samaaegselt | Ei | - |
--concurrency <n> | Maksimaalne samaaegsete hoidlate arv (vaikimisi: 3) | Ei | 3 |
-y, --yes | Jäta pakkoperatsioonide kinnitamine vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
6.2 down
Peata hoidla Docker-konteinerid (käivitab Rediaccfile down läbi renet compose). Masin tuletatakse viite asukohast. EI haagi lahti krüpteeritud mahtu -- hoidla jääb haagituks ja seda saab taaskäivitada käsuga 'repo up'. Kasuta --unmount, et sulgeda pärast peatamist ka LUKS-konteiner (koondab endasse pensionile jäänud 'repo unmount'). Kasuta --checkpoint, et salvestada CRIU protsessiseisund enne peatamist (järgmine 'repo up' taastab automaatselt). Kasuta --all --machine <m>, et peatada iga hoidla masinal.
rdc repo down [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--unmount | Haagi ka pärast peatamist lahti (sulge LUKS-konteiner). Nõutav enne käsku 'repo resize' või mahu täielikuks turvamiseks | Ei | - |
--checkpoint | Loo CRIU kontrollpunkt enne peatamist (salvesta protsessi mäluseisund hilisemaks taastamiseks käsuga 'repo up') | Ei | - |
--all | Peata iga hoidla, mille kodu on --machine (pakkvorm) | Ei | - |
-m, --machine <name> | Koos lipuga --all: masin, mille hoidlate vastu pakktoiming käivitatakse | Ei | - |
--parallel | Käivita hoidlad samaaegselt | Ei | - |
--concurrency <n> | Maksimaalne samaaegsete hoidlate arv (vaikimisi: 3) | Ei | 3 |
-y, --yes | Jäta pakkoperatsioonide kinnitamine vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
6.3 status
Hangi hoidla olek (haakimisseisund, Docker-daemoni töötamine, konteinerite arv, kettakasutus)
rdc repo status <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.4 cat
Loe piiratud aken failist hoidla sees ja kirjuta see stdout-i (piiramine toimub serveripoolselt; diagnostika läheb stderr-i)
rdc repo cat <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--remote-file <path> | Loetava faili tee, suhteliselt hoidla ühenduspunkti juurest | Jah | - |
--max-bytes <n> | Maksimaalne loetavate ja prinditavate baitide arv (vaikimisi 1 MiB, ülemine piir 50 MiB) | Ei | - |
--offset <n> | Baidinihe, millest alustada lugemist | Ei | - |
--head <lines> | Prindi ainult esimesed N rida (ei saa kombineerida baidivahemikuga) | Ei | - |
--tail <lines> | Prindi ainult viimased N rida (ei saa kombineerida baidivahemikuga) | Ei | - |
--stat | Prindi ainult suurus, tüüp ja muutmisaeg; sisu ei loeta | Ei | - |
--force-binary | Luba binaarse (NUL-i sisaldava) sisu lugemine | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.5 diff
Git-stiilis failitaseme erinevus kahe kopeeri-kirjutamisel forkitud hoidla vahel. Teatab lisatud, muudetud, kustutatud ja ümbernimetatud failidest. Võrdleb --name (sihtmärk/uus pool) antud hoidlat selle vanemaga, mis on lahendatud kohalikust seadistusest, või selgesõnalise --base hoidlaga (alus/vana pool). Ainult metaandmed ja suurusest sõltumatu: võrdleb krüptitud LUKS-tõmmiseid plokitasandil ilma dekrüpteerimata, nii et 1 GB ja 100 GB hoidlad võrdluvad sama millisekundi jooksul.
rdc repo diff <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--base <ref> | Hoidla, millega võrrelda (alus/vana pool); vaikimisi --name vanem | Ei | - |
--name-only | Prindi ainult muudetud failiteed, üks rea kohta (ilma olekutähtedeta) | Ei | - |
--stat | Näita failipõhise muutuse mahtu (baidi- ja plokierinevused) ja kogusummad | Ei | - |
--content [path] | Näita ühtlustatud tekstierinevust ühe faili kohta (vajab failiteed) | Ei | - |
--fast | Usu plokifiltrit; jäta sisuhashi kinnitus vahele (võib „Muudetut“ üle teatada) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.6 list
Loetle masina hoidlad
rdc repo list [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Ei | - |
--datastore <name> | Loetle selle andmehoidla hoidlad (lahendatud selle masina järgi, mis seda praegu hoiab) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.7 create
Loo uus hoidla. Määra selle kodu üks kord: masin või andmehoidla.
rdc repo create <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Ei | - |
--datastore <name> | Nimega andmehoidla, mis hoiab repot (Dockeri tasandamine, või klastri vorm) | Ei | - |
--size <size> | Hoidla suurus (nt 10G, 100G, 1T) | Ei | - |
--no-docker | Jäta Docker-daemoni käivitamine pärast loomist vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.8 delete
Kustuta hoidla ja selle andmed. Konfiguratsioonikirje säilib; kasuta --archive-config, et taastamiseks liigutada mandaadid deletedRepositories-i käsuga 'repo admin archive restore'. Võtab positsioonilise <ref>; pelk nimi lahendub grand-reale ja lükatakse tagasi, kui mitu hoidlat jagavad baasnime, seega anna forgi sihtimiseks name:tag.
rdc repo delete <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--archive-config | Teisalda konfiguratsioonikirje deletedRepositories-i hilisemaks taastamiseks | Ei | - |
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
6.9 commit
Külmuta haagitud töötava forki praegune olek uueks muutumatuks commit'iks (git-laadne). Commit salvestab oma sõnumi, autori, ajatempli ja vanema mahu sees (nii et see liigub kaasa push'iga) ning märgitakse kirjutuskaitstuks — see keeldub haakimisest. Töötav fork jätkab muutumatuna, nagu git jätab töökataloogi puutumata. Tee commit'ist kirjutatav koopia käsuga 'rdc repo checkout'.
rdc repo commit <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--message <msg> | Commit'i sõnum | Jah | - |
--author <author> | Commit'i autor | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.10 branch
Loo nimega branch-viide, mis osutab töötava forki praegusele commit'ile (selle tipule). Branch-viited asuvad CLI konfiguratsioonis (masin = objektihoidla, konfiguratsioon = viitehoidla).
rdc repo branch <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--branch <branch> | Uue haru nimi | Jah | - |
6.11 checkout
Reflink-klooni muutumatu commit (või branch'i tipp) värskesse kirjutatavasse töötavasse forki ja suuna HEAD sellele. Peaaegu silmapilkne ja konstantse ajaga (BTRFS reflink).
rdc repo checkout <commit-or-branch-ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--tag <name> | Uue kirjutatava töötava forki nimi | Jah | - |
--from <workingFork> | Lahenda positsiooniline argument <commit-or-branch-ref> selle töökahvli haru nimena | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.12 log
Prindi commit-ajalugu, mis on kättesaadav töötava forki praegusest commit'ist (või commit-viitest), käies läbi vanemate ahelat, mille salvestas 'rdc repo commit'. Loeb mahuvälist peegeldust, nii et ühtki commit'i ei avata.
rdc repo log <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
6.13 merge
Merge lähtecommit või fork sihtmärgiks olevasse töötavasse forki. Aktiivset sihtmärki ei muudeta kunagi kohapeal: tulemus ehitatakse reflink-kloonis ja vahetatakse aatomilises sammus sisse. Külgehaagitud või töötav sihtmärk lükatakse tagasi, kui ei kasutata --force, mis peatab selle enne korralikult. Ilma --resolve'ita on tegu kogu kujutise take-theirs'iga (sihtmärgist saab lähtekoodi koopia); valikuga --resolve ours|theirs on tegu failipõhise kolmepoolse merge'iga ühise eellase suhtes, mis võtab kummagi poole ainulaadsed muudatused ja lahendab kahepoolsed konfliktid lipu järgi.
rdc repo merge <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--from <source> | Lähtekoodi commit või fork, millest merge teha | Jah | - |
--force | Peata külgehaagitud/töötav sihtmärk enne ja seejärel merge (ei muuda kunagi aktiivset külgehaaki) | Ei | - |
| `—resolve <ours | theirs>` | Failipõhine konfliktide lahendamine kolmepoolsel merge'il: 'ours' säilitab sihtmärgi versiooni, 'theirs' võtab lähtekoodi oma. Jäta välja kogu kujutise fast-forward'i jaoks (take-theirs). | Ei |
--base <guid> | Ühise eellase commiti GUID kolmepoolse merge'i jaoks (kasutatakse koos --resolve'iga). Vaikimisi lähtecommiti vanem või sihtmärgi praegune commit. | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.14 gc
Kustuta masinal muutumatud commit-objektid, milleni ükski haru ega HEAD ei küüni (ligipääsetavuse GC). Masin on objektihoidla; CLI konfiguratsioon on viidahoidla. Vaikimisi kuiv käivitus: kustutamiseks anna --apply. Ei puuduta kunagi külgehaagitud objekti ega töötavat forki.
rdc repo gc [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
--apply | Kustuta ligipääsmatud commit'id päriselt (vaikimisi on kuiv eelvaade) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.15 fork
Loo hoidla CoW (Copy-on-Write) fork. FORK ON PEAAEGU HETKELINE JA KONSTANTSE AJAGA sõltumata hoidla suurusest -- BTRFS reflink kloonib alusel oleva kujutise nii, et 100 GB hoidla ja 1 GB hoidla forkitakse sama ~mõne sekundiga. Fork saab uue GUID-i, networkId, IP-vahemiku ja automaatse marsruudi domeeni ({service}-fork-{tag}.{repo}.{machine}.{baseDomain}) ning on täiesti iseseisev koopia. Onlainforkimine on toetatud, vanem võib jääda töötavaks. Fork pärib vanema krüpteerimismandaadid automaatselt. Kasuta --checkpoint, et jäädvustada CRIU protsessiseisund enne forkimist -- fork taastab selle automaatselt esimesel käsul 'repo up' (mäluseisund säilitatakse). RISTMASINA FORK: forgi kõigepealt kohalikult, seejärel kanna üle: (1) rdc repo fork <parent-ref> --tag <name>, (2) rdc repo push <fork-ref> --to <target-machine>, (3) rdc backup restore <fork-ref> --as <fork-name> -m <target-machine> --up. HOIATUS: ära kasuta ainult käsku "repo push" forkimiseks -- see loob sama GUID-iga toorkoopia (mitte iseseisva forki). Forgi alati kõigepealt uue identiteedi saamiseks. Automarsruudid kasutavad hoidla nime, nii et iga fork saab automaatselt kordumatu domeeni.
rdc repo fork <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--tag <name> | Forki silt (loob nime:silt) | Jah | - |
--checkpoint | Loo CRIU kontrollpunkt allikal enne forkimist (jäädvusta protsessi mäluseisund forgi taastamiseks) | Ei | - |
--immutable | Märgib kahvli kirjutuskaitstuks: see keeldub haakimisest ja hoiab oma tõmmist jäädavalt baidi tasemel stabiilsena (külmutatud commit/alus masinatevaheliseks delta-tõukeks) | Ei | - |
--up | Haagi külge ja käivita teenused pärast forkimist (fork + mount + up ühes käsus) | Ei | - |
--no-wait | Koos --up: naaseb kohe, kui konteinerid on käivitatud; tervisekontrollid jätkuvad taustal (ideaalne ühekordsete forkide jaoks) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.16 replicate
Loo N lugemisreplikat hoidlast sekunditega, sõltumata andmebaasi suurusest. Teeb ÜHE andmesalve snapshoti, seejärel N konstantse ajaga fork-attach'i (copy-on-write, äravisatavad kohalikud kirjutused), mis jaotatakse klastri sõlmede vahel, ning rakendab genereeritud ülekatte: üks kinnistatud PersistentVolume iga replika kohta, üks StatefulSet ja kaks Service'it ({repo}-rw primaarse poole ja {repo}-ro replikate poole). Replikad on AJAHETKE koopiad: replikatsioonivoogu ega read-your-writes-käitumist ei ole; iga replika teeb enne teenindamise algust ühe crash-recovery läbimise. Värskenda neid käsuga 'repo replicate refresh'. Replikakomplektid on hallatav olek: vaata 'repo replicate status' ja eemalda käsuga 'repo replicate remove'.
status
Kuva hallatavad replikakomplektid: replikad, majutavad sõlmed, forgitud andmesalved, snapshot ja värskendusajad.
rdc repo replicate status <ref>
remove
Eemaldab replikakomplekti: kustutab selle genereeritud k8s objektid (label'ite ulatuses), viskab ära selle forgitud andmesalved, kustutab selle snapshoti ja unustab oleku. Infrasammud on parima jõupingutuse põhimõttel, nii et eemaldamine koondub ka osaliselt kadunud klastril.
rdc repo replicate remove <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
refresh
Vii iga replika värskele ajahetke snapshotile üle, ÜKSHAAVAL: taaskäivita replika pod, viska ära ja forgi selle andmesalv sama tee all uuesti ning lase readiness'il see tagasi lubada. Ülejäänud N-1 replikat jätkab kogu protsessi vältel teenindamist.
rdc repo replicate refresh <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
6.17 canary
Käivita UUS pilt stabiilse kõrval ja jaga reaalaja liiklus nende vahel protsentuaalselt (väljalaske redeli 2. aste). Loob ühe canary Deployment'i + Service'i SAMADEL reaalaja andmetel (mitte fork: forgitud andmetel olevad canary kasutajad loeksid aegunud andmeid ja kirjutaksid hukule määratud koopiasse) ning käsib Rediacc proxy'l suunata sinna antud protsendi stabiilse hostinime liiklusest. Kaal 0 hoiab canary pimedana; kaal 100 on täielik blue/green vahetus. Enne iga canary muudatust tehakse klastri andmesalvedest automaatne rühmasnapshot (väljalaske redeli 0. aste) universaalse tagasivõtuna. Kahe versiooni skeemi ühilduvus (expand-contract) on rakenduse vastutusala. Skeemi LÕHKUVATE väljalasete puhul kasuta selle asemel blue/green meetodit: forgi hoidla (hetkeline, sisaldab andmeid), suuna forgi Service siia kaaluga 100 ja tee tagasipööramine puutumata vanema taaskäivitades; pärast vahetust tehtud kirjutused eksisteerivad ainult uues koopias, seega tagasipööramise ajaaken on põhimõtteline (policy) otsus.
status
Kuva hallatavad canary komplektid: kaal, pildid, stabiilne service ja viimane release-undo snapshot.
rdc repo canary status <ref>
weight
Muuda canary'le suunatud liikluse protsenti. Teeb kõigepealt uue release-undo rühmasnapshoti, seejärel rakendab ülekatte uuesti; proxy võtab uue jaotuse kasutusele oma järgmisel värskendustsüklil. Kaal 100 saadab kogu liikluse uude versiooni (blue/green vahetus).
rdc repo canary weight <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--weight <percent> | Protsent liiklusest, mis suunatakse canary'le (täisarv 0-100; 0 = pime, 100 = täielik üleminek) | Jah | - |
--debug | Luba silumisväljund | Ei | - |
remove
Eemaldab canary Deployment'i ja Service'i (label'ite ulatuses); stabiilne Service teenindab jälle 100% liiklusest. Release-undo snapshotid säilitatakse; kärbi neid andmesalve snapshoti käskudega.
rdc repo canary remove <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
create
Käivita UUS pilt stabiilse kõrval ja saada sellele protsent reaalaja liiklusest. Canary jagab hoidla reaalajas andmeid (mitte fork), seega on kahe versiooni skeemi ühilduvus rakenduse vastutusala. Klastri andmehoidlatest tehakse esmalt rühmasnapshot tagasivõtu jaoks.
rdc repo canary create <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--image <image> | Uus pilt, mida canary Deployment käitab (jagatud reaalandmetel) | Jah | - |
--port <port> | Port, mida rakendus teenindab (peab ühtima stabiilse Service'iga) | Jah | - |
--weight <percent> | Protsent liiklusest, mis suunatakse canary'le (täisarv 0-100; 0 = pime, 100 = täielik üleminek) | Jah | - |
--service <name> | Stabiilne Service, millega liiklust jagada (vaikimisi: hoidla nimi) | Ei | - |
--replicas <n> | Canary Deployment'i repliikide arv (vaikimisi: 1) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.18 resize
Muuda hoidla suurust võrguühenduseta (toetab nii kasvatamist kui vähendamist). Hoidla peab olema eelnevalt lahti haagitud (käsk 'repo down --unmount'). Nullkatkestusajaga kasvamiseks ilma peatamiseta kasuta hoopis käsku 'repo expand'
rdc repo resize <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--size <size> | Hoidla uus suurus (nt 10G, 100G, 1T) | Jah | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.19 expand
Laienda haagitud hoidlat onlainis (nullkatkestusaeg, ainult kasvatamine). Kasvatab LUKS-konteineri ja failisüsteemi, samal ajal jätkavad konteinerid tööd. Ei saa vähendada -- kasuta selleks käsku 'repo resize' (nõuab lahtihaakimist)
rdc repo expand <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--size <size> | Hoidla uus suurus (nt 10G, 100G, 1T) | Jah | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.20 trim
Vabasta andmehoidla puuli ruumi haagitud hoidlatest (võrgus, ilma seisakuta). Hoidlates kustutatud plokid tagastatakse puuli fstrim-iga. Ilma viiteta trimmitakse kõik haagitud hoidlad -m peal ja andmehoidla ise. Aktiivse varukoopiaga hoidlate puhul jäetakse fstrim vahele; --docker vabastamine töötab siiski
rdc repo trim [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--docker | Vabasta Dockeri ruum (seisatud konteinerid, ripakil pildid, ehitusvahemälu); töötab ka aktiivse varukoopia hetktõmmise ajal | Ei | - |
--docker-volumes | Eemalda lisaks kasutamata Dockeri köited | Ei | - |
--report-only | Näita discard-olekut ja taastatava ruumi hinnangut ilma trimmimata | Ei | - |
-m, --machine <name> | Sihtmasina nimi | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.21 policy
Haldab masina salvestushooldaja rakendatavat automaatset suurusepoliitikat: kasvatab hoidla kvooti võrgus, kui see täitub (mitte üle max-quota ega siis, kui puulis on ruumi vähe), ja käivitab plaanitud trimme. Automaatset vähendamist ei ole; selleks kasuta 'repo resize'. Ilma viiteta hallatakse masinaülest vaikepoliitikat -m peal
set
Määrab suurusepoliitika välju. Muudetakse ainult edastatud lippe; teised salvestatud väljad säilitavad väärtused. Automaatkasvu lubamine nõuab --max-quota: lagi on sinu selgesõnaline nõusolek puuli ülejaotuseks
rdc repo policy set [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--auto-grow <bool> | Luba kvoodi automaatne võrgus kasvatamine (true/false) | Ei | - |
--max-quota <size> | Automaatkasvu lagi (nt 200G); automaatkasvuks kohustuslik | Ei | - |
--grow-threshold <percent> | Failisüsteemi täituvus %, mis käivitab kasvu (vaikimisi 85) | Ei | - |
--grow-step <step> | Kasv sammu kohta: absoluutne (10G) või protsent kvoodist (20%) | Ei | - |
--auto-trim <bool> | Luba plaanitud trim (true/false) | Ei | - |
--trim-interval <hours> | Vähim tundide arv automaatsete trimmide vahel (vaikimisi 24) | Ei | - |
-m, --machine <name> | Sihtmasina nimi | Ei | - |
--debug | Luba silumisväljund | Ei | - |
get
Näitab salvestatud masina vaikeväärtust, hoidla ülekirjutust (viitega) ja hooldaja rakendatavat ühendatud kehtivat poliitikat
rdc repo policy get [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.22 push
Lükka hoidla kaugele (masin või salvestus). Sihtkoha tüüp tuvastatakse automaatselt konfiguratsioonist. Masinate vahelisel ülekandel kopeeritakse krüpteeritud hoidlakujutis SAMA GUID-iga -- see on varukoopia/migratsioon, mitte fork. Iseseisva forgi loomiseks kasuta kõigepealt 'repo fork' ja seejärel push. Lükatud koopia maandub varukoopia ARTEFAKTINA: käivita see sihtmasinal käsuga 'backup restore <ref> --as <name> -m <target> --up'
rdc repo push <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--to <remote> | Sihtkoha masina või salvestuse nimi (tuvastatakse automaatselt konfiguratsioonist) | Ei | - |
--to-machine <machine> | — | Ei | - |
--provision <provider> | Provisioni sihtmasina automaatselt pilveteenusepakkuja kaudu, kui seda ei eksisteeri | Ei | - |
--checkpoint | Loo CRIU kontrollpunkt enne varukoopiat (jäädvustab protsessi mäluseisundi otseülekandeks) | Ei | - |
--force | Sundi olemasoleva varukoopia ülekirjutamine | Ei | - |
-w, --watch | Jälgi muudatusi | Ei | - |
--bwlimit <limit> | Ribalaiuse piirang rsync-ülekandele (nt "6M", "10M") | Ei | - |
--delta-base <guid> | Muutumatu baas-GUID, mis on mõlemal masinal baidihaaval identne; kanna üle ainult muutunud plokid (masinasihtkoht). Jäta välja automaatse baasi jaoks | Ei | - |
--strategy <strategy> | Delta-baasi kasutamisel rakendatav plokidelta strateegia: auto, physical või shared | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.23 pull
Tõmba hoidla kaugelt (masin või salvestus). Jäta nimi välja, et tõmmata kõik hoidlad. Allika tüüp tuvastatakse automaatselt konfiguratsioonist. Kasuta --up, et juurutada pärast tõmbamist
rdc repo pull <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--from <remote> | Allika masina või salvestuse nimi (tuvastatakse automaatselt konfiguratsioonist) | Ei | - |
--from-machine <machine> | — | Ei | - |
--force | Sundi olemasoleva hoidla ülekirjutamine | Ei | - |
--up | Pärast tõmbamist haagi külge ja juuruta hoidla sellel masinal | Ei | - |
-w, --watch | Jälgi muudatusi | Ei | - |
--bwlimit <limit> | Ribalaiuse piirang rsync-ülekandele (nt "6M", "10M") | Ei | - |
--delta-base <guid> | Muutumatu baas-GUID, mis on mõlemal masinal baidihaaval identne; võta vastu ainult muutunud plokid (masinaallikas) | Ei | - |
--strategy <strategy> | Delta-baasi kasutamisel rakendatav plokidelta strateegia: auto, physical või shared | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.24 migrate
Migreeri hoidla elavalt ühelt masinalt teisele minimaalse seisakuajaga. Kaheetapiline rsync: mahtülekanne töö ajal, seejärel lühike peatus delta sünkroniseerimiseks. Liigutab kogu hoidla (marsruutimine suunatakse ümber uude asukohta) ning kustutab pärast kolimise õnnestumist lähte-image'id (kasuta --keep-source nende säilitamiseks). Toetab CRIU kontrollpunkti protsesside mäluseisundi migreerimiseks ja sihtmasinate automaatset provisjoneerimist
rdc repo migrate <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--to <place> | Sihtmasin või -klaster | Jah | - |
--provision <provider> | Provisioni siht automaatselt pilveteenusepakkuja kaudu (nt hetzner, linode) | Ei | - |
--bwlimit <limit> | Ribalaiuse piirang rsync-ülekandele (nt 10M) | Ei | - |
--checkpoint | CRIU otsemigratsion: jäädvusta ja taasta protsessi mäluseisund | Ei | - |
--delta-base <guid> | Muutumatu baas-GUID ülemineku deltaks (edasijõudnutele; vaikimisi 1. faasi baas) | Ei | - |
--strategy <strategy> | Üleminekul kasutatav plokidelta strateegia: auto, physical või shared | Ei | - |
--skip-dns | Jäta DNS-kirjete vahetamine pärast migratsiooni vahele | Ei | - |
--keep-source | Säilita lähte-image'id pärast edukat kolimist (vaikimisi kustutatakse; ülejäänud koopiad ei ole ühegi konfiguratsioonikirje kaudu aadresseeritavad ning reconcile märgib need hulkurdiks) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.25 sync
Sünkrooni hoidlaid ja faile (pakkpush/pull, failide ülekanne)
upload
Laadi failid hoidlasse üles rsync-i kaudu SSH üle (delta-ülekanne). Kasuta --mirror, et kustutada lisafailid kaugel, --dry-run eelvaateks, --exclude mustrite vahelejätmiseks
rdc repo sync upload <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--local <paths...> | Üks või mitu lokaalset faili- või kaustateed (vaikimisi: praegune kaust) | Ei | - |
--remote <path> | Kaugrepositorioumi alamsektsioon | Ei | - |
--remote-file <path> | Üksik kaugfaili tee (relatiivne repo juurest) üleslaadimiseks. Vastastikku välistav lipuga --remote. | Ei | - |
--mirror | Peegeldusrežiim -- kustuta kaugfailid, mida kohalikult ei leidu | Ei | - |
--verify | Kontrolli faile kontrollsummade abil pärast sünkroonimist | Ei | - |
--confirm | Kuva muudatuste eelvaade ja küsi kinnitust enne sünkroonimist | Ei | - |
--exclude <patterns...> | Sünkroonimisest väljajätmise mustrid | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
download
Laadi failid hoidlast alla rsync-i kaudu SSH üle (delta-ülekanne). Kasuta --mirror, et kustutada lisafailid kohalikult, --dry-run eelvaateks, --exclude mustrite vahelejätmiseks
rdc repo sync download <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--local <path> | Lokaalne kaustatee (vaikimisi: praegune kaust) | Ei | - |
--remote <path> | Kaugrepositorioumi alamsektsioon | Ei | - |
--remote-file <path> | Kaugfaili tee repositooriumi sees (alternatiiv lipule --remote ühe faili edastamisel) | Ei | - |
--mirror | Peegeldusrežiim -- kustuta kohalikud failid, mida kaugserveril ei leidu | Ei | - |
--verify | Kontrolli faile kontrollsummade abil pärast sünkroonimist | Ei | - |
--confirm | Kuva muudatuste eelvaade ja küsi kinnitust enne sünkroonimist | Ei | - |
--exclude <patterns...> | Sünkroonimisest väljajätmise mustrid | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
status
Kohalike ja kaugfailide kuivkäivituse võrdlus (näitab, mida kannataks üle kanda, ilma tegelikult kandmata)
rdc repo sync status <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--local <path> | Lokaalne kaustatee (vaikimisi: praegune kaust) | Ei | - |
--remote <path> | Kaugrepositorioumi alamsektsioon | Ei | - |
--remote-file <path> | Kaugfaili tee repositooriumi sees (alternatiiv lipule --remote ühe faili edastamisel) | Ei | - |
6.26 tunnel
Loo SSH-pordiedastustunnel konteineri pordile kaugmasinal. Tuvastab konteineri ja pordi automaatselt, kui pole mitmetähenduslikkust. Tunnel jääb avatuks kuni Ctrl+C vajutamiseni
rdc repo tunnel <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-c, --container <name> | Konteineri nimi (tuvastatakse automaatselt, kui töötab ainult üks) | Ei | - |
--port <port> | Edastatav kaugkonteineri port | Ei | - |
--local <port> | Kohalik port (vaikimisi sama mis kaugport) | Ei | - |
--url-only | Prindi ainult kohalik URL, kui tunnel on valmis (masinloetav) | Ei | - |
6.27 secret
Halda hoidlapõhiseid saladusi, mis süstitakse juurutamisel. Ainult kirjutamine: get tagastab ainult räsi (mitte lihtteksti), set/unset nõuavad --current räsi vastavust või --rotate-secret. Kaks edastusrežiimi: env (REDIACC_SECRET_<KEY>) ja file (tmpfs asukohas /var/run/rediacc/secrets/<networkId>/<KEY> läbi compose `secrets:`). Saladused ei satu kunagi krüpteeritud LUKS-kujutisesse; forkid ei päri neid.
get
Näita saladuse SHA-256 räsi. Lihttekstilist väärtust ei tagastata kunagi disaini järgi (ainult kirjutamine). Kasuta --current järgneval set/unset puhul, et kontrollida väärtust, mida juba tead, või roteerige käsuga `set --rotate-secret`.
rdc repo secret get <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--key <KEY> | Saladuse võti UPPER_SNAKE_CASE kujul (max 64 tähemärki). Eksponeeritakse env-režiimis REDIACC_SECRET_<KEY> või failirežiimis /run/secrets/<key> kujul konteinerites. | Jah | - |
list
Loetle saladuste võtmed ja režiimid (mitte kunagi väärtuseid, mitte kunagi räse).
rdc repo secret list <ref>
set
Määra või kirjuta saladus üle. Forkid ei päri; määra forgi jaoks sõnaselgelt. Agendi kontekstis nõuab --current räsi vastavust (paroolistiilis).
rdc repo secret set <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--key <KEY> | Saladuse võti UPPER_SNAKE_CASE kujul (max 64 tähemärki). Eksponeeritakse env-režiimis REDIACC_SECRET_<KEY> või failirežiimis /run/secrets/<key> kujul konteinerites. | Jah | - |
--value <value> | Saladuse väärtus. Anna `-`, et lugeda stdin-ist (väldib kesta ajaloo paljastamist). | Jah | - |
--mode <mode> | Edastusrežiim: 'env' (nähtav konteineri env-is, docker inspect) või 'file' (tmpfs-fail, mitte kunagi env-is). Vaikimisi: file. | Ei | file |
--current <value> | Eelmine lihttekstiline väärtus (parool-stiilis eeltingimus). Nõutav ülekirjutamisel/unset puhul; vastastikku välistav lipuga --rotate-secret. | Ei | - |
--rotate-secret | Kinnita rotatsioon; jäta --current eeltingimus vahele (auditeeritakse rotatsioonina). Kasuta siis, kui roteerid tahtlikult ilma eelnevat väärtust kontrollimata. | Ei | - |
unset
Kustuta saladus. Agendi kontekstis nõuab --current räsi vastavust.
rdc repo secret unset <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--key <KEY> | Saladuse võti UPPER_SNAKE_CASE kujul (max 64 tähemärki). Eksponeeritakse env-režiimis REDIACC_SECRET_<KEY> või failirežiimis /run/secrets/<key> kujul konteinerites. | Jah | - |
--current <value> | Eelmine lihttekstiline väärtus (parool-stiilis eeltingimus). Nõutav ülekirjutamisel/unset puhul; vastastikku välistav lipuga --rotate-secret. | Ei | - |
--rotate-secret | Kinnita rotatsioon; jäta --current eeltingimus vahele (auditeeritakse rotatsioonina). Kasuta siis, kui roteerid tahtlikult ilma eelnevat väärtust kontrollimata. | Ei | - |
6.28 admin
Hoidla administreerimise ja hoolduse käsud.
archive
Arhiveeritud hoidla kirjete haldus.
Loetle arhiveeritud hoidla mandaadid
rdc repo admin archive list
Kustuta kõik arhiveeritud mandaadid jäädavalt
rdc repo admin archive purge [name] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
Taasta arhiveeritud hoidla mandaat
rdc repo admin archive restore <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--new-name <name> | Ressursi uus nimi | Ei | - |
validate
Kinnita hoidla terviklikkus (LUKS-konteiner, failisüsteemi järjepidevus, konfiguratsioon). Kasuta pärast ootamatuid sulgemisi või varukoopia tervise kontrollimiseks
rdc repo admin validate <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
fsck
Kontrolli CLI konfiguratsiooni viitu (harud, HEAD) masinal tegelikult olemasolevate objektide vastu. Teatab rippuvatest viidetest (viide osutab puuduvale objektile) ja orvuks jäänud commit'idest (muutumatu commit, milleni ükski viide ei küüni). Ainult lugemiseks.
rdc repo admin fsck [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
ownership
Muuda hoidla kataloogi omaniku UID-i haagitud mahul (vaikimisi: 7111). Kasuta siis, kui konteinerid vajavad hoidla failidele juurdepääsuks kindlat UID-i
rdc repo admin ownership <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--uid <uid> | Omaniku UID (vaikimisi: 7111) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
autostart
Halda hoidla automaatset käivitamist buutimisel
Luba hoidla autostart (jäta nimi välja, et lubada kõigile)
rdc repo admin autostart enable [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
Keela hoidla autostart (jäta nimi välja, et keelata kõigile)
rdc repo admin autostart disable [ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
Loetle hoidlad, millel on autostart lubatud
rdc repo admin autostart list [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
template
Halda ja rakenda juurutusmalide (kirjutab docker-compose.yml, Rediaccfile ja lisafailid). Rediaccfile peab kasutama 'renet compose' (mitte 'docker compose'). Taaskäivitamispoliitikad on turvalised (renet watchdog haldab automaatselt). Renet süstib automaatselt network_mode:host, CRIU võimalused ja rediacc-sildid. Ohtlikud seaded (privileged, pid:host) on blokeeritud. Kasuta 'list', et näha saadaolevaid sisseehitatud malle, ja 'apply', et rakendada mall hoidlale
Loetle kõik CLI-ga kaasasolevad sisseehitatud juurutusmallid
rdc repo admin template list
Rakenda mall hoidlale. Kasuta sisseehitatud malli nime (nt app-postgres) või --file kohandatud JSON-malli jaoks. Rediaccfile elutsükkel: up() käivitab konteinerid (tõmba kujutised, genereeri konfiguratsioonid), down() peatab. Minimaalne Rediaccfile: up() { renet compose -- pull; renet compose -- up -d; } down() { renet compose -- down; }. TÄHTIS: Rediaccfile PEAB kasutama 'renet compose' -- 'docker compose' lükatakse tagasi. KESKKONNA MUUTUJAD -- kaks tasandit: (a) Rediaccfile shell: ${SVCNAME_IP} (nt APP_IP), ${REDIACC_WORKING_DIR}, ${REDIACC_NETWORK_ID}. (b) Konteinerites: renet süstib automaatselt SERVICE_IP ja REDIACC_NETWORK_ID keskkonna muutujad. eBPF-sidumisümberkirjutus käsitleb IP-isolatsiooni läbipaistvalt -- rakendused saavad siduda 0.0.0.0 ja kernel kirjutab selle ümber õigele loopback-IP-le. Tervisekontrollid saavad kasutada localhost. network_mode:host süstitakse ja ports: eiratakse. SALVESTUS: Nii ${REDIACC_WORKING_DIR}/... bind-mount'id kui ka Docker-nimelised mahud on turvalised -- Dockeri andmejuur asub krüpteeritud LUKS-mahus. TAASKÄIVITUSPOLIITIKA: Taaskäivituspoliitikad on turvalised -- renet eemaldab need automaatselt CRIU ühilduvuse tagamiseks ja watchdog haldab taastamist. Compose: ÄRGE lisage network_mode ega rediacc.*-silte (renet süstib need). Mitme projekti puhul: paigutage iga alamprojekt oma alamkataloogi koos oma Rediaccfile'iga -- renet tuvastab ja käivitab need automaatselt järjekorras. HTTPS-marsruutimine: (A) Automarsruut (fork-sõbralik, soovitatav): ÄRGE lisage traefik.enable. Renet genereerib automaatselt https://{serviceName}.{repoName}.{machineName}.{baseDomain}. Lisage silt rediacc.service_port=<port> mitte-80 portide jaoks. Iga fork saab kordumatu domeeni. (B) Traefik-sildid (kohandatud domeen, EI sobi forkidele): traefik.enable=true, traefik.http.routers.<n>.rule=Host(`domeen`), 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 jaoks: rediacc.tcp_ports=3306 / rediacc.udp_ports=53
rdc repo admin template apply <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--template <name> | Rakendatav mall | Jah | - |
--file <path> | Tee kohandatud malli JSON-faili ({"version":"2","files":{"Rediaccfile":"...","docker-compose.yml":"..."}}): tühistab sisseehitatud malli nime | Ei | - |
--grand <name> | Vanema mandaadihoidla (lahendab nime automaatselt GUID-iks). Ainult hoidlatele, mis jagavad saladusi vanemaga | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.29 promote
Asenda põhihoidla (grand) andmed forgi andmetega. Põhihoidla säilitab oma identiteedi (GUID, networkId, domeenid, autostart, varukoopiaahel), kuid saab forgi täiendatud andmed. Vanad tootmisandmed säilitatakse varukoopiaforgi kujul. Kasutus: testi uuendust forgil, kontrolli, seejärel tee takeover tootmisele.
rdc repo promote <fork-ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
6.30 logs
Näita hoidla konteinerite rakenduse logisid. Dockeri hoidlad loevad hoidla enda Dockeri daemonist; Kubernetese hoidlad loevad podi logisid hoidla nimeruumis. Kui hoidla käitab rohkem kui ühte konteinerit, nimeta soovitud lipuga --container.
rdc repo logs <ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-c, --container <name> | Konteiner, mida lugeda (vajalik ainult siis, kui hoidla käitab rohkem kui ühte) | Ei | - |
-f, --follow | Jätka uute ridade voogesitust kuni katkestamiseni | Ei | - |
--lines <n> | Mitu ajaloorida näidata (vaikimisi: 100) | Ei | 100 |
--timestamps | Lisa igale reale ajatempel | Ei | - |
--debug | Luba silumisväljund | Ei | - |
6.31 exec
Käivita käsk hoidla konteineri sees. Käsu enda väljumiskood edastatakse otse, nii et see töötab skriptides ja tingimuslausetes. Dockeri hoidlad käivitavad selle hoidla oma Dockeri daemoni kaudu; Kubernetese hoidlad käivitavad selle hoidla nimeruumis.
rdc repo exec <ref> <cmd...> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-c, --container <name> | Konteiner, milles käivitada (vajalik ainult siis, kui hoidla käitab rohkem kui ühte) | Ei | - |
-i, --interactive | Eralda terminal (käsu jaoks, mis seda ootab) | Ei | - |
-u, --user <user> | Kasutaja, kelle nimel käsku käivitada | Ei | - |
--debug | Luba silumisväljund | Ei | - |
7. Eraldatud tööd
Halda masina eraldiseisvaid töid: kuva loend, kontrolli olekut, taasesita või jälgi sündmuslogisid, tühista töö või kustuta lõpetatud tööd. Eraldiseisev töö töötab masinas systemd all, mistõttu see jääb käima ka ühenduse katkemisel ja sellega saab hiljem uuesti liituda.
7.1 list
Kuva masina eraldiseisvad tööd, uuemad eespool
rdc job list [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
7.2 status
Kuva eraldiseisva töö olek
rdc job status <job-id> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
7.3 logs
Taasesita või jälgi eraldiseisva töö sündmuslogi
rdc job logs <job-id> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
-f, --follow | Voogesita kuni töö lõpeb | Ei | - |
--since-line <n> | Jätka pärast antud arvu ridu (arv, mille juba said) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
7.4 cancel
Tühista töötav eraldiseisev töö
rdc job cancel <job-id> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
7.5 gc
Eemalda lõpetatud tööd ja nende logid
rdc job gc [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
--older-than <duration> | Kogu töid, mis lõppesid rohkem kui nii mitu tundi tagasi (vaikimisi: 168) | Ei | - |
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
8. Varundamine ja taastamine
Halda varundusstrateegiaid, nende plaanitud käivitusi ja tekkivaid artefakte: deklareeri hoidlale strateegia, käivita või taasta see nõudmisel ning uuri arhiive, mille see salvestuse lõpp-punkti kirjutas.
8.1 schedule
Juuruta varukoopia ajakava kaugmasinasse (systemd taimerid)
rdc backup schedule [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Jah | - |
--dry-run | Näitab genereeritud üksusi ilma neid juurutamata | Ei | - |
--force | Jätkab ka siis, kui varukoopia on parasjagu käimas (uus üksus rakendub järgmisel käivitumisel; käiv käivitus kasutab vana üksust) | Ei | - |
--reset-failed | Tühjendab puudutatud teenustel ebaõnnestunud oleku pärast edukat juurutamist (vaikimisi väljas, säilitab ebaõnnestumise signaali) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
8.2 cancel
Katkestab käimasoleva varukoopia kaugmasinal
rdc backup cancel [strategy] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Jah | - |
--debug | Luba silumisväljund | Ei | - |
8.3 list
Loetle varukoopia artefaktid masinal või salvestuses.
rdc backup list [artifact-ref] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Ei | - |
--storage <name> | Loetle artefaktid sellel salvestuse lõpp-punktil | Ei | - |
--path <subdir> | Alamkataloog salvestuse juures. Kui jäetakse välja, loetletakse ja ühendatakse hot/ ja cold/. | Ei | - |
-w, --watch | Jälgi muudatusi | Ei | - |
--debug | Luba silumisväljund | Ei | - |
8.4 restore
Muuda varukoopia artefakt töötavaks hoidlaks. Asukoht määratakse siin.
rdc backup restore <artifact-ref> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--as <name> | Taastatud hoidla nimi (vaikimisi artefakti nimi) | Ei | - |
-m, --machine <name> | Masina nimi | Ei | - |
--datastore <name> | Taasta sellesse nimega andmehoidlasse (seda majutab hoidla ühendatud masin) | Ei | - |
--up | Juuruta taastatud hoidla pärast ülekannet | Ei | - |
--health-window <seconds> | Terviseväravaks kuluv koguaeg sekundites (vaikimisi 300) | Ei | - |
--health-timeout <seconds> | Terviskontrolli katse aegumine sekundites (vaikimisi 30) | Ei | - |
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--debug | Luba silumisväljund | Ei | - |
8.5 run
Käivitab varukoopia kohe kaugmasinal
rdc backup run [strategy] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Jah | - |
-w, --watch | Jälgi muudatusi | Ei | - |
--debug | Luba silumisväljund | Ei | - |
8.6 status
Näitab varukoopia olekut ja taimeri olekut kaugmasinal
rdc backup status [strategy] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Jah | - |
--debug | Luba silumisväljund | Ei | - |
8.7 strategy
Halda nimelist varundusstrateegiat (hot/cold režiimid, sihtkohad, ajakava)
set
Loo või uuenda varundusstrateegiat
rdc backup strategy set <strategy> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--destination <name> | Sihtkoha nimi strateegia sees | Ei | - |
--storage <name> | Salvestuse konfiguratsiooni nimi (rclone mandaadid) | Ei | - |
--cron <expression> | Cron-ajakava (nt "0 * * * *" tunni kaupa) | Ei | - |
--mode <mode> | Varundusrežiim: "hot" (nullkatkestusaeg) või "cold" (peata, hetktõmmis, taaskäivita) | Ei | - |
--bwlimit <limit> | Rclone ribalaiuse piirang (nt "6M", "10M:off", "08:00,3M;22:00,10M") | Ei | - |
--include <repos> | Varunda ainult need hoidlad (komaga eraldatud nimed) | Ei | - |
--exclude <repos> | Jäta need hoidlad varundusest välja (komaga eraldatud nimed) | Ei | - |
--folder <path> | Alamkaust salvestusämbris selle sihtkoha jaoks (nt hot, cold) | Ei | - |
--enable | Luba strateegia või sihtkoht | Ei | - |
--disable | Keela strateegia või sihtkoht | Ei | - |
bind
Seo varundusstrateegia masinaga, et selle ajakava sinna juurutataks
rdc backup strategy bind <strategy> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
unbind
Tühista varundusstrateegia sidumine masinaga
rdc backup strategy unbind <strategy> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Sihtmasina nimi | Jah | - |
remove
Eemalda varundusStrateegia või sihtkoht
rdc backup strategy remove <strategy> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--destination <name> | Eemalda ainult see sihtkoht (säilitab teised sihtkohad) | Ei | - |
list
Loetle kõik varundusstrateegiad
rdc backup strategy list
show
Kuva varundussettrateegia üksikasjad
rdc backup strategy show [strategy]
9. Salvestuse haldus
Halda väliseid varukoopia salvestuse lõpp-punkte (S3 ja muud rclone-ühilduvad sihtkohad): registreeri ja eemalda neid, loetle registreeritud lõpp-punktid, sirvi neis sisalduvaid artefakte ja korista orvuks jäänud varukoopiad.
9.1 list
Loetle salvestuse lõpp-punktid. Anna nimi täieliku detaili jaoks.
rdc storage list [name] [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--reveal | Kuva salvestuse konfiguratsioon lihttekstina (ainult interaktiivne TTY; auditeeritakse) | Ei | - |
9.2 browse
Sirvib faile salvestussüsteemis
rdc storage browse <storage> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--path <subpath> | Loetlev alamkataloogi tee | Ei | “ |
9.3 prune
Kustutab orvu varukoopiaid salvestusest, mis pole enam üheski konfiguratsioonis. Mitme konfiguratsiooni turvaline koos ooteperioodi kaitsega. Rclone käivitused töötavad --machine peal (täitja), mitte sinu sülearvutil, seega klientidel pole vaja rclone-i kohalikult installida; --machine on täitja, mitte tõeteallikas.
rdc storage prune <storage> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Täitja masin -- käivitab rclone loetlemise/kustutamise kõnesid salvestuse vastu. Nõutav, kuna klientidel ei eeldata rclone-i kohalikku installimist; salvestuse volikirjad tulevad endiselt kohalikust konfiguratsioonist. | Jah | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
--force | Jäta kinnitusviibad vahele | Ei | - |
--force-delete-mounted | Tühistab ühendusohutuse kontrolli ja kustutab pilvest varukoopiaid isegi siis, kui allika GUID on praegu ühendatud või sellel on töötav konteiner täitja masinal. Erineb lipust --force (mis tühistab ainult arhiveeritud repositooriumite ooteperioodi). | Ei | - |
--grace-days <days> | Hiljuti arhiveeritud repode armuaeg päevades (vaikimisi: 7) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
--skip-router-restart | Jäta marsruutimisserveri taaskäivitus pärast binaarset uuendust vahele | Ei | - |
9.4 add
Registreeri salvestuse lõpp-punkt.
rdc storage add <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--vault <json> | Hoidla sisu JSON-stringina | Jah | - |
9.5 import
Impordi salvestused rclone konfiguratsioonifailist
rdc storage import <file> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--name <name> | Impordi ainult see nimeline sektsioon | Ei | - |
9.6 remove
Eemalda salvestuse lõpp-punkt konfiguratsioonist.
rdc storage remove <name> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-y, --yes | Jäta kinnitusviip vahele | Ei | - |
--dry-run | Kuva, mida tehaks, ilma muudatusi tegemata | Ei | - |
10. VS Code'i integratsioon
Avab VS Code koos Remote SSH-ga masina või repositooriumiga, koos iga repositooriumi isoleeritud keskkonnaga. Sama SSH-ühendus nagu `term`, kuid käivitab VS Code. Peamised alamkomandod: connect (või positsiooniline otsetee), list (näitab konfigureeritud ühendusi), cleanup (eemaldab SSH-konfiguratsiooni kirjed), check (kontrollib VS Code installimist).
10.1 connect
Ava VS Code masinal või hoidla sees.
rdc vscode connect <target> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-f, --folder <path> | Avamiseks ettenähtud kaugkausta tee | Ei | - |
--url-only | Prindi VS Code'i URI käivitamise asemel | Ei | - |
-n, --new-window | Ava uues VS Code'i aknas | Ei | - |
--skip-env-setup | Jäta kaugkeskkonna seadistus vahele | Ei | - |
--insiders | Kasuta VS Code Insidersi seadeid | Ei | - |
--browser | Serveeri brauseri VS Code-i repositooriumi liivakastist (kohalikku VS Code-i pole vaja) | Ei | - |
--no-open | Prindi URL ilma kohalikku brauserit käivitamata | Ei | - |
--local <port> | Kohalik port (vaikimisi sama mis kaugport) | Ei | - |
--server-provider <id> | Brauseri VS Code serveri implementatsioon (openvscode, code-server) | Ei | - |
--server-archive <file> | Serveritarball-i eellavastatud tee masinal (õhust eraldatud paigaldused) | Ei | - |
10.2 list
Loetleb konfigureeritud VS Code SSH-ühendusi
rdc vscode list
10.3 cleanup
Eemaldab VS Code SSH-konfiguratsioonid
rdc vscode cleanup [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--all | Eemalda kõik Rediacc SSH-konfiguratsioonid | Ei | - |
-c, --connection <name> | Eemalda konkreetne ühendus | Ei | - |
10.4 check
Kontrollib VS Code installimist ja konfiguratsiooni
rdc vscode check [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--insiders | Kasuta VS Code Insidersi seadeid | Ei | - |
10.5 serve
Halda repositooriumi liivakastis töötavat brauseri VS Code serverit
status
Kuva, kas brauseri VS Code server töötab
rdc vscode serve status <target> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--server-provider <id> | Brauseri VS Code serveri implementatsioon (openvscode, code-server) | Ei | - |
stop
Peata brauseri VS Code server
rdc vscode serve stop <target> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--server-provider <id> | Brauseri VS Code serveri implementatsioon (openvscode, code-server) | Ei | - |
11. SSH-terminali juurdepääs
Ava SSH-terminal masinasse või hoidlasse. Sihtmärk on masina nimi või hoidla viide, ning hoidla kontekst (DOCKER_HOST, töökataloog, keskkond) seadistatakse automaatselt. Kasuta `-c`, et käivitada üks käsk mitteinteraktiivselt. Konteineri logide või ühekordse käsu jaoks konteineris kasuta `repo logs` ja `repo exec`. VS Code jaoks kasuta `vscode`.
11.1 connect
Ava shell masinal, või hoidla sees koos selle Dockeri seadistusega.
rdc term connect <target> [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-c, --command <cmd> | Käivita käsk interaktiivse kesta asemel | Ei | - |
--external | Sundkäivita välises terminaliaknast | Ei | - |
--reset-home | Lähtesta repo-spetsiifiline koduülekihte värsket algust | Ei | - |
12. Kiirkäsud (otseteed)
12.1 run
HOIATUS: Madala taseme komando ainult silumiseks ja katsetamiseks. Mitte tootmises kasutamiseks. Kasuta selle asemel kõrgemataseme komandosid (repo up, repo down jne). Käivitab toore sillfunktsiooni masinal.
rdc run
12.2 trace
Jälitab ülesannet (otsetee: queue trace)
rdc trace
12.3 cancel
Katkestab ülesande (otsetee: queue cancel)
rdc cancel
12.4 retry
Kordab ebaõnnestunud ülesannet (otsetee: queue retry)
rdc retry
13. Tellimuse haldus
Halda litsentsimist ja tellimuse tokeneid. Logi sisse käsuga login, uuri olekut käsuga status, väljasta litsentsid uuesti käsuga refresh.
13.1 login
Autentimine brauseri või API tokeni kaudu
rdc subscription login [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-t, --token <token> | API-token (rdt_...) | Ei | - |
--server <url> | Kontoserveri URL | Ei | - |
13.2 logout
Kustutab salvestatud tellimuse tokeni
rdc subscription logout
13.3 status
Näita tellimust ja masina litsentsi olekut.
rdc subscription status [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Ei | - |
13.4 refresh
Värskenda litsentsid kontoserverist.
rdc subscription refresh [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-m, --machine <name> | Masina nimi | Ei | - |
--repo <ref> | Hoidla viide: nimi, või nimi:silt, valikuliselt koos @machine-ga (nt shop või shop:test) | Ei | - |
14. CLI uuendused
Kontrollib uusi CLI versioone ja rakendab uuendusi. Toetab --check-only kontrolli ilma installimiseta ja --force uuendamist isegi siis, kui on juba uusim versioon.
rdc update [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--force | Sunnib uuendamist isegi siis, kui on juba ajakohane | Ei | - |
--check-only | Kontrollib ainult uuendusi ilma allalaadimiseta | Ei | - |
--rollback | Tagasi pöördumine eelmisele versioonile | Ei | - |
--status | Näitab automaatse uuenduse olekut ja diagnostikat | Ei | - |
--channel <channel> | Seab väljalaskekanali (stable või edge) | Ei | - |
15. Kolmandate osapoolte autorlus
Prindi rdc-ga kaasas olevad kolmandate osapoolte komponendid: renet-i põimitud ja edastatud binaarid (CRIU, rsync, rclone), põimitud Node.js käitusaeg ja kaasas olevad npm-sõltuvused. Näitab versioone, SPDX litsentsi identifikaatoreid ja GPL-vastavuseks nõutavaid täpse versiooni lähtearhiivi URL-e. Kasuta lippu --licenses, et printida väljalaske ehitistega kaasas olev täielik THIRD_PARTY_LICENSES tekst.
rdc credits [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--licenses | Prindi väljalaske ehitistega kaasas olev täielik THIRD_PARTY_LICENSES tekst | Ei | - |
16. Süsteemi diagnostika
Käivitab diagnostikakontrollid CLI keskkonnas: Node.js versioon, renet-i binaarfaili kättesaadavus, konfiguratsioonifaili kehtivus, SSH-võtme olek ja võrguühenduvus. Väljastab struktureeritud tervisearuande läbitud/ebaõnnestunud näitajatega.
rdc doctor
17. Kohalikud VM-toimingud
Kohalik VM-i ettevalmistamine ja haldamine KVM/QEMU/Hyper-V abil (platvorm tuvastatakse automaatselt). Mitte kaugmasinate jaoks -- kasuta nende jaoks `machine`. Peamised alamkomandod: up (käivitab VM-id), down (peatab), status (loetleb töötavad VM-id), ssh (ühendab VM-iga), setup (installib eeltingimused), check (kontrollib hosti valmisolekut).
17.1 up
Ettevalmistab VM-klastri kohalikult
rdc ops up [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--force | Sundtaaskäivita kõik virtuaalmasinad | Ei | - |
--parallel | Loo virtuaalmasinad paralleelselt | Ei | - |
--basic | Minimaalne klaster (sild + 1 töötaja) | Ei | - |
--lite | Jäta virtuaalmasinate seadistamine vahele (ainult olek) | Ei | - |
--skip-orchestration | Jäta klastri orkestratsioon vahele | Ei | - |
--backend <backend> | Virtualiseerimise taustarakendus (kvm|qemu, tuvastatakse automaatselt) | Ei | - |
--os <name> | Virtuaalmasina operatsioonisüsteem (nt ubuntu-24.04, debian-13) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
17.2 down
Hävitab VM-klastri
rdc ops down [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--backend <backend> | Virtualiseerimise taustarakendus (kvm|qemu, tuvastatakse automaatselt) | Ei | - |
--debug | Luba silumisväljund | Ei | - |
17.3 status
Näitab VM-klastri olekut
rdc ops status [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--backend <backend> | Virtualiseerimise taustarakendus (kvm|qemu, tuvastatakse automaatselt) | Ei | - |
17.4 ssh
SSH-ühendus VM-iga
rdc ops ssh [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--vm-id <id> | Virtuaalmasina ID | Jah | - |
-c, --command <cmd> | Käivita käsk interaktiivse kesta asemel | Ei | - |
--backend <backend> | Virtualiseerimise taustarakendus (kvm|qemu, tuvastatakse automaatselt) | Ei | - |
--user <user> | SSH-kasutajanimi VM-ühenduse jaoks | Ei | - |
17.5 setup
Installib virtualiseerimise eeltingimused
rdc ops setup [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
--debug | Luba silumisväljund | Ei | - |
17.6 check
Kontrollib virtualiseerimise eeltingimusi
rdc ops check
18. Käitaja teenus
Käivita see protsess täiturina, et kliendid saaksid käske käivitada selle kaudu ise SSH kaudu ühendumise asemel
rdc serve [options]
| Lipuke | Kirjeldus | Kohustuslik | Vaikimisi |
|---|---|---|---|
-p, --port <port> | Port, mida kuulata | Ei | 8080 |
--host <host> | Aadress, millega siduda | Ei | 0.0.0.0 |
--mode <mode> | Paiknemine: daemon (kliendi host) või container | Ei | daemon |
Sagedased veateated
Probleemi ilmnemisel kuvab CLI selged veateated:
| Viga | Tähendus |
|---|---|
| Autentimine on nõutud. Käivita: rdc subscription login | Pead esmalt sisse logima |
| Aktiivset konfiguratsiooni ei ole. Loo uus käsuga: rdc config init <name> | Aktiivne konfiguratsioon puudub -- loo üks käsuga `rdc config init` |
| Ligipääs keelatud | Sinu kontol puuduvad vajalikud õigused |
| Masina nimi on nõutud. Kasuta --machine <name> | Määra masin lipukesega `--machine` või sea konfiguratsiooni vaikeväärtus |
| Meeskonna nimi on nõutud. Kasuta --team või määra vaikimisi väärtus käsuga: rdc config set team <name> | Määra meeskond lipukesega `--team` või sea konfiguratsiooni vaikeväärtus |
| Regiooni nimi on nõutud. Kasuta --region või määra vaikimisi väärtus käsuga: rdc config set region <name> | Määra piirkond lipukesega `--region` või sea konfiguratsiooni vaikeväärtus |
Väljundvormingud
Kõik list/get-käsud toetavad mitmeid väljundvorminguid lipukese `--output` kaudu:
rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table # default
See muudab Rediacc CLI integreerimise skriptidesse, CI/CD torujuhtmetesse ja automaatimistöövoogudesse lihtsaks.