Skip to content

azldev_component_render.md

Latest commit

 

History

History
73 lines (54 loc) · 2.83 KB

azldev_component_render.md

File metadata and controls

73 lines (54 loc) · 2.83 KB

azldev component render

Render post-overlay specs and sidecar files to a checked-in directory

Synopsis

Render the final spec and sidecar files for components after applying all configured overlays. The output is written to a directory as generated artifacts intended for check-in.

The output directory is set via rendered-specs-dir in the project config, or via --output-dir on the command line. If neither is set, an error is returned.

Unlike prepare-sources, render skips downloading source tarballs from the lookaside cache — only spec files, patches, scripts, and other git-tracked sidecar files are included. Multiple components can be rendered at once.

azldev component render [flags]

Examples

  # Render all components (output dir from config)
  azldev component render -a

  # Render a single component
  azldev component render -p curl

  # Render to a custom directory, allowing removal of existing rendered component directories
  azldev component render -a -o rendered/ --force

  # Render all and remove stale directories
  azldev component render -a --clean-stale

Options

  -a, --all-components                Include all components
      --clean-stale                   remove stale rendered directories not matching any current component (only with -a)
  -p, --component stringArray         Component name pattern
  -g, --component-group stringArray   Component group name
      --fail-on-error                 exit with error if any component fails to render (useful for CI)
  -f, --force                         allow overwriting existing rendered component directories
  -h, --help                          help for render
  -o, --output-dir string             output directory for rendered specs (overrides rendered-specs-dir from config)
  -s, --spec-path stringArray         Spec path

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