Skip to main content
Template builds can reuse cached file blobs, layers, and final artifacts when the builder inputs are compatible. Agent deployment installs are separate from template build cache. Deployed agents can build a reusable deployment artifact with nullspace agent deploy --rebuild; otherwise they fall back to running the configured install command inside each job run or service start when no custom template already contains those dependencies. Put heavy system packages or slow base dependency setup in a custom template when repeated install time is too expensive. Use skip_cache=True to bypass the whole build cache for one build: 
build = Template.build(
    builder,
    name="agent-template",
    tags=["stable"],
    skip_cache=True,
)
The TypeScript SDK does not expose whole-build skipCache or the per-step cache boundary yet; use the Python SDK, CLI, or HTTP API.
Use a builder cache boundary when only later steps should avoid cache reuse: 
builder = (
    Template()
    .from_python_image("3.12")
    .pip_install(["requests"])
    .skip_cache()
    .run_cmd("date > /workspace/build-time.txt")
)
Force a copied file to upload even when a cached blob may exist: 
builder = builder.copy("./model.bin", "/workspace/model.bin", force_upload=True)
Cache log entries expose a kind, status, reason, and subject when the backend reports them. 
status = build.get_status(offset=0)
for entry in status.entries:
    if entry.kind == "cache":
        print(entry.cache_kind, entry.cache_status, entry.cache_reason)
Template warm pools are separate from build cache. A pool can only fill when the resolved template build and runtime artifact are available on compatible hosts. If artifact preparation blocks fill, pool status reports reasons such as artifact_not_ready or artifact_prewarm_failed instead of treating the condition as a generic cold-start failure.