Build Configuration

generate Command¶

Generate network configurations, documentation, and ANTA tests from your AVD inventory.

Synopsis¶

avd-cli generate SUBCOMMAND [OPTIONS]

Subcommands¶

Subcommand	Description
`all`	Generate configurations, documentation, and tests
`configs`	Generate device configurations only
`docs`	Generate documentation only
`tests`	Generate ANTA test files only

Common Options¶

These options apply to all generate subcommands:

Option	Short	Type	Default	Description
`--inventory-path`	`-i`	Path	Required	Path to AVD inventory directory
`--output-path`	`-o`	Path	Required	Output directory for generated files
`--limit`	`-l`	Text	All	Filter devices by hostname or group patterns (repeatable, supports wildcards)
`--limit-to-groups`		Text	All	Deprecated. Use `--limit` instead. Limit to specific groups
`--workflow`		Choice	`eos-design`	Workflow type: `eos-design` or `cli-config`
`--show-deprecation-warnings`		Flag	`false`	Show pyavd deprecation warnings

generate all¶

Generate all outputs: configurations, documentation, and tests.

Usage¶

avd-cli generate all -i INVENTORY_PATH -o OUTPUT_PATH [OPTIONS]

Examples¶

# Basic usage
avd-cli generate all -i ./inventory -o ./output

# With specific workflow
avd-cli generate all -i ./inventory -o ./output --workflow eos-design

# Filter by group names
avd-cli generate all -i ./inventory -o ./output -l SPINES -l LEAFS

# Filter by hostname patterns (wildcards supported)
avd-cli generate all -i ./inventory -o ./output -l "spine*"

# Filter by specific hostnames
avd-cli generate all -i ./inventory -o ./output -l spine-01 -l leaf-1a

# Mix hostname and group filters
avd-cli generate all -i ./inventory -o ./output -l "spine*" -l BORDER_LEAFS

# Show deprecation warnings
avd-cli generate all -i ./inventory -o ./output --show-deprecation-warnings

Output Structure¶

output/
├── configs/
│   └── *.cfg                   # Device configurations
├── documentation/
│   ├── devices/
│   │   └── *.md                # Per-device documentation
│   └── fabric/
│       └── *-documentation.md  # Fabric-wide documentation
└── tests/
    ├── device1_tests.yaml      # ANTA tests for device1
    ├── device2_tests.yaml      # ANTA tests for device2
    └── ...                     # One test file per device

generate configs¶

Generate device configurations only.

Usage¶

avd-cli generate configs -i INVENTORY_PATH -o OUTPUT_PATH [OPTIONS]

Examples¶

# Generate all device configurations
avd-cli generate configs -i ./inventory -o ./output

# Filter by group name
avd-cli generate configs -i ./inventory -o ./output -l SPINES

# Filter by hostname pattern
avd-cli generate configs -i ./inventory -o ./output -l "spine-*"

# Filter specific devices
avd-cli generate configs -i ./inventory -o ./output -l spine-01 -l spine-02

# Use cli-config workflow (skip eos_design role)
avd-cli generate configs -i ./inventory -o ./output --workflow cli-config

Workflows¶

eos-design

Full AVD pipeline with topology design and validation: ```bash avd-cli generate configs -i ./inventory -o ./output –workflow eos-design

```

- Runs `eos_design` role to generate structured configs
- Validates topology structure
- Generates device configurations

cli-config

Direct configuration generation from existing structured configs: ```bash avd-cli generate configs -i ./inventory -o ./output –workflow cli-config

```

- Skips `eos_design` role
- Uses existing structured configs from `host_vars/`
- Faster for iterative testing

generate docs¶

Generate network documentation only.

Usage¶

avd-cli generate docs -i INVENTORY_PATH -o OUTPUT_PATH [OPTIONS]

Examples¶

# Generate all documentation
avd-cli generate docs -i ./inventory -o ./output

# Filter by group name
avd-cli generate docs -i ./inventory -o ./output -l RACK1

# Filter by hostname pattern
avd-cli generate docs -i ./inventory -o ./output -l "leaf-*"

# Filter specific devices
avd-cli generate docs -i ./inventory -o ./output -l spine-01

Generated Documentation¶

Per-device documentation: Detailed device configuration documentation
Fabric documentation: Fabric-wide topology and design documentation

generate tests¶

Generate test files for network validation using the ANTA framework or Robot Framework.

Usage¶

avd-cli generate tests -i INVENTORY_PATH -o OUTPUT_PATH [OPTIONS]

Options¶

Option	Short	Type	Default	Description
`--test-type`		Choice	`anta`	Test framework: `anta` or `robot`

Examples¶

# Generate ANTA tests (one file per device)
avd-cli generate tests -i ./inventory -o ./output

# Generate Robot Framework tests
avd-cli generate tests -i ./inventory -o ./output --test-type robot

# Filter by group name
avd-cli generate tests -i ./inventory -o ./output -l SPINES

# Filter by hostname pattern
avd-cli generate tests -i ./inventory -o ./output -l "spine-*"

# Filter multiple patterns
avd-cli generate tests -i ./inventory -o ./output -l "spine*" -l "leaf-1*"

ANTA Test Generation¶

The ANTA test generator creates comprehensive network validation tests by analyzing your AVD inventory and structured configurations. Each device receives its own test catalog file with device-specific tests.

Generated Test Structure¶

tests/
├── spine01_tests.yaml          # Tests for spine01
├── spine02_tests.yaml          # Tests for spine02
├── leaf-1a_tests.yaml          # Tests for leaf-1a
├── leaf-1b_tests.yaml          # Tests for leaf-1b
└── ...                         # One file per device

Test Categories¶

Each device test file includes the following categories when applicable:

Connectivity Tests

Internet connectivity validation (8.8.8.8)
Management interface reachability

BGP Tests

BGP ASN verification
BGP peer state validation
Address family configuration checks

EVPN Tests (for EVPN-capable devices)

EVPN peer count validation
VNI to VLAN mapping verification
EVPN Type-2 route checks

Interface Tests

Ethernet interface status validation
Loopback interface verification
Management interface checks

Hardware Tests

Power supply status
Cooling system validation
Temperature monitoring
Transceiver manufacturer checks
Platform-specific tests (DCS-7050, DCS-7280, DCS-7300)

System Tests

Uptime validation (minimum 24 hours)
Reload cause verification
Core dump detection
Agent log validation
NTP synchronization (when configured)

Device Role-Based Testing¶

Tests are automatically adapted based on device roles:

Spine devices: Focus on BGP underlay, hardware health, and system validation
Leaf devices: Include EVPN overlay tests, VLAN/VNI mappings, and access connectivity
Border leaf devices: Enhanced EVPN testing with external routing validation

Test Execution¶

Each generated test file is a complete ANTA catalog that can be executed independently:

# Execute tests for a specific device
anta nrfu --catalog spine01_tests.yaml --inventory inventory.yaml --limit spine01

# Execute all device tests in parallel
find tests/ -name "*_tests.yaml" -exec anta nrfu --catalog {} --inventory inventory.yaml \;

Environment Variables¶

All options support environment variables with the AVD_CLI_ prefix:

CLI Option	Environment Variable	Example
`-i, --inventory-path`	`AVD_CLI_INVENTORY_PATH`	`./inventory`
`-o, --output-path`	`AVD_CLI_OUTPUT_PATH`	`./output`
`-l, --limit`	`AVD_CLI_LIMIT`	`spine*,LEAFS`
`--workflow`	`AVD_CLI_WORKFLOW`	`eos-design`
`--show-deprecation-warnings`	`AVD_CLI_SHOW_DEPRECATION_WARNINGS`	`true`
`--test-type`	`AVD_CLI_TEST_TYPE`	`anta`

Example¶

export AVD_CLI_INVENTORY_PATH=./inventory
export AVD_CLI_OUTPUT_PATH=./output
export AVD_CLI_WORKFLOW=eos-design

# Now run without repeating options
avd-cli generate all

Advanced Usage¶

Selective Generation¶

The --limit option supports flexible device filtering using:

Group names: SPINES, LEAFS, BORDER_LEAFS
Hostname patterns: spine*, leaf-[12]*, border-?
Exact hostnames: spine-01, leaf-1a

Wildcard patterns:

* - Matches any characters: spine* matches spine-01, spine-02, spineA
? - Matches single character: leaf-? matches leaf-1, leaf-a
[...] - Matches character set: leaf-[12]a matches leaf-1a, leaf-2a

Examples:

# Filter by group name
avd-cli generate all -i ./inventory -o ./output -l SPINES

# Filter by hostname pattern (all spines)
avd-cli generate all -i ./inventory -o ./output -l "spine*"

# Filter specific devices
avd-cli generate all -i ./inventory -o ./output -l spine-01 -l spine-02

# Multiple groups and patterns
avd-cli generate all -i ./inventory -o ./output -l SPINES -l "border-*" -l leaf-1a

# Complex patterns
avd-cli generate all -i ./inventory -o ./output -l "spine-0[1-3]" -l "leaf-[12]?"

How Filtering Works

AVD needs all devices for topology context (BGP neighbors, MLAG peers, etc.)
Filtering happens after AVD facts calculation
Only output files for filtered devices are generated
This ensures configurations are correct even when filtering single devices

CI/CD Integration¶

#!/bin/bash
set -e

# Set paths
export AVD_CLI_INVENTORY_PATH="${CI_PROJECT_DIR}/inventory"
export AVD_CLI_OUTPUT_PATH="${CI_PROJECT_DIR}/output"

# Validate first
avd-cli validate

# Generate
avd-cli generate all

# Artifacts are now in $AVD_CLI_OUTPUT_PATH

Build Configuration

generate Command¶

Synopsis¶

Subcommands¶

Common Options¶

generate all¶

Usage¶

Examples¶

Output Structure¶

generate configs¶

Usage¶

Examples¶

Workflows¶

generate docs¶

Usage¶

Examples¶

Generated Documentation¶

generate tests¶

Usage¶

Options¶

Examples¶

ANTA Test Generation¶

Generated Test Structure¶

Test Categories¶

Device Role-Based Testing¶

Test Execution¶

Environment Variables¶

Example¶

Advanced Usage¶

Selective Generation¶

CI/CD Integration¶

See Also¶