Skip to content

azldev_image_customize.md

Latest commit

 

History

History
63 lines (47 loc) · 2.92 KB

azldev_image_customize.md

File metadata and controls

63 lines (47 loc) · 2.92 KB

azldev image customize

Customizes a pre-built Azure Linux image

Synopsis

Customize a pre-built Azure Linux image using Azure Linux Image Customizer.

The customization is driven by a YAML config file that specifies packages to install, files to add, and other modifications. The base image can be a local file or a container tag from MCR.

azldev image customize [flags]

Examples

  # Customize a local image file
  azldev image customize --image-file base.vhdx --image-config config.yaml --output-path out/

  # Customize from a container tag
  azldev image customize --image-tag mcr.microsoft.com/azurelinux/base:4.0 \
    --image-config config.yaml --output-path out/

Options

      --disable-base-image-rpm-repos   Disable the base image's RPM repos as an RPM source
  -h, --help                           help for customize
      --image-config string            Path of the image customization config file
      --image-file string              Path of the base Azure Linux image to be customized. Cannot be specified with --image-tag
      --image-tag string               Container tag for the MCR base Azure Linux image to be downloaded and customized. Cannot be specified with --image-file
      --output-image-format string     Format of output image (vhd, vhd-fixed, vhdx, qcow2, raw, iso, pxe-dir, pxe-tar, cosi)
      --output-path string             Path to write the customized image artifacts to. It can be a path to a file if the output format is a single file format (e.g., vhd, qcow2), or a path to a directory if the output format is a multi-file format (e.g., pxe-dir, pxe-tar)
      --package-snapshot-time string   Only packages published before this snapshot time will be available during customization. Supports 'YYYY-MM-DD' or full RFC3339 timestamp (e.g., 2024-05-20T23:59:59Z)
      --rpm-source strings             Path to a RPM repo config file or a directory containing RPMs

Options inherited from parent commands

  -y, --accept-all                accept all prompts
      --color mode                output colorization mode {always, auto, never} (default auto)
      --config-file stringArray   additional TOML config file(s) to merge (may be repeated)
  -n, --dry-run                   dry run only (do not take action)
      --network-retries int       maximum number of attempts for network operations (minimum 1) (default 3)
      --no-default-config         disable default configuration
  -O, --output-format fmt         output format {csv, json, markdown, table} (default table)
      --permissive-config         do not fail on unknown fields in TOML config files
  -C, --project string            path to Azure Linux project
  -q, --quiet                     only enable minimal output
  -v, --verbose                   enable verbose output

SEE ALSO