Git-laadne hargnemine

Siin on mõttermudel: Rediacc muudab koopiakirjutamise hargid git-laadseks versiooniajalooks. Iga muutumatu hark on komit: baidiliselt stabiilne, külmutatud kujutis, mis keeldub ühendamast. Harud on nimega viited, mis osutavad komitile. rdc repo checkout reflink-kloonib komiti tagasi kirjutatavaks töötavaks hargiks ja rdc repo merge ühendab kaks ajalooliini ilma kunagi elavat repositooriumi muutmata.

Mudel kaardistub kahele hoidlale. Masin on objektihoidla: komitid on muutumatud hargikujutised, mis elavad andmehoidlas. CLI konfiguratsioon on viitehoidla: harunimed, praegune HEAD ja reflog elavad sinu lokaalses konfiguratsioonis, mitte masinal. See on sama jaotus, mida git kasutab .git/objects ja .git/refs vahel.

Millal kasutada

Kasuta hargnemist siis, kui hark on teeninud nime. AI agent jooksis tootmise hargis vabalt, tulemus näeb hea välja ja soovid külmutatud, nimega kontrollpunkti, mille juurde saad hiljem naasta või mille saad edendada: rdc repo commit külmutab selle, rdc repo branch nimetab selle. Enne riskantset migratsiooni komita töötav hark, et sul oleks täpne taastepunkt, mis on garanteeritult muutumatu (muutumatu komit keeldub ühendamast, nii et miski ei saa sellesse kirjutada). Kahe kontrollpunkti võrdlemiseks töötab rdc repo diff iga kahe komiti vahel, sest neil on ühine koopiakirjutamise esivanem. Ülevaadatud tööliini sihtharku tagasi toomiseks ehitab rdc repo merge tulemuse reflink-kloonist ja vahetab selle atomaarselt sisse, nii et töötav sihtmärk ei korrupteeruks ühendamise keskel.

Ära kasuta seda rdc repo fork asendajana, kui vajad ainult äravisatavat koopiat. Tavaline hark on õige üksus ajutise, testipõhise isolatsiooni jaoks. Komitid lisavad väärtust siis, kui olek on väärt hoidmist, nimetamist või tarne.

Kuidas komitid ja hargid seostuvad

Repositoorium on üks LUKS-kujutisfail btrfs-basseinil. Hark on konstantaja reflink sellest kujutisest, nii et 1 GB repositooriumi ja 100 GB repositooriumi hargimiseks kulub sama aeg. Komit on hark, mis on märgitud muutumatuks: renet keeldub seda ühendamast, mis hoiab selle kujutise baidiliselt stabiilsena igavesti. See baidistabilisus muudab komiti usaldusväärseks taastepunktiks ja deterministlikuks aluseks masinate vaheliseks delta edastuseks.

rdc repo commit salvestab komiti sõnumi, autori, ajatempli ja vanemkomiti mahu sees (et metaandmed rändaksid kujutisega edastamisel kaasa) ning peegeldab selle ka väljaspool mahtu (et rdc repo log saaks ajalugu jalutada ilma midagi avamata). Komiteeritud töötav hark jätkub muutumatult, täpselt nii nagu git jätab su töökataloogile komiti järel puutumatuks.

Käsud

rdc repo commit

Külmuta ühendatud töötav hark uueks muutumatuks komitiks.

rdc repo commit --name <hark> --message "<sõnum>" -m <masin>

Valik	Kirjeldus	Vaikimisi
--name <nimi>	Töötav hark komiteerimiseks. Peab olema ühendatud. Nõutud.	nõutud
--message <sõnum>	Komiti sõnum. Nõutud.	nõutud
--author <autor>	Komiti autor salvestatud komiti metaandmetesse.	määramata
-m, --machine <nimi>	Sihtmasin. Nõutud.	nõutud
--debug	Detailsed diagnostikateated stderr-i.	väljas

Uus komit registreeritakse lokaalses konfiguratsioonis atribuudiga immutable: true ja töötava hargi headCommit edeneb sellele osutama. Muutumatu repositooriumi komiteerimine lükatakse tagasi: tee sellest esmalt kirjutatav hark kasutades checkout-i.

rdc repo branch

Loo nimega haru viide, mis osutab töötava hargi praegusele komitile.

rdc repo branch --branch <nimi> --name <hark>

Valik	Kirjeldus	Vaikimisi
--branch <haru>	Uue haru nimi. Nõutud.	nõutud
--name <nimi>	Töötav hark, mille praegusele komitile haru osutab. Nõutud.	nõutud

See on ainult konfiguratsioonitoimingud. Masinal ei toimu midagi. Haru viide kaardistab nime töötava hargi headCommit-ile, seega peab hargil olema vähemalt üks komit esmalt.

rdc repo checkout

Reflink-klooni muutumatu komit (või haru tipp) värskeks kirjutatavaks töötavaks hargiks.

rdc repo checkout --ref <komit> --tag <uusHark> -m <masin>
rdc repo checkout --ref <haruNimi> --from <hark> --tag <uusHark> -m <masin>

Valik	Kirjeldus	Vaikimisi
--ref <komit|haru>	Väljavõttav komiti GUID või haru nimi, kui --from on antud. Nõutud.	nõutud
--tag <nimi>	Nimi uuele kirjutatavale töötavale hargile. Nõutud.	nõutud
-m, --machine <nimi>	Sihtmasin. Nõutud.	nõutud
--from <töötavHark>	Lahendab --ref haru nimena selle töötava hargi harukomplektis.	otsene komit
--debug	Detailsed diagnostikateated stderr-i.	väljas
--skip-router-restart	Jäta marsruuteri taaskäivitussamm vahele.	väljas

Checkout taaskasutab hargi reflink teed, seega on see peaaegu kohene ja konstantaja olenemata repositooriumi suurusest. Uue töötava hargi headCommit seatakse väljavõetud komitile.

rdc repo log

Jaluta komitide ajalugu, mis on töötavast hargist või komitist kättesaadav.

rdc repo log --name <hark> -m <masin>

Valik	Kirjeldus	Vaikimisi
--name <nimi>	Töötav hark või komit, millest ajaloo jalutamine algab. Nõutud.	nõutud
-m, --machine <nimi>	Sihtmasin. Nõutud.	nõutud
--json	Väljasta komitide ajalugu JSON-ina.	väljas
--debug	Detailsed diagnostikateated stderr-i.	väljas

log jalutab vanemate ahela, mida rdc repo commit salvestas, lugedes väljaspool mahtu olevat olekupeegli, nii et ühtegi komiti ei avata ega ühendata. See on ainult lugemiseks.

rdc repo merge

Ühenda lähtekomit või hark sihtmärgi töötavasse harku, muutmata elavat sihtmärki kohapeal.

rdc repo merge --name <sihtmärk> --from <allikas> -m <masin>
rdc repo merge --name <sihtmärk> --from <allikas> --resolve theirs -m <masin>

Valik	Kirjeldus	Vaikimisi
--name <nimi>	Sihtmärgi töötav hark, kuhu ühendada. Nõutud.	nõutud
--from <allikas>	Lähtekomit või hark, millest ühendada. Nõutud.	nõutud
-m, --machine <nimi>	Sihtmasin. Nõutud.	nõutud
--force	Vaigistu ühendatud või töötav sihtmärk esmalt, seejärel ühenda. Ei muuda kunagi elavat ühendust.	väljas
--resolve <ours|theirs>	Failipõhine kolmesuunaline ühendamine: voldi allika failipõhised muudatused sihtmärgile, hoides (ours) või võttes (theirs) allika versiooni failide jaoks, mis on muutunud mõlemal poolel. Välja jätmisel võetakse kogu kujutis allikast.	väljas
--base <guid>	Ühise esivanema komit kolmesuunaliseks ühendamiseks (kasutatakse koos --resolve). Vaikimisi on allika komiti vanem või sihtmärgi praegune komit.	automaatne
--debug	Detailsed diagnostikateated stderr-i.	väljas

Tulemus ehitatakse reflink-kloonist ja vahetatakse atomaarselt sisse krahhikindla markeri taha, nii et katkestatud ühendamine jätab algse sihtmärgi terveks. Ühendatud või töötav sihtmärk lükatakse tagasi, välja arvatud --force, mis sulgeb sihtmärgi puhaste enne vahetust.

Ilma --resolve-ta on ühendamine kogu kujutise võtmine allikast (sihtmärgist saab allikas). Koos --resolve-ga on see failipõhine kolmesuunaline ühendamine allika komiti salvestatud vanema vastu: failid, mis muutusid ainult ühel poolel, võetakse sellelt poolelt, ja failid, mis muutusid mõlemal poolel, lahendatakse lipuga. Konfliktsed teed raporteeritakse.

rdc repo gc

Kogu masinal prügi, muutumatud komiti objektid, mida ükski haru või HEAD ei jõua.

rdc repo gc -m <masin>            # kuiva jooksu eelvaade (vaikimisi)
rdc repo gc --apply -m <masin>    # kustuta kättesaamatud komitid

Valik	Kirjeldus	Vaikimisi
-m, --machine <nimi>	Masin, millel koguda. Nõutud.	nõutud
--apply	Kustuta tegelikult kättesaamatud komitid (muidu kuiva jooksu eelvaade).	väljas
--debug	Detailsed diagnostikateated stderr-i.	väljas

Kättesaadavus arvutatakse lokaalse konfiguratsiooni põhjal (viitehoidla): komitide hulk, mis on kättesaadavad, järgides iga haru tippu ja HEAD-i vanemate ahela kaudu. Masinal olevad muutumatud komitid, mis jäävad sellest hulgast väljapoole, on kättesaamatud. Ühendatud objekti ega töötavat harku ei koguta kunagi.

rdc repo fsck

Valideeri konfiguratsiooni viited masinal olevate objektide vastu.

rdc repo fsck -m <masin>

Valik	Kirjeldus	Vaikimisi
-m, --machine <nimi>	Kontrollitav masin. Nõutud.	nõutud

Raporteerib rippuvad viited (haru tipp või HEAD, mis osutab GUID-ile ilma objektita masinal) ja orb-komitid (muutumatu komit masinal, mida ükski viide ei jõua). See on ainult lugemiseks; puhasta orbsid käsuga rdc repo gc --apply.

Muutumatud hargid

rdc repo fork --immutable märgib uue harki loomise hetkel ainult lugemiseks, tootes komitiekvivalentse aluse ilma eraldi commit sammuta.

rdc repo fork --parent <nimi> --tag <tag> --immutable -m <masin>

Muutumatu hark keeldub ühendamast, mis hoiab selle kujutise baidiliselt stabiilsena igavesti. See on kasulik külmutatud alusena masinate vaheliseks delta edastuseks, kus alus peab mõlemal otsas identne olema. Muudatuste tegemiseks tee sellest checkout (või hargista uuesti) kirjutatavasse koopisse.

Näited

Töötava hargi komiteerimine

$ rdc repo commit --name myapp:work --message "schema migration applied" -m server-1
Committed 4f3c2a1b9d8e: schema migration applied

Komiteerimine selgesõnalise autoriga

$ rdc repo commit --name myapp:work --message "nightly snapshot" --author ci-bot -m server-1
Committed 7a1b2c3d4e5f: nightly snapshot

Haru nimetamine praegusel komitil

$ rdc repo branch --branch staging --name myapp:work
Branch "staging" -> 4f3c2a1b9d8e

Komiti väljavõtmine värskesse kirjutatavasse harku

$ rdc repo checkout --ref 4f3c2a1b9d8e --tag rollback-test -m server-1

Haru tipu väljavõtmine nime järgi

Koos --from-iga lahendatakse --ref väärtus haru nimena antud töötaval hargil:

$ rdc repo checkout --ref staging --from myapp:work --tag staging-copy -m server-1

Ajaloo jalutamine

$ rdc repo log --name myapp:work -m server-1
commit 4f3c2a1b9d8e
  Author: ci-bot  Date: 2026-05-29T10:14:02Z
  schema migration applied
commit 9d8e7a1b2c3d
  Author: ci-bot  Date: 2026-05-28T22:01:55Z
  initial import

Ajalugu JSON-ina

--json annab struktureeritud läbimise, uusimast esimesena:

$ rdc repo log --name myapp:work --json -m server-1
{
  "success": true,
  "start": "4f3c2a1b9d8e",
  "entries": [
    {
      "guid": "4f3c2a1b9d8e",
      "message": "schema migration applied",
      "author": "ci-bot",
      "parent": "9d8e7a1b2c3d",
      "committed_at": "2026-05-29T10:14:02Z",
      "immutable": true
    }
  ]
}

Kahe komiti võrdlemine

rdc repo diff töötab iga kahe komiti vahel, sest neil on ühine koopiakirjutamise esivanem. Võta üks komit välja, seejärel võrdle teisega:

$ rdc repo checkout --ref 4f3c2a1b9d8e --tag review -m server-1
$ rdc repo diff --name review --base myapp:work -m server-1
M  db/schema.sql

1 file changed: 0 added, 1 modified, 0 deleted, 0 renamed

Täieliku difividite kohta vaata rdc repo diff.

Ülevaadatud tööliini tagasi ühendamine

$ rdc repo merge --name myapp:main --from myapp:work -m server-1
Merged myapp:work into myapp:main

Ühendamine töötava sihtmärgiga

Ühendatud või töötav sihtmärk lükatakse tagasi, välja arvatud --force, mis vaikib selle esmalt:

$ rdc repo merge --name myapp:main --from myapp:work --force -m server-1
Merged myapp:work into myapp:main

Failipõhine kolmesuunaline ühendamine

Kaks harku (feature ja hotfix), mis on väljavõetud samast komitist, muutsid mõlemad mõningaid faile. --resolve theirs voldib allika (hotfix) sihtmärgile (feature): failid, mida muutis ainult üks pool, võetakse sellelt poolelt, ja failid, mida muutsid mõlemad pooled, lahendatakse allika kasuks. Alus tuvastatakse automaatselt jagatud esivanema põhjal (või kinnita --base-ga):

$ rdc repo merge --name myapp:feature --from myapp:hotfix --resolve theirs -m server-1
Merged myapp:hotfix into myapp:feature (three-way); 1 conflict(s) resolved --theirs: [config/app.yaml]

config/app.yaml muutus mõlemal poolel ja lahendati allika kasuks; fail, mille lisas ainult hotfix, rakendatakse, ja fail, mida muutis ainult feature, hoitakse. Konfliktsed teed raporteeritakse, et saad need üle vaadata.

Muutumatu aluse otse loomine

$ rdc repo fork --parent myapp --tag baseline-v1 --immutable -m server-1

Delta edastus ja tõmbamine

Muutumatu, baidiliselt stabiilne kujutis on ka alus plokitaseme delta edastusele. Kui sama muutumatu alus eksisteerib kahel masinal, saab edastamine arvutada muutunud plokid selle aluse vastu ja edastada ainult need, selle asemel et skannida kogu krüpteeritud kujutist. 1 GB repositoorium mõne muutunud plokiga edastatakse siis megabaitides.

Tavaliselt ei pea alust käsitsi andma. Pärast täielikku edastamist säilitab CLI edastatud kujutise muutumatu alusena mõlemal masinal ja salvestab selle, nii et järgmine selle repositooriumi edastamine saadab automaatselt ainult delta, ilma liputa, isegi hargi puhul, mis sihtmasinal juba eksisteerib. (Olemasoleva hargi täielikuks uuesti edastamiseks on endiselt vaja --force, kuna see asendab kogu kujutise, mitte ei rakenda verifitseeritud deltat.) Anna --delta-base <guid>, et kindlustada konkreetne alus, ja --strategy <auto|physical|shared>, et kontrollida, kuidas muutunud plokke tuvastatakse (auto on peaaegu alati õige).

# Esimene edastamine on täielik; see säilitab ka korduvkasutatava aluse mõlemal otsas.
$ rdc repo push --name myapp:work --to-machine backup-1 -m server-1

# Pärast lokaalseid muudatusi saadab järgmine edastamine ainult muutunud plokid, ilma liputa.
$ rdc repo push --name myapp:work --to-machine backup-1 -m server-1

# Kinnita selgesõnaline alus (muutumatu komit, mis on mõlemal masinal olemas).
$ rdc repo push --name myapp:work --to-machine backup-1 --delta-base 4f3c2a1b9d8e -m server-1

# Delta töötab ka vastupidises suunas, tõmmates ainult muutunud plokid masinalt.
$ rdc repo pull --name myapp:work --from-machine backup-1 --delta-base 4f3c2a1b9d8e -m server-1

# Tõmba uuesti olemasolev lokaalne repositoorium (kirjuta üle) koos --force.
$ rdc repo pull --name myapp:work --from-machine backup-1 --force -m server-1

Delta edastamine rakendub ainult masinate vahel (kaugarvutiga, millel on FIEMAP alus). Pilveobjektide salvestusele edastamine edastab alati täieliku kujutise. Alus peab mõlemal otsas baidiliselt identne olema, mis on täpselt see, mida muutumatu komit või --immutable hark garanteerib.

JSON-skeem

rdc repo log --json mähib renet-i tulemuse standardümbrikusse. Jalutatud ajalugu elab entries-is, uusimast esimesena:

Väli	Tüüp	Kirjeldus
success	boolean	Kas jalutamine lõpetati.
start	string	GUID, millest jalutamine algas.
entries	array	Üks objekt komiti kohta, uusimast esimesena.
entries[].guid	string	Komiti GUID.
entries[].message	string	Komiti sõnum. Välja jäetud, kui tühi.
entries[].author	string	Komiti autor. Välja jäetud, kui tühi.
entries[].parent	string	Vanema komiti GUID. Välja jäetud juurel.
entries[].committed_at	string	RFC 3339 komiti ajatempel. Välja jäetud, kui seadmata.
entries[].immutable	boolean	Kas komit on märgitud ainult lugemiseks (päris komiti puhul alati tõene).

Ümbriku väljade ja automaatse tuvastamise reeglite kohta, mis annavad JSON-i mitte-TTY keskkondades, vaata JSON Väljundi viide.

Piirangud

• Viited on lokaalsed. Harunimed, HEAD ja reflog elavad CLI konfiguratsioonis, mitte masinal. Komiti edastamine teisele masinale saadab komiti objekti ja selle mahusissese metaandmed, kuid haru viide on konfiguratsiooni poolne mõiste.
• Komit keeldub ühendamast. See on mõte: muutumatus muudab komiti baidiliselt stabiilseks. Komiti käivitamiseks või redigeerimiseks tee sellest esmalt checkout kirjutatavasse töötavasse harku.
• Ühendamise lahendamine on failipõhine, mitte reapõhine. Mõlemad, kogu kujutise võtmine allikast (ilma --resolve-ta) ja failipõhine kolmesuunaline (--resolve ours|theirs), on toetatud. Kolmesuunaline ühendamine lahendab konfliktid terve faili korraga vastavalt lipule; see ei anna reapõhiseid tükke ega ühendamise markereid faili sees.
• Ajalugu on vanemate ahel. rdc repo log jalutab üksiku parent lingi, mis salvestati komiteerimise ajal. See peatub, kui jõuab komitini, mille metaandmed pole küsitud masinal olemas.

Vaata ka

• rdc repo diff. Failitaseme diff iga kahe seotud komiti või hargi vahel.
• Repositooriumid. Repositooriumide loomine, hargnemine, ühendamine ja käitamine.