How-to guides

How-to guides are task-oriented recipes. Most assume a workspace (tailor.yaml plus one or more image.yaml files); the execution verbs (build, render with a real run) additionally need a container engine, and some steps need a registry login or a base-image catalogue. Each guide notes anything extra it needs.

Author a workspace

• Add an image
• Add an axis
• Share config with $include
• Override a base per axis

Choose a base image

• Build an image from an Azure Linux base
• Use a base-image catalogue
• Use a tools dir for sealed images

Build and select

• Select and build one cell
• Cross-arch building
• Build clones of a cell
• Change an output format
• Convert an image format
• Set the build directory

Pin and reproduce

• Pin the Image Customizer version
• Use a locally-built Image Customizer image

Environment and engine

• Select a container engine (Docker or Podman)

Pipelines and CI

• Export configs for a pipeline
• Handle exit codes in scripts

Signing and preview features

• Enable a preview feature
• Sign an image

Distribute and comply

• Build a portable binary
• Embed tailor in a monorepo
• Print third-party license notices