Een release uitrollen
Sinds de overstap naar coreops maakt Claude een release op jouw commando, via /core-cut; een patch of noodupdate loopt via /core-hotfix. Wat hieronder staat, is wat daar vanzelf onder gebeurt.
Geschreven voor: Beheerder
Sinds de overstap naar coreops maakt Claude een release op jouw commando, via /core-cut; een patch of noodupdate loopt via /core-hotfix. Wat hieronder staat, is wat daar vanzelf onder gebeurt.
Een nieuwe CoreCP-versie — 0.51.0, 0.52.0, enzovoort — komt er op het moment dat jij (via Claude, met /core-cut) erom vraagt. Die wordt voor je klaargezet en getest; jij beslist of hij naar je servers gaat, en jij rolt hem uit. Deze pagina beschrijft jouw deel daarvan, van het lezen van het releasedossier tot de laatste golf servers.
Wat er vóór jouw beurt gebeurt, hoef je niet zelf te doen, maar het is goed om te weten:
- De kandidaat wordt gemaakt zodra jij om een release vraagt: een testversie van alles wat op dat moment klaar is, bijvoorbeeld
0.51.0~rc.1. Die wordt op de testopstelling geïnstalleerd zoals een echte server hem installeert — uit pakketten — en de volledige controleronde draait erop. Elke controleronde werkt in een eigen kopie van de code, met de webpakketten van precies die versie erin en dezelfde sleutels als de ontwikkelserver, zodat ook de controles in de browser en op de AI-koppeling echt draaien. Van elke ronde wordt per controle bewaard op welke versie van de code hij slaagde of faalde, ook als de ronde halverwege stopt; dat bewijs blijft op de ontwikkelserver. - Na minstens twee uur op de testopstelling zonder nieuwe bevinding wordt de release zelf gemaakt (
0.51.0) en ligt er een releasedossier voor je klaar. - Daarna rol jij uit, zodra het jou uitkomt.
Op vrijdag, zaterdag en zondag wordt er niet gewoon uitgerold. Komt een kandidaat laat in de week klaar, dan wacht de uitrol gewoon tot na het weekend.
Het releasedossier lezen
Het dossier is één pagina per versie, in docs/release-decisions/ van de broncode, met de datum en het versienummer in de naam. Je krijgt het pad toegestuurd. Lees het in deze volgorde; dat kost vijf tot tien minuten:
- Status bovenaan: staat er "waiting for the owner's decision", dan is de release klaar voor jouw besluit.
- Gate evidence: welke kandidaat is getest, hoeveel controles slaagden, en de vingerafdruk van het logboek. Dit is hetzelfde bewijs dat je paneel straks controleert bij het uitrollen. Staat er ook een regel full source gate, dan is de pakketcontrole beperkt tot de kernset uit
ops/config.json; de rest van die controleronde is die week uit de broncode gemeten in plaats van uit pakketten. Staat er source evidence (per step), dan is er geen volledige controleronde op precies deze code geweest, maar is elke controle afzonderlijk groen geweest op een eerdere versie waarin niets is veranderd wat die controle meet, hooguit zeven dagen geleden; de releasetool heeft dat per controle nagerekend. - Go/no-go record: negen stukken bewijs, elk met met, not met of not measured, en een aanbeveling. Een aanbeveling is geen besluit.
- Rollback: hoe je terug kunt naar de vorige versie, mocht dat nodig zijn.
- Open points: punten die nog iemand moet afhandelen.
Je besluit schrijf je op de regel Decision in het dossier: GO, GO WITH CONDITIONS, NO-GO of DEFER. Niemand anders vult die regel in.
Uitrollen op het paneel
Een uitrol gaat altijd in dezelfde volgorde: eerst je pakketbron en het paneel zelf, daarna de servers in golven.
1. De release op je eigen pakketbron zetten
- Ga naar Releases → Productiebron.
- Controleer in het vak dat de werksleutel geldig is. Staat er dat hij verlopen of ingetrokken is, dan kan uitrollen niet; volg dan het draaiboek sleutelbeheer.
- Vul bij Releaseset de versie in, bijvoorbeeld
0.51.0, en bij Reden een korte zin, bijvoorbeeld "weekrelease 0.51". - Klik Uitrollen. Het paneel vraagt je tweede factor.
- In het logvak zie je drie stappen: ophalen, controleren en publiceren. Bij controleren kijkt het paneel of de set ondertekend is door de bouwserver, of elk pakket klopt, en of het poortbewijs het bewijs is dat in het dossier stond. Klopt er iets niet, dan wordt de set geweigerd met de reden erbij en blijft de vorige versie op je bron staan.
Na klaar kunnen je servers de nieuwe versie ophalen. Er is dan nog niets geïnstalleerd.
2. Het paneel zelf bijwerken
Het paneel moet altijd minstens zo nieuw zijn als de servers die het beheert. Het werkt zichzelf bij op de paneelserver (zie Vanaf de terminal hieronder). Onder Releases → Uitrolplan zie je daarna bij Het paneel de nieuwe versie en de uitkomst van de bijwerking.
3. De servers in golven
- Blijf op Releases → Uitrolplan. Het plan staat er al: eerst het paneel, dan golf 1 met de testserver, dan golf 2, dan golf 3.
- Klik Uitrol volgens plan starten en bevestig met je tweede factor. Het paneel weigert de start zolang het zelf nog niet voorop loopt — werk dan eerst stap 2 af. Met die bevestiging werkt de uitrol alle servers in het plan bij, ook als het er meer dan vijf zijn; hij stopt niet halverwege om je opnieuw te laten bevestigen.
- Volg de uitrol op Vloot-updates. De eerste golf is de kanarie: pas als die gezond is, gaat de volgende golf. Wacht een golf op jou, dan staat de uitrol onder Loopt nu met Golf 3 · web wacht op jouw akkoord — het nummer en de naam uit het uitrolplan. Klik Rest laten volgen om door te gaan, of Stoppen om de wachtende servers over te slaan.
- Een server die vóór de uitrol al niet gezond was, wordt overgeslagen met de reden erbij. Los dat op en start daarna een herstel-uitrol.
- Weigert het paneel de herstel-uitrol omdat een andere uitrol de server nog vasthoudt, dan noemt de melding die uitrol en linkt ernaartoe. Maak die eerst af (of stop hem) en start de herstel-uitrol daarna.
- Een gestopte uitrol staat op Vloot-updates onder Vastgelopen updates, met Herstel-update starten voor de servers die achterbleven. Werk je zo'n server op een andere manier bij (met de hand, een latere uitrol, of de eigen timer van de server), dan noemt de kaart hem als buiten de uitrol bijgewerkt zodra hij ná het stoppen de doelversie of nieuwer meldt, en dekt de herstel-update alleen nog de rest. Zijn alle achtergebleven servers zo bijgewerkt en staat er geen incident van die uitrol open, dan verdwijnt hij van Vastgelopen updates en staat hij alleen nog in Eerdere uitrollen. Een server die niets meldt of een oudere versie meldt, houdt de kaart staan. Meer hierover in Releases beheren.
Is de laatste golf bijgewerkt, dan ben je klaar. Informeer je klanten via de statuspagina en de kanalen van je eigen bedrijf; CoreCP stuurt zelf alleen meldingen in het paneel en per mail.
Terug naar de vorige versie
Gaat er iets mis, dan staat in het dossier onder Rollback precies wat je doet. In het kort:
- Op Releases → Productiebron vul je de vorige versie in en klik je Uitrollen: je bron houdt de huidige en drie vorige versies bij.
- Het paneel zet zichzelf terug zolang de laatste databasestap niet gedraaid heeft.
- Servers die de nieuwe versie al hebben, zet je per server terug.
Een fout die niet tot de volgende cut kan wachten, gaat via een reparatie of een spoeduitgave: zie Patch en noodupdate.
Vanaf de terminal
Op de paneelserver, als root:
# Wat de bron serveert, welke sleutel tekent, of uitrollen kan
corecp-panel dist status
# De release ophalen, controleren en publiceren (hetzelfde als de knop Uitrollen)
corecp-panel dist publish 0.51.0 --reason "weekrelease 0.51"
# Het paneel zelf bijwerken: back-up, wisselen, controleren, afronden
corecp-panel self-update --to 0.51.0
corecp-panel self-update status
# Terug naar het vorige paneelpakket, zolang de laatste databasestap niet gedraaid heeft
corecp-panel self-update --rollbackOp een server zie je welke versie draait en welke bron hij vertrouwt:
corectl --version
corectl update trustEen component uitrollen (niet hetzelfde als een release)
Een release is CoreCP zelf — het paneel en de agent, met één versienummer. Daarnaast draaien op je servers onderdelen die CoreCP herbouwt uit de bron van de leverancier of van Debian: ProFTPD, Rspamd. Die zitten niet in een release en rol je apart uit.
Waar: Servers → Componenten & beveiliging, klik het onderdeel aan. Staat er een pakket klaar dat gebouwd én op de testomgeving getest is, dan staat daar de knop Uitrollen via patchroute. Je vinkt de servers aan, kunt eerst proefdraaien, en krijgt per server één regel terug.
Het verschil met de knop hierboven, in één zin: bij een release beslis jij welke versie van CoreCP de vloot krijgt; hier beslis je welke servers een herbouwd onderdeel krijgen. Geen van beide gebeurt vanzelf.
Wat de server zelf doet is in beide gevallen hetzelfde: hij controleert de handtekening en de bytes voordat er iets wordt uitgepakt, en installeert niets als er iets niet klopt. Zie Componenten en beveiliging voor wat je op die pagina leest en hoe je een onderdeel terugrolt.
Een spoedfix van een onderdeel: het paneel rolt hem zelf uit
Een onderdeel dat de bouwserver als spoed markeert neemt noch de golf, noch het nachtelijke venster. Je productiebron pikt het binnen minuten op en het paneel rolt het zelf uit: eerst naar één proefserver per rol, die het tien minuten in het oog houdt, daarna naar de rest in groepen van een kwart. Wordt een proefserver of een groep rood, dan wordt die teruggedraaid en stopt de uitrol, met een kritieke melding die de controle noemt. Een fix met het niveau security wacht op het eigen venster van de servers die nacht, proefserver eerst; Nu uitrollen bij de bevinding tilt hem naar de spoedroute. Het ondertekende releasemanifest draagt het niveau, dus een server neemt een pakket buiten zijn venster alleen als de bouwserver het als spoed ondertekende.
Zie ook
- Releases beheren — het releasebord, het uitrolplan en de noodbaan.
- Patch en noodupdate — een reparatie tussen twee weekreleases door.
- Hoe CoreCP-versies werken — wat de cijfers en de staartjes betekenen.
- Componenten en beveiliging — de andere serversoftware, en de patchroute.
Herstartplan en uitrolplan zijn twee plannen
Op Servers → Onderhoud staat ook een plan met vakken en volgorde, en dat is een ander plan dan dit. Het uitrolplan hierboven gaat over de volgorde waarin een nieuwe versie de servers bereikt; het herstartplan gaat over de volgorde waarin servers 's nachts naar beneden gaan om te herstarten.
Ze lijken op elkaar en hebben andere regels. Een uitrol begint altijd met het paneel, omdat het paneel nooit ouder mag zijn dan de servers die het aanstuurt. Een herstartnacht eindigt met het paneel, en alleen als je daar apart akkoord op geeft — want tijdens die herstart is er geen paneel.
Vloot zonder Vernieuwen (navigatieronde, item 0155)
De pagina Vloot heeft geen knop Vernieuwen meer: ze leest zichzelf opnieuw zodra een uitrol iets meldt, en de regel Laatst uitgelezen onder de kop draagt het ⟳-pictogram. Nieuwe update blijft de ene knop; de kanalen, een gestopte uitrol en het herstel staan in hun eigen kaarten onder de lijst.