Hoe CoreCP-versies werken

CoreCP heeft één versienummer. Het staat links onderin het paneel, onder het logo, en het is hetzelfde nummer voor het paneel én voor de software die op je servers draait. Als je een vraag stelt aan support begint het antwoord bij dat nummer, dus deze pagina legt uit wat het betekent en hoe je het terugvindt.

Dat was niet altijd zo. Tot versie 0.50 had het paneel een eigen nummer en de serversoftware een ander — 0.21 tegenover 0.40, voor precies dezelfde uitgave. Wie dat naast elkaar zag, moest eerst te horen krijgen dat het hetzelfde was. Vanaf 0.50.0 is er nog één nummer, en dat nummer hoort bij een uitrol die het hele platform tegelijk bijwerkt.

Wat de drie cijfers betekenen

Een versie ziet eruit als 0.51.2. Van links naar rechts:

• Het eerste cijfer verandert alleen bij een omslag die handwerk op je servers kost. Dat gebeurt zelden en het wordt ruim van tevoren aangekondigd.
• Het tweede cijfer is de gewone weekuitgave. Daarin zit alles wat er die week af is gekomen: nieuwe schermen, verbeteringen, opgeloste fouten.
• Het derde cijfer is een tussentijdse reparatie. Daar zit nooit iets nieuws in — alleen een oplossing voor iets dat stuk was. Dat is met opzet: een reparatie die je met spoed installeert, moet zo klein en zo saai mogelijk zijn.

In spreektaal is "0.51" hetzelfde als 0.51.0. En als het eerste cijfer een keer op 1 komt te staan, betekent dat niet dat er iets anders gaat gelden: het is de mededeling dat het platform uit zijn opbouwfase is.

Nummers met een staartje

Soms staat er iets achter het nummer. Dat zegt hoe ver een uitgave is:

De volgorde klopt ook voor de pakketbeheerder op je server: een testbouw staat onder de kandidaat, de kandidaat onder de uitgave. Zo kan een server nooit terugvallen op iets dat er nieuwer uitziet dan het is.

Op je eigen server hoor je in de regel alleen het derde soort te zien staan. Zie je er een met ~dev of ~rc op een server die gewoon in productie draait, dan is daar iets misgegaan bij een uitrol en is dat het melden waard.

Waar je het nummer vindt

Het staat op twee plekken in het paneel:

1. Linksonder in de zijbalk, onder de naam van je platform. Je kunt erop klikken: dan opent Wat is er veranderd, met de uitgavenotities van elke versie en bovenaan de versie die je nu draait.
2. Platform → Algemeen. Daar staat het nummer met het woord erbij dat zegt welk soort bouw het is: Uitgave, Uitgavekandidaat of Testbouw.

Servers hebben geen eigen nummer meer om te tonen. Op de pagina van een server zie je welke versie daar draait, en bij een uitrol zie je per server of hij al op de nieuwe versie staat.

Wanneer er een nieuwe versie komt

Elke week wordt op maandag een kandidaat gemaakt van alles wat af is. Die draait een dag of twee op de testopstelling. Op dinsdag lees je het releasedossier — een korte pagina met wat erin zit en wat er gemeten is — en op woensdag wordt hij uitgerold, eerst op het paneel en daarna golfsgewijs over de servers.

Daarnaast zijn er twee kortere routes. Een reparatie kan op elke werkdag uitgaan en bevat alleen de oplossing van één probleem. Een spoeduitgave is voor een lek dat actief misbruikt wordt, voor dreigend gegevensverlies of voor een storing die het platform plat legt; die gaat er zo snel mogelijk uit en wordt daarna alsnog volledig nagelopen. Op vrijdag, zaterdag en zondag wordt er niet gewoon uitgerold.

Vanaf de terminal

Op een server vertelt de CoreCP-software zelf welke versie er draait:

corectl --version

corectl 0.51.0

En wat de pakketbeheerder van je server ervan vindt — dit is het nummer waarop een update besluit of er iets nieuwers is:

dpkg-query -W -f='${Version}\n' corecp-agent

0.51.0

Twijfel je of het ene nummer nieuwer is dan het andere, vraag het dan gewoon:

dpkg --compare-versions 0.51.0~rc.1 lt 0.51.0 && echo "de kandidaat staat onder de uitgave"

de kandidaat staat onder de uitgave

Zie ook

• Wat is er veranderd in het paneel: de uitgavenotities per versie.
• Welke versies we aanbieden — dat gaat over iets anders: welke PHP-, MariaDB- en Node.js-series je op je servers kunt kiezen, en hoe lang die nog ondersteund worden.
• Releases beheren — hoe een nieuwe versie bij je servers komt: kanalen, golven en terugrollen.