tailor

Manifest-driven front-end for the Azure Linux Image Customizer.

tailor lets you describe Azure Linux images in small YAML definitions instead of hand-writing Docker/Image Customizer invocations. It merges layered image.yaml fragments, expands matrices into build cells, resolves base images, and runs the Azure Linux Image Customizer (mcr.microsoft.com/azurelinux/imagecustomizer) once per cell. The config: tree remains Image Customizer YAML: tailor passes it through without modeling the IC schema.

flowchart LR
  A["image.yaml"]
  F["by-<axis>/<value>.yaml fragments"]
  A --> M["matrix expansion"]
  F --> M
  M --> C["cells"]
  C --> IC["Image Customizer container"]
  IC --> O["artifacts"]

Documentation

This documentation is organized into four sections, each with a different job.

flowchart TD
  D["tailor docs"] --> T["Tutorials: learn by doing"]
  D --> H["How-to guides: solve a task"]
  D --> R["Reference: look up facts"]
  D --> E["Explanation: understand why"]

Sections

• Tutorials — start here if you are new to tailor.
• How-to guides — focused recipes for common tasks.
• Reference — complete CLI and YAML details.
• Explanation — the model behind workspaces, matrices, cells, and merging.

Quick links

• Installation
• Getting started
• Your first matrix
• CLI reference
• Image definition reference
• Merge directives
• Core concepts

Project

• Compatibility policy — what is stable across releases.
• Changelog — release history.
• Releases — signed binaries and provenance; see Installation for verification.