Documentation for version v1.18 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
Namespace Glob Patterns
When using --include-namespaces and --exclude-namespaces flags with backup and restore commands, you can use glob patterns to match multiple namespaces.
Supported Patterns
Velero supports the following glob pattern characters:
-
*- Matches any sequence of charactersvelero backup create my-backup --include-namespaces "app-*" # Matches: app-prod, app-staging, app-dev, etc. -
?- Matches exactly one charactervelero backup create my-backup --include-namespaces "ns?" # Matches: ns1, ns2, nsa, but NOT ns10 -
[abc]- Matches any single character in the bracketsvelero backup create my-backup --include-namespaces "ns[123]" # Matches: ns1, ns2, ns3 -
[a-z]- Matches any single character in the rangevelero backup create my-backup --include-namespaces "ns[a-c]" # Matches: nsa, nsb, nsc
Unsupported Patterns
The following patterns are not supported and will cause validation errors:
**- Consecutive asterisks|- Alternation (regex operator)()- Grouping (regex operators)!- Negation{}- Brace expansion,- Comma (used in brace expansion)
Special Cases
*alone means “all namespaces” and is not expanded- Empty brackets
[]are invalid - Unmatched or unclosed brackets will cause validation errors
Examples
Combine patterns with include and exclude flags:
# Backup all production namespaces except test
velero backup create prod-backup \
--include-namespaces "*-prod" \
--exclude-namespaces "test-*"
# Backup specific numbered namespaces
velero backup create numbered-backup \
--include-namespaces "app-[0-9]"
# Restore namespaces matching multiple patterns
velero restore create my-restore \
--from-backup my-backup \
--include-namespaces "frontend-*,backend-*"
Getting Started
To help you get started, see the documentation.