Skip to content
deps download

deps download

Overview

Force-downloads the latest dependency versions into the local cache.

Provider-specific dependencies are opt-in. By default, deps download downloads provider-neutral dependencies, core components, and the recommended addon component images needed by the default recommended seed.

  • Use --providers aws, --providers aws,google, or --providers all to include provider-specific entries.
  • Use --addons snapshot or --addons all to include extra addon components beyond the recommended defaults.
  • Pass -f/--cluster-config <path> specifying a cluster config file to infer providers.

The components manifest also declares the Git source Flux uses for platform component charts. deps download clones or fetches that repository into the local Git dependency cache unless --skip-components-git is set.

The local components images mirror only downloads images for the target architecture, such as arm64 or amd64.

  • You can specify one or both architectures with the --arch flag e.g. --arch arm64,amd64.
  • podplane cluster create uses the architectures configured for its VM pools and automatically fetches a required vmconfig manifest if it is not already cached. Use this command with --arch when you want to refresh an existing cached manifest before regenerating cluster Terraform files.
  • For component images:
    • Some registry views may still show the full list of architectures from the original upstream image, but architectures you did not download are not actually available in the local mirror.
    • Use the mirror for the local VM architecture you downloaded, not as a complete copy of the upstream registry.

For development, pass --vmconfig <path>, --components <path>, or --templates <path> to use local manifest JSON files instead of fetching published manifests from deps.podplane.dev. See Development for more information.

Pass --skip-seeds to skip seed file downloads while still downloading VMConfig artifacts, component images, and template charts.

Pass --skip-components-git to skip cloning or fetching the components Git source while still downloading component images.

podplane deps download [flags]

Options

FlagDescription
--dry-runPrint what would be downloaded without actually downloading anything
--arch stringComma-separated target architectures to download (amd64, arm64). Defaults to the configured architecture
--providers stringComma-separated provider-specific dependencies and component images to include, for example aws, google, or all
--addons stringComma-separated addon component images to include in addition to the recommended addons, or all
-f, --cluster-config stringPath to a cluster config file to infer providers
--vmconfig stringPath to a local vmconfig manifest JSON file
--components stringPath to a local components manifest JSON file
--templates stringPath to a local templates manifest JSON file
--seeds stringPath to a local seeds manifest JSON file
--skip-seedsSkip downloading seed manifests and snapshots
--skip-components-gitSkip cloning or fetching the Git source declared by the components manifest