aac-init

aac-init

A CLI tool to bootstrap and configure ACI fabric using ACI as Code.

$ aac-init -h
Usage: aac-init [OPTIONS]

  A CLI tool to bootstrap and configure ACI fabric using ACI as Code.

Options:
  --version                       Show the version and exit.
  -d, --data PATH                 Path to aac-init YAML data files.
                                  [required]
  -l, --log-level [debug|info|warning|error|critical]
                                  Specify the logging level. Default setting
                                  is 'info'.  [default: info]
  -t, --max-switch-concurrent INTEGER
                                  A number of max TFTP concurrent requests.
  -h, --help                      Show this message and exit.

All data from the YAML files (-d/--data option) will use to bootstrap and configure ACI fabric.

In case there's bandwidth limitation with TFTP server and cannot support a large concurrent switch requests, use -t to limit switch concurrent requests, there's no limitation by default.

The data folder MUST use following structure, 00-global_policy.yml and 01-fabric_mgmt.yml are mandatory required, see docs/data_template for details.

data/
├── 00-global_policy.yml      # mandatory, ACI fabric global policies
└── nac_data
    ├── 01-fabric_mgmt.yml    # mandatory, ACI fabric switch connection information
    └── other-yaml-files..    # optional, other ACI as Code configurations

Prerequisite

• Working knowledge of ACI and Network as Code - ACI
• A HTTP/TFTP server is required to store APIC/ACI switch image for wiping/booting APIC/ACI switch to particular version. See docs/image_server if you don't have experience on setting up image server.

Installation

Python 3.10+ is required to install aac-init. Don't have Python 3.10 or later? See Python 3 Getting Started.

aac-init can be installed using pip:

pip install aac-init

You will also need to install ansible and related NetworkAsCode dependencies, see Cisco Network As Code - Ansible for details. You can also find requirements.yml/requirements.txt at docs/requirements.

apt-get install ansible
ansible-galaxy install -r requirements.yml
pip install -r requirements.txt

Usage

$ aac-init -d data/
Select single or multiple choice(s) to init ACI Fabric:
[1]  Wipe and boot APIC/switch to particular version
[2]  APIC initial setup (Single Pod)
[3]  Init ACI Fabric via NaC (Network as Code)
Example: (1,2,.. or *): *

Are you sure to proceed with the following choice(s)?
[1] Wipe and boot APIC/switch to particular version
[2] APIC initial setup (Single Pod)
[3] Init ACI Fabric via NaC (Network as Code)
 (yes, no) [yes]:

Update aac-init to latest version

pip install aac-init --upgrade

Uninstallation

pip uninstall aac-init

FAQ

Contact

Rudy Lei

Contributors

Rudy Lei
Yang Bian
Xiao Wang
Song Wang
Linus Xu