Build
Zodra een sjabloondefinitie klaar is, gebruik jeTemplate.build(...) om deze te builden. De build accepteert een sjabloonnaam plus optionele buildinstellingen zoals CPU, geheugen, tags, cachegedrag en een callback voor buildlogs.
Template.buildInBackground(...) / Template.build_in_background(...) en controleer later de buildstatus.
Namen
Elke build heeft een sjabloonnaam nodig. Houd namen stabiel voor een logische sjabloonfamilie, bijvoorbeeld:my-python-templateagent-runtime-basesandbox-webapp
Tags & versiebeheer
Met tags kun je builds labelen voor releasemanagement zonder de onderliggende sjabloonnaam te wijzigen. Typische patronen zijn onder andere:- semantische versies zoals
v1.0.0 - promotielabels zoals
stagingofproduction - bewegende kanalen zoals
latest
Logging
Buildlogs helpen je de voortgang van provisioning te inspecteren en fouten te diagnosticeren. Geef in JavaScript en TypeScriptonBuildLogs door aan Template.build(...). De SDK exporteert ook defaultBuildLogger(...) voor een standaard consolelogger.
Template.getBuildStatus(...) / Template.get_build_status(...) om de status te pollen en later logvermeldingen op te halen.
Foutafhandeling
Sjabloonbuilds kunnen om verschillende veelvoorkomende redenen mislukken:- ongeldige referenties voor een privΓ©registry
- mislukte pakketinstallaties binnen
runCmd(...)/run_cmd(...) - een startopdracht die onverwacht wordt afgesloten
- een ready-opdracht die nooit slaagt
- CPU- en geheugeninstellingen die niet voldoen aan de platformlimieten
- inspecteer eerst de buildlogs
- valideer de bronimage of Dockerfile van het sjabloon
- voer opnieuw uit met uitgeschakelde cache als je een verouderde laag vermoedt
- reduceer het sjabloon tot de kleinste instructiereeks die nog faalt
building, waiting, ready en error.