Kärpimine

Kärpimine eemaldab olekud, mis ei vasta enam elusale ressursile. Kaks käsku katavad kaht erinevat ulatust. Tükksalvestuses olevad tõmmised nende hulka ei kuulu: server kärbib need säilituspoliitika alusel, liini ja varundusvoo kaupa.

Käsk	Mida puhastab	Kus asub tõeallikas
rdc machine prune <machine>	Masinal olevad andmehoidla artefaktid (alati); orvuks jäänud või tundmatud hoidlakujutised (valikuline)	Kohalik CLI konfiguratsioon + masina .interim/state peegel
rdc config prune	Kohaliku konfiguratsiooni jäänukid (serdi vahemälu, aegunud arhiivid, rippuvad ristviited)	Ainult kohalik CLI konfiguratsioon

Need kaks on sõltumatud. Saad käivitada kumma tahes ilma teiseta. Need jagavad ühist ohutusmudelit, mida kirjeldatakse allpool jaotises Ohutus.

Kärpimine eemaldab oleku, mille on jätnud maha kustutatud ressursid. Elavate repositooriumite hõivatud ruumi tagasinõudmiseks (plokid, mille nende failisüsteemid on vabastanud, kuid bassein endiselt hoiab), kasuta selle asemel rdc repo trim; need kaks täiendavad teineteist.

Ühendamise ohutuse eelkontroll

machine prune --prune-unknown käivitab enne millegi kustutamist ühendamise ohutuse eelkontrolli: see pärib masinalt hetkel ühendatud või töötavaid hoidlaid, ristab need kustutamiskandidaatidega ja keeldub kustutamast kandidaati, mis on masinal endiselt aktiivne. Elava hoidla kujutise kustutamine on tõeline andmekao oht. Eelkontroll muudab selle õnnetusliku tegemise võimatuks.

Alistamiseks (harv; ainult siis, kui oled kindel, et elav olek on vale), lisa --force-delete-mounted. See on eraldi lipp --force’ist (mis juhib arhiivi armuaega), nii et kaks turvaluugi pääsu jäävad eraldatuks.

Varunduse tõmmised

Käsuga rdc backup snapshot üles laaditud tõmmised asuvad tükksalvestuses ja server kärbib neid ise. Kliendipoolset kärpimiskäsku ei ole: määra, kui palju ajalugu säilitada, ja server eemaldab ülejäänu.

Poliitika kuulub repositooriumi liinile, nii et repositoorium ja selle forkid jagavad seda, ning seda saab üle kirjutada ühe varundusvoo (üks repositoorium ühel masinal) jaoks. Lisaks säilitab iga voog poliitikast olenemata oma uusimad hetktõmmised ja praeguse ankru, nii et läbimine ei jäta voogu kunagi lootusetusse seisu.

# Näita kehtivat poliitikat ja kust see pärineb
rdc backup retention my-app

# Vaata, mida järgmine läbimine kustutaks ja kui palju ruumi see vabastaks, midagi kustutamata
rdc backup retention preview my-app

# Säilita 7 päevast, 4 nädalast ja 6 kuist tõmmist
rdc backup retention set my-app --keep-daily 7 --keep-weekly 4 --keep-monthly 6

# Kirjuta üle ainult üks voog
rdc backup retention set my-app --stream <stream-id> --keep-last 3

# Säilita jälle kõik tõmmised
rdc backup retention clear my-app

# Kustuta üks hetktõmmis kohe; järgmine prügikoristus vabastab selle ainuandmed
rdc backup snapshots delete my-app <snapshot-id>

Poliitika reeglid leiad jaotisest Varundus ja taastamine; käsk rdc backup usage näitab, mis salvestuses praegu on.

Masina kärpimine

Puhastab masinal olevad ressursid kolmes faasis. Faas 1 käivitub alati; faasid 2 ja 3 on valikulised ja neid saab kombineerida.

Faas 1: andmehoidla puhastamine (käivitub alati)

Eemaldab iga liiki ressursid, mis võivad jääda maha, kui hoidla kustutatakse või kui masina taseme refaktoreerimine pensioneerib nimetuskonventsiooni. Iga kategooria skannitakse iseseisvalt ja puhastamine on üks idemotentne läbimine, seega kärpimise kordamine on ohutu ja koondub puhtale andmehoidlale.

Kategooria	Mida eemaldab
Tühjad ühenduse kataloogid	mounts/<guid>/ kataloogid ilma toetava hoidlakujutiseta
Orvuks jäänud liigutamatud kataloogid	immovable/<guid>/ kataloogid ilma toetava hoidlakujutiseta
Aegunud lukufailid	repositories/.lock-<guid> kustutatud hoidlate jaoks
Aegunud varukoopiate hetktõmmised	.snapshot-* ja .backup-*, mis jäid maha katkestatud varundusjooksudest
Orvuks jäänud VS Code liivakasti kataloogid	.interim/sandbox/<name> hoidlate jaoks, mis ei ole masinal enam aktiivsed
Orvuks jäänud iptables-ahelad	REDIACC_WILDCARD_<N> ja DOCKER_ISOLATED_NET_<N> ahelad kustutatud võrkude jaoks
Orvuks jäänud authorized_keys kirjed	sandbox-gateway <repo> --guid <uuid> read, mille --guid ei vasta enam aktiivsele ühenduskataloogi GUID-ile

Authorized_keys skaneerimine vaatab /home/*/.ssh/authorized_keys ja /root/.ssh/authorized_keys. Kirje jäetakse alles ainult siis, kui selle --guid silt kaardistub elava ühenduskataloogi GUID-iga, seega masinal hetkel juurutatud hoidlad säilitatakse alati, sõltumata sellest, kas nende nimi esineb kusagil kettal. Pärandkirjeid, mis kirjutati enne, kui renet hakkas --guid silte lisama, ei saa valideerida ja neist teatatakse alati orvudena.

# Kuiv käivitus, näitab, mida eemaldataks (muudatusi ei rakendateta)
rdc machine prune server-1 --dry-run

# Käivita puhastamine
rdc machine prune server-1

Kaskaadpuhastamine. Mõned kategooriad sõltuvad varasematest. Näiteks tühjade ühenduskataloogide kustutamine võib paljastada täiendavaid liivakasti orve, mille toetav ühendus äsja kadus. rdc machine prune teine käivitamine tabab kaskaadi ja lõpetab puhastamise. Lõplik kuiv käivitus lõpeb teatega No orphaned resources found. Datastore is clean. kui midagi pole enam teha.

Faas 2: --orphaned-repos (jäme)

--orphaned-repos puhul kustutab CLI ka masinal olevad hoidlakujutised, mis ei esine üheski kohalikus konfiguratsioonifailis.

rdc machine prune server-1 --orphaned-repos --dry-run
rdc machine prune server-1 --orphaned-repos

See on jäme. See kustutab kõik, mis pole sinu kohalikus konfiguratsioonis, sealhulgas legitiimsed forkid, mida haldavad teised tööriistad või teise operaatori CLI väljavõte. Kui renet .interim/state peegel tuvastab hoidla korrektselt forkina, kuid kohalik konfiguratsioon pole seda kunagi näinud, eemaldab see faas selle ikkagi. Eelista 3. faasi (--prune-unknown), kui soovid olla konservatiivne.

Faas 3: --prune-unknown (kirurgiline)

--prune-unknown puhul kustutab CLI ainult hoidlad, mida mõlemad signaalid ei suuda klassifitseerida: pole üheski kohalikus konfiguratsioonis ega masina .interim/state peeglis fork-märgistatud kirjet (vt Hoidlad. Type veerg).

rdc machine prune server-1 --prune-unknown --dry-run
rdc machine prune server-1 --prune-unknown

Praktikas on --prune-unknown see, mida soovid rutiinil puhastamiseks; --orphaned-repos on õige ainult siis, kui oled kindel, et sinu kohalik konfiguratsioon on täielik ja autoriteetne inventuur kõigist hoidlatest masinal. Eelpeegli pärandforkid ja hoidlad, mille konfiguratsioonikirje kustutati kogemata, kuuluvad mõlemad “tundmatu” kategooriasse. Need on tõesti ebakindlad, ja kirurgiline lipp palub operaatoril seda sõnaselgelt tunnistada.

Ühendamise ohutuse eelkontroll töötab ka sellel faasil: hetkel --machine-l ühendatud hoidlast teatatakse ja see jäetakse vahele, välja arvatud siis, kui --force-delete-mounted on edastatud.

# Kombineeritud: täielik masina puhastamine kirurgilise fork-teadliku teega
rdc machine prune server-1 --prune-unknown

Konfiguratsiooni kärpimine

Puhastab aegunud jäänukid kohalikus konfiguratsioonifailis ~/.config/rediacc/<config>.json. Puhtalt kohalik. SSH-d ega renet-kutseid pole. Kolm korvikest puhastatakse:

1. ACME serdi-vahemälu kirjed, mille ankur (GUID, hoidla nimi või masina nimi) ei esine enam aktiivses konfiguratsioonis. Serdi metamärgid ei saa kunagi kusagile suunata, seega on need surnud kaal.
2. Aegunud arhiveeritud hoidlad resources.deletedRepositories[] sees. Kirjed, mille deletedAt on vanem kui defaults.pruneGraceDays (vaikimisi 7 päeva). Armuaja sees olevad kirjed esitatakse (koos allesjäänud päevadega) ja hoitakse alles.
3. Rippuvad ristviited konfiguratsioonikorvide vahel:
   • resources.machines.<m>.backupStrategies[] kirjed, mis nimetavad strateegiat, mida pole enam olemas.
   • resources.backupStrategies.<s>.exclude[] ja include[] kirjed, mis nimetavad hoidlat, mida pole enam olemas.

# Ainult eelvaade
rdc config prune --dry-run

# Rakenda (vaikekäitumine)
rdc config prune

# Piira ühe korvisena
rdc config prune --certs-only
rdc config prune --archives-only
rdc config prune --refs-only

# Eemaldage KÕIK arhiveeritud hoidlad sõltumata armuajast
rdc config prune --purge-archived

# Alista arhiivi armuajaaken selle kutsumise jaoks
rdc config prune --grace-days 30

Mida see EI puuduta

• Aktiivsed ressursid (masinad, hoidlad, varundustrateegiad, pilvepakkujad).
• Mandaadid, konto blokk, krüpterimisblokk, vaikeväärtused.
• knownHosts kirjed (automaatne värskendamise tee on rdc machine scan-keys).
• Tihendatud serdi blobimassiiv (infra.acmeCertCache.<base>.data[]) taastatakse automaatselt puhastatud serdinimistust; sa ei kaota ühtegi ahelat, mis katab endiselt säilitatud nime.

Töötav näide

Väljund reaalsest jooksust masinal, millel on neli orvu GUID-i metamärki ja kaks aegunud masina-nime metamärki:

Scanning local config for stale leftovers...
6 cert cache entry/entries would be removed:
  *.linode-1.rediacc.io  (unknown machine linode-1)
  *.marketing.linode-1.rediacc.io  (unknown machine linode-1)
  *.5b749533-99be-446c-9fe3-e6d0eec905a6.hostinger.rediacc.io  (unknown GUID 5b749533-…)
  *.5d09f3a6-9558-4df1-8a6e-b63140a6a7a6.hostinger.rediacc.io  (unknown GUID 5d09f3a6-…)
  *.e18d8c0f-367e-43c7-919e-2dbc59db4b5e.hostinger.rediacc.io  (unknown GUID e18d8c0f-…)
  *.9806c9b8-6bfb-4a87-9eaa-4b757ce1daca.hostinger.rediacc.io  (unknown GUID 9806c9b8-…)
Dry run: 6 change(s) would be applied. Re-run without --dry-run to commit.

Serdinimed, mille ankur on elav masin, hoidla või GUID, jäetakse alles, samuti kõik ühe-sildi <service>.<base> või juure *.<base> metamärgid.

Migreerimine: olekupeegli tagasiasustamine

.interim/state/<guid>/.rediacc.json peegel, mis toitab --prune-unknown ja rdc repo list -m veergu Type, kirjutatakse:

• Forki ajal (rdc repo fork). Kohe, isegi enne, kui fork on kunagi ühendatud.
• Iga olekusalvestuse korral (rdc repo up ja mis tahes toimingul, mis uuendab hoidla olekut). Hoidlate jaoks, mis loodi enne peegelkoodi laevamist.

Hoidlad, mis loodi enne peegli olemasolu ja mida pole pärast uuendust uuesti ühendatud, pole peeglifaili. Need kuvatakse rdc repo list -m all kui unknown, isegi kui mõned on legitiimselt forkid. Pärandforkide parandamiseks käivita masinal ühekordne tagasiasustamine:

sudo /usr/local/bin/renet repository backfill-state-mirror \
    --datastore /mnt/rediacc \
    --mark-as-fork <guid1>,<guid2>,<guid3>

Tagasiasustamine kopeerib hetkel ühendatud hoidlate jaoks otse mahus oleva oleku peeglisse ja kirjutab sünteetilise fork-märgistusega peegli mis tahes GUID-idele, mille lisad --mark-as-fork alla. Pärast tagasiasustamist lõpetavad ajakavastatud varukoopiad loetletud forkide üleslaadimise (üleslaadimise konveier kontrollib peegli is_fork: true olekut).

Ohutusmudel

Kärpimine on loodud olema mitme konfiguratsiooni seadistustes vaikimisi ohutu.

Mitme konfiguratsiooni teadlikkus

machine prune --orphaned-repos skannib kõik konfiguratsioonifailid ~/.config/rediacc/ kaustas, mitte ainult aktiivset. Hoidlale, millele viitab production.json, ei kustutata isegi siis, kui see puudub staging.json-ist. See väldib kogemata kustutamist, kui konfiguratsioonid on ulatuselt seotud erinevate keskkondadega.

Armuaeg

Kui hoidla eemaldatakse konfiguratsioonist --archive-config abil, liigutatakse selle mandaadikirje resources.deletedRepositories[] alla koos deletedAt ajatempliga. Kärpimiskäsud austavad armuaega (vaikimisi 7 päeva), mille jooksul on hiljuti arhiveeritud hoidlad kustutamise eest kaitstud. See annab sulle aega hoidla taastamiseks (rdc repo admin archive restore <guid>), kui see eemaldati kogemata. Pärast armuaja lõppu puhastavad machine prune ja config prune kirje automaatselt.

Ühendamise ohutuse eelkontroll

Käsitletud eespool. machine prune --prune-unknown keeldub kustutamast hoidlaid, mis on hetkel masinal ühendatud või töötavad. Alista ainult --force-delete-mounted abil.

Rakenda vaikimisi; --dry-run eelvaateks

Mõlemad kärpimiskäsud rakendavad muudatused vaikimisi. Edasta --dry-run kirjutamata eelvaateks. See vastab tegusõnale: “prune” on iseenesest destruktiivne, ja kuiva käivituse lipp on sõnaselge loobumisvõimalus.

Konfigureerimine

pruneGraceDays

Sea konfiguratsioonifailis kohandatud vaikearmuaeg, nii et sa ei pea iga kord --grace-days edastama:

# Sea armuaeg 14 päevale aktiivses konfiguratsioonis
rdc config field set --pointer /defaults/pruneGraceDays --new 14

--grace-days CLI lipp alistab selle väärtuse, kui see on esitatud.

Eeliskord

1. --grace-days <N> lipp (kõrgeim prioriteet)
2. pruneGraceDays konfiguratsioonifailis
3. Sisseehitatud vaikeväärtus: 7 päeva

Parimad tavad

• Käivita tootmises esmalt kuiv käivitus. Vaata enne destruktiivse kärpimise teostamist alati ette.
• Hoia mitut konfiguratsiooni ajakohasena. Masina kärpimine kontrollib kõiki konfiguratsioone konfiguratsioonikataloogis. Kui konfiguratsioonifail on aegunud või kustutatud, kaotavad selle hoidlad kaitse. Hoia konfiguratsioonifailid täpsena.
• Eelista --prune-unknown vs --orphaned-repos. Kirurgiline lipp austab renet-peegli; jäme lipp kustutab rõõmsalt teiste tööriistade loodud forkid.
• Kasuta tootmises suuremeelseid armuaegu. Vaikimisi 7-päevane armuaeg sobib enamiku töövoogudega. Ebaregulaarsetel hooldusakendega tootmiskeskkondade jaoks kaaluge 14 või 30 päeva.
• Määra säilituspoliitika. rdc backup retention set hoiab tõmmiste salvestuskulud kontrolli all ilma käsitsi sekkumiseta.
• Kombineeri masina kärpimine varundusajakavaga. Pärast varundusajakavade juurutamist (rdc backup schedule) lisa perioodiline masina kärpimine, et puhastada aegunud hetktõmmised ja orvuks jäänud andmehoidla artefaktid.
• Käivita config prune perioodiliselt. Kohaliku konfiguratsiooni paisumine (eriti serdi vahemälu) koguneb vaikselt; kord kvartalis tehtud config prune --dry-run on piisav selle tabamiseks.
• Auditeeri enne --force või --force-delete-mounted kasutamist. Mõlemad lipud mööduvad ohutuskontrollidest. Kasuta --force ainult siis, kui oled kindel, et ükski teine konfiguratsioon ei viita küsimuses olevatele hoidlatele; kasuta --force-delete-mounted ainult siis, kui oled kindel, et masina elav olek on vale.