Skip to main content

​
Blocking build

from nullspace import BuildError, Template

try:
    Template.build(builder, "broken-template")
except BuildError as exc:
    print(exc)
    if exc.error_detail:
        print(exc.error_detail.phase, exc.error_detail.suggested_action)

​
Background build

build = Template.build_in_background(builder, "maybe-broken")
try:
    snapshot = build.wait_until_terminal()
    print(snapshot.build.status)
except BuildError as exc:
    print(exc.error_detail.phase if exc.error_detail else exc)

​
Troubleshooting

SymptomCheck
Build context upload failsLarge local sources may need resumable file transfer and stable network access.
Dockerfile warning entriesNative-backend unsupported Dockerfile instructions are ignored and logged with line numbers. BuildKit-backed Dockerfiles use BuildKit failure and progress output instead.
Sandbox cannot start from templateCheck start command, readiness probe, and runtime envs.
Private registry pull failsConfirm registry auth helper and credential lifetime.