Overview

Pushing a network change straight to production and hoping it doesn’t cause an outage is a risky way to operate a fabric. nexus-pcv lets you validate a proposed change — a raw JSON payload or a terraform plan output from a Network as Code ACI project — against Nexus Dashboard Insights before it’s applied, waiting for the analysis to complete and surfacing any new anomalies or events the change would introduce while there’s still time to fix them.

$ nexus-pcv --help
Usage: nexus-pcv [OPTIONS]

  A CLI tool to perform a pre-change validation on Nexus Dashboard Insights.

Options:
  -v, --verbosity LVL         Either CRITICAL, ERROR, WARNING, INFO or DEBUG.
  -i, --hostname-ip TEXT      ND hostname or IP (required, env:
                               PCV_HOSTNAME_IP).
  -u, --username TEXT         ND username (required, env: PCV_USERNAME).
  -p, --password TEXT         ND password (required, env: PCV_PASSWORD).
  -d, --domain TEXT           ND login domain (optional, default: 'local',
                               env: PCV_DOMAIN).
  -g, --group TEXT            NDI insights group name (optional, default:
                               'default', env: PCV_GROUP).
  -s, --site TEXT             NDI site or fabric name (required, env:
                               PCV_SITE).
  -n, --name TEXT             NDI pre-change validation name (required, env:
                               PCV_NAME).
  --suppress-events TEXT      NDI comma-separated list of events to suppress
                               (optional, default: 'APP_EPG_NOT_DEPLOYED,APP_
                               EPG_HAS_NO_CONTRACT_IN_ENFORCED_VRF', env:
                               PCV_SUPPRESS_EVENTS).
  --timeout INTEGER            NDI pre-change validation timeout in minutes
                               (optional, default: 15, env: PCV_TIMEOUT).
  -f, --file FILE               NDI proposed change JSON file (optional, env:
                               PCV_FILE). Mutually exclusive with
                               --nac-tf-plan.
  -t, --nac-tf-plan FILE       NDI proposed change Terraform plan output
                               (optional, env: PCV_NAC_TF_PLAN). Mutually
                               exclusive with --file.
  -o, --output-summary FILE    NDI summary of new events/anomalies written to
                               a file (optional, env: PCV_OUTPUT_SUMMARY).
  -r, --output-url FILE        NDI link (URL) to pre-change validation
                               results written to a file (optional, env:
                               PCV_OUTPUT_URL).
  --version                    Show the version and exit.
  -h, --help                   Show this message and exit.