id       = "velero"
name     = "Velero"
homepage = "https://velero.io"
description = "A tool to back up and restore Kubernetes cluster resources and persistent volumes."
executables   = ["velero"]

[dotfiles]

# Velero's official installation guide says `velero client config set` stores
# client settings in $HOME/.config/velero/config.json.
# https://velero.io/docs/main/customize-installation/
paths = ["[configHome]/velero/config.json"]
secret = []

[commands]
format = 1
label = "Velero"
description = "Back up Kubernetes cluster resources and volumes."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["backup", "create"]
label = "Create a backup"
description = "Create a backup of cluster resources. Resource-type filters, hooks and snapshot options are left out."

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/vmware-tanzu/velero/blob/main/pkg/cmd/cli/backup/create.go"
revision = "main 2026-10-27"
evidence = """--ttl  How long before the backup can be garbage collected.
--include-namespaces  Namespaces to include in the backup (use '*' for all namespaces).
--exclude-namespaces  Namespaces to exclude from the backup.
--labels  Labels to apply to the backup.
--storage-location  Location in which to store the backup.
-l, --selector  Only back up resources matching this label selector.
--from-schedule  Create a backup from the template of an existing schedule.
--parallel-files-upload  Number of files uploads simultaneously when running a backup.
-w, --wait  Wait for the operation to complete.
velero backup create backupName --include-cluster-resources=true --include-namespaces=ns1"""

[[commands.subcommand.field]]
id = "name"
label = "Backup name"
description = "Optional when --from-schedule is used."
type = "string"
position = 0
sources = ["src"]

[[commands.subcommand.field]]
id = "include_namespaces"
label = "Include namespaces"
description = "Comma-separated; * for all."
type = "string"
option = ["--include-namespaces"]
sources = ["src"]

[[commands.subcommand.field]]
id = "exclude_namespaces"
label = "Exclude namespaces"
type = "string"
option = ["--exclude-namespaces"]
sources = ["src"]

[[commands.subcommand.field]]
id = "selector"
label = "Label selector"
type = "string"
option = ["--selector", "-l"]
sources = ["src"]

[[commands.subcommand.field]]
id = "include_cluster_resources"
label = "Include cluster resources"
type = "string"
option = ["--include-cluster-resources"]
suggestions = [{ value = "true", label = "Yes" }, { value = "false", label = "No" }]
sources = ["src"]

[[commands.subcommand.field]]
id = "ttl"
label = "TTL"
description = "How long before the backup can be garbage collected, e.g. 720h."
type = "string"
option = ["--ttl"]
sources = ["src"]

[[commands.subcommand.field]]
id = "storage_location"
label = "Storage location"
type = "string"
option = ["--storage-location"]
sources = ["src"]

[[commands.subcommand.field]]
id = "labels"
label = "Labels"
type = "string"
option = ["--labels"]
sources = ["src"]

[[commands.subcommand.field]]
id = "from_schedule"
label = "From schedule"
description = "Create from an existing schedule's template; cannot be combined with filters."
type = "string"
option = ["--from-schedule"]
sources = ["src"]

[[commands.subcommand.field]]
id = "parallel_files_upload"
label = "Parallel file uploads"
type = "integer"
option = ["--parallel-files-upload"]
sources = ["src"]

[[commands.subcommand.field]]
id = "wait"
label = "Wait for completion"
type = "boolean"
option = ["--wait", "-w"]
sources = ["src"]

[[commands.subcommand.task]]
id = "namespace_backup"
label = "Back up namespaces"
fields = ["name", "include_namespaces", "wait"]
required = ["name", "include_namespaces"]

[[commands.subcommand.task]]
id = "from_schedule"
label = "Back up from a schedule"
fields = ["name", "from_schedule", "wait"]
required = ["from_schedule"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["name", "include_namespaces", "exclude_namespaces", "selector", "wait"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["include_cluster_resources", "ttl", "storage_location", "labels", "from_schedule", "parallel_files_upload"]