Skip to content

Document the C++ cloud build image (Debian Bookworm) #5208

Description

@btshrewsbury-viam

Feature

C++ cloud build image (announced 2026-04-03, "C++ Cloud Build & Module Generator CLI"). C++ modules can be compiled through Viam's cloud build infrastructure using a standardized Debian Bookworm Docker image, alongside C++ module scaffolding via the CLI generator.

Current docs coverage

Partial. The C++ module generator is documented (docs/cli/reference.md --language cpp, docs/cli/build-and-deploy-modules.md), and cloud build is documented generally (docs/build-modules/overview.md, platform tags). Missing: the specific detail that C++ cloud builds run on a standardized Debian Bookworm image (all bookworm hits in the docs are about viam-agent/OS support, unrelated to the C++ build image).

Verified state / source PRs

  • viamrobotics/viam-cpp-sdk#548 — "Introduce lockfile for reproducible cloud builds" (merged)
  • viamrobotics/viam-cpp-sdk#616 — cloud build linkage fix (merged)

Proposed docs work

  • Type (Diátaxis): reference note (small).
  • Placement: add the build-image detail to the existing cloud build / module build docs (docs/build-modules/ cloud build section). Additive — a sentence/table row, no new page.
  • Draft learning objectives — users will be able to:
    1. [Understand] Identify which base image (Debian Bookworm) Viam cloud build uses to compile C++ modules, so they can match their local build environment and dependencies.

Target PR: small additive edit to the cloud build docs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions