Plattformskatalogens förråd

Varje boundary ser plattformskatalogen: de blueprints som följer med i Blueprints-tjänstens avbild, plus de som hämtas från ett git-förråd. Vilket förråd, vilken gren och hur ofta väljs när plattformen installeras.

Inställningar

Installationsprogrammet frågar efter de tre första bland modulen Blueprints inställningar, under Blueprint catalog. De når tjänsten som miljövariabler från ConfigMap:en module-blueprints-config i stackship-system, och läses när den startar.

Miljövariabel	I installationsprogrammet	Standard	Betydelse
Blueprints__Catalog__RepositoryUrl	Blueprint catalog repository	https://github.com/Stackship-AB/blueprints.git	Förrådet som ska klonas, som en http- eller https-URL. Det klonas utan inloggningsuppgifter. Tomt: inget förråd — katalogen är bara det som följer med releasen
Blueprints__Catalog__Ref	Branch or tag	main	Grenen som ska klonas. Det måste vara en gren: en tagg eller en commit går inte att klona, och varje hämtning misslyckas
Blueprints__Catalog__RefreshIntervalSeconds	Refresh interval (seconds)	3600	Hur ofta förrådet hämtas. Värden under 60 räknas som 60
Blueprints__Catalog__Path	Frågas inte efter	blueprints	Mappen i förrådet vars kataloger är blueprints

Viktigt

Använd en https-URL. Ett http-förråd godtas, men det klonas utan transportskydd, så vem som helst på nätverksvägen kan ändra vad det levererar, och varje boundary driftsätter från den här katalogen. Den som kan pusha till förrådets gren bestämmer vad driftsättarna i varje boundary kör — se Hur en driftsättning går till.

Förrådets struktur beskrivs i Förrådets struktur.

Vad en hämtning gör

• När tjänsten startar läser den in de blueprints som följer med i dess avbild och hämtar sedan förrådet; därefter hämtar den vid varje intervall. Boundaryns katalogkällor synkas i samma omgång.
• En hämtning lägger till förrådets nya blueprints och uppdaterar ändrade. En blueprint i förrådet med samma slug som en medföljande ersätter den.
• En blueprint som har försvunnit ur förrådet tas bort ur katalogen, utom de som följer med releasen, som alltid ligger kvar. En blueprint vars mall inte längre går att tolka behåller sin senaste fungerande version.
• Blueprints som boundaries har publicerat själva rörs aldrig.
• Instanser som redan driftsatts från en borttagen blueprint fortsätter att köra.
• Undermoduler klonas inte, och en kloning som tar längre än två minuter avbryts.

När förrådet inte går att klona — det går inte att nå, fel gren eller mapp, tidsgränsen överskrids — förblir katalogen exakt som den var och varje blueprint i den kan fortfarande driftsättas. Tjänsten loggar Blueprint catalog could not be fetched; keeping the catalog as it is. med orsaken strax före. Tiden som portalen visar bredvid Katalog från är den senaste hämtningens, oavsett om den lyckades eller inte.

I en mall blir {{domain_suffix}} plattformens appdomän och {{cert_issuer}} den certifikatutfärdare som valdes vid installationen.

Hämta nu

Den som har blueprints/templates/write på en boundary kan hämta plattformskatalogen direkt med Uppdatera katalogen — se Uppdatera plattformskatalogen.