文件列表:

LICENSE (1060, 2022-11-10)
Makefile (92, 2022-11-10)
dnac_sidekick (0, 2022-11-10)
dnac_sidekick\__init__.py (0, 2022-11-10)
dnac_sidekick\cli.py (5567, 2022-11-10)
dnac_sidekick\device_commands (0, 2022-11-10)
dnac_sidekick\device_commands\__init__.py (0, 2022-11-10)
dnac_sidekick\device_commands\commands.py (3485, 2022-11-10)
dnac_sidekick\generate (0, 2022-11-10)
dnac_sidekick\generate\__init__.py (0, 2022-11-10)
dnac_sidekick\generate\commands.py (8330, 2022-11-10)
dnac_sidekick\generate\j2_templates (0, 2022-11-10)
dnac_sidekick\generate\j2_templates\pyats_testbed.j2 (647, 2022-11-10)
dnac_sidekick\health (0, 2022-11-10)
dnac_sidekick\health\__init__.py (0, 2022-11-10)
dnac_sidekick\health\commands.py (3464, 2022-11-10)
dnac_sidekick\helpers (0, 2022-11-10)
dnac_sidekick\helpers\topology.py (5385, 2022-11-10)
dnac_sidekick\inventory (0, 2022-11-10)
dnac_sidekick\inventory\__init__.py (0, 2022-11-10)
dnac_sidekick\inventory\commands.py (4849, 2022-11-10)
dnac_sidekick\licenses (0, 2022-11-10)
dnac_sidekick\licenses\__init__.py (0, 2022-11-10)
dnac_sidekick\licenses\commands.py (6176, 2022-11-10)
imgs (0, 2022-11-10)
imgs\get_client_health.png (140685, 2022-11-10)
imgs\get_device_health.png (183877, 2022-11-10)
imgs\get_device_licensing.png (103823, 2022-11-10)
imgs\get_network_inventory.png (254434, 2022-11-10)
imgs\get_specific_device.png (63304, 2022-11-10)
poetry.lock (39422, 2022-11-10)
pyproject.toml (1032, 2022-11-10)
tests (0, 2022-11-10)
tests\__init__.py (0, 2022-11-10)
... ...

[](https://github.com/psf/black) [](https://codecov.io/gh/dannywade/dnac-sidekick) [](https://developer.cisco.com/codeexchange/github/repo/dannywade/dnac-sidekick) # dnac-sidekick DNAC Sidekick is a CLI app used to interact with Cisco DNA Center (DNAC). It's built using the [Click](https://github.com/pallets/click) and [Rich](https://github.com/Textualize/rich) libraries. The Rich library is what helps make the output look cleaner to the end-user. The goal of the tool is to provide a clean and user-friendly CLI interface to quickly pull information from DNA Center. All interactions with DNAC uses DNA Center's REST API, so please make sure that the REST API is enabled and the user account(s) used with this tool have proper API permissions. ## Installation Install using `pip` or any other PyPi package manager: ``` pip install dnac-sidekick ``` ## Getting Started ### Authenticating to DNAC DNAC-Sidekick pulls all user-specific information from environmnet variables. Ideally, this would be a more automated process with less manual work for the user, but for now, the following environment variables must be set manually before using the tool: ``` export DNAC_URL= export DNAC_USER= export DNAC_PASS= ``` Once set, we will need to generate a bearer token, which is used to authenticate to the DNAC REST API. You can manually generate this token using curl or Postman, but there's also a built-in command that will generate one for you. This will only work if the URL, username, and password environment variables are set. ``` dnac-sidekick login Token generated successfully! Copy token below and set as environment variable for future requests: eyJhbGciOiJS..... ``` *IMPORTANT:* Please make sure to generate the bearer token using the `dnac-sidekick login` command *AFTER* setting the necessary environment variables. Once the token is generated, don't forget to set it as an environment variable as well. ``` export DNAC_TOKEN= ``` ## Usage To see what commands are available, use the `--help` option. Here's a brief look at the current root commands available: ``` Options: --help Show this message and exit. Commands: command-runner Run 'show' commands on network devices in DNAC. generate Action to generate testbeds and inventory files. get Action for read-only tasks and gathering information. login Use username and password to authenticate to DNAC. ``` ## Feature Highlights The goal is to provide features that help extract the most useful information from DNAC for the user. The tool is not built to have a command for every available DNAC API call - it's simply meant to be an engineer's *sidekick* :grin: when interacting with Cisco DNA Center. This feature list will grow, but here are the current tasks that can be performed using DNAC Sidekick: **Inventory** - Device information (all devices or a specific device via hostname) - Hostname - Device type - Serial number - Software version - Device license information - Network license level - DNA license level - License validity (valid or expired) - Virtual account - Device UDI **Assurance** - Device health - Client health - All - Wired - Wireless **Command Runner** - Run *valid* `show` commands on any device in DNAC inventory - Valid `show` commands are dictated by DNAC **Generate** - Ability to generate a pyATS testbed file from DNAC inventory - Ability to generate an Ansible inventory file from DNAC inventory ## Examples: **Inventory** ``` # All devices dnac-sidekick get inventory devices # Specific device dnac-sidekick get inventory devices --hostname leaf1.abc.inc # License info dnac-sidekick get licenses ``` **Assurance** ``` # Device health dnac-sidekick get health devices # Client health dnac-sidekick get health clients ``` **Command Runner** ``` dnac-sidekick command-runner --device leaf1.abc.inc --command "show run" ``` **Generate** ``` # pyATS testbed dnac-sidekick generate pyats-testbed # Ansible inventory dnac-sidekick generate ansible-inventory ```

Sample Outputs

***All sample outputs use the Cisco DevNet Always-on DNAC sandbox.*** ### Network Inventory  ### Network Inventory - Specific Device  ### Device Licensing  ### Device Health  ### Client Health 

## Compatibility Tested with: - DNA Center 2.2.3.4 - DNA Center 2.2.3.6 - DNA Center 2.3.4.0 *If you are able to test with other versions, please open a PR and add it to the list!* ## Credits This section is dedicated to those that have helped test and make this tool better! - [raoulmorik](https://github.com/raoulmorik)

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：