Distributions¶

Command descriptions¶

Command	What it does
hawkbit distributions list	Retrieves distribution sets.
hawkbit distributions create	Creates only a distribution set, or runs a full flow that creates module, uploads artifact, creates distribution, and associates module.
hawkbit distributions delete <distribution-id>	Deletes a distribution set by id (and can also delete associated modules).

distributions list¶

Purpose: inspect available distribution sets and versions.

hawkbit distributions list -o table

distributions create (distribution-only mode)¶

Purpose: create a distribution set directly without module/artifact automation.

Requires --name and --version.

hawkbit distributions create \
  --name my-distribution \
  --version 1.0.0 \
  -o table

distributions create (full flow mode)¶

Purpose: automate module + artifact + distribution creation in one command.

Full flow is enabled only when both --artifact and --module-name are present.

hawkbit distributions create \
  --module-name my-firmware \
  --artifact ./firmware-update.fw \
  --version 1.0.0 \
  -o table

Behavior:

• Software module vendor defaults to hawkbit-cli
• Distribution set name/version are set to the software module name/version

distributions delete¶

Purpose: remove an existing distribution set.

hawkbit distributions delete <distribution-id> -o table

Also delete software modules associated with the distribution:

hawkbit distributions delete <distribution-id> --delete-modules -o table