MUST be invoked before any work involving: building container images, ov image build command, pushing to registries, merging layers, build caches, or Containerfile generation.
Invoked as ov image build. See /ov:image for the family overview.
ov image build generates Containerfiles from image.yml and layer definitions, then builds images in dependency order using the configured build engine (Docker or Podman). Images at the same dependency level are built in parallel (up to --jobs concurrent builds).
| Action | Command | Description |
|---|---|---|
| Build all images | ov image build | Build all images in dependency order |
| Build specific image | ov image build <image> | Build single image for host platform |
| Build and push | ov image build --push |
| Build all platforms and push to registry |
| Build without cache | ov image build --no-cache | Disable build cache entirely |
| Merge layers | ov image merge <image> | Post-build layer optimization |
ov image build [image...] # Build for local platform
ov image build --push [image...] # Build for all platforms and push
ov image build --platform linux/amd64 [image...] # Specific platform
ov image build --cache registry [image...] # Registry cache (read+write)
ov image build --cache image [image...] # Image cache (read-only, default)
ov image build --cache gha [image...] # GitHub Actions cache
ov image build --no-cache [image...] # Disable cache entirely
ov image build --jobs N [image...] # Max concurrent images per DAG level (default: 4)
ov image build --podman-jobs N [image...] # Max concurrent stages within a single podman build (default: min(NCPU, 4))
Containerfile generation is driven by a single declarative YAML file referenced in image.yml: