From a875363e355cb84c7cf545bb7cd79ad0537ab2d3 Mon Sep 17 00:00:00 2001 From: Dag Wieers Date: Tue, 13 Feb 2018 13:54:44 +0100 Subject: [PATCH] ACI docs: Add more links to resources and community (#36101) This PR includes: - Adding more resources to each section - Improving wordings - Add links to the Ansible ACI community pages --- docs/docsite/rst/guide_aci.rst | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) diff --git a/docs/docsite/rst/guide_aci.rst b/docs/docsite/rst/guide_aci.rst index 41a514ddf27..84194889054 100644 --- a/docs/docsite/rst/guide_aci.rst +++ b/docs/docsite/rst/guide_aci.rst @@ -40,7 +40,7 @@ Various resources exist to start learning ACI, here is a list of interesting art - `Adam Raffe: Learning ACI `_ - `Luca Relandini: ACI for dummies `_ -- `Jacob McGill: Automating Cisco ACI with Ansible `_ +- `Cisco DevNet Learning Labs about ACI `_ Using the ACI modules @@ -89,6 +89,13 @@ For troubleshooting purposes setting ``output_level: debug`` or defining environ .. note:: The module return values are documented in detail as part of each module's documentation. +More information +................ +Various resources exist to start learn more about ACI programmability, we recommend the following links: + +- `Jacob McGill: Automating Cisco ACI with Ansible `_ +- `Cisco DevNet Learning Labs about ACI and Ansible `_ + .. _aci_auth: @@ -254,7 +261,11 @@ For instance, if you would like to ensure a specific tenant exists on ACI, these More information ................ +Plenty of resources exist to learn about ACI's APIC REST interface, we recommend the links below: + +- `The apic_rest Ansible module `_ - `APIC REST API Configuration Guide `_ +- `Cisco DevNet Learning Labs about ACI and REST `_ .. _aci_ops: @@ -262,7 +273,7 @@ More information Operational examples -------------------- Here is a small overview of useful operational tasks to reuse in your playbooks. -Feel free to contribute more snippets that are useful for others. +Feel free to contribute more snippets that are useful to others. Waiting for all controllers to be ready ....................................... @@ -340,7 +351,7 @@ All below issues either have been reported to the vendor, or can simply be avoid - **Too many consecutive API calls may result in connection throttling** - Starting with ACI v3.1 the APIC will actively throttle password-based authenticated connection rates over a specific treshold. This is as part of an anti-DDOS measure but can act up when using Ansible with ACI using password-based authentication. Currently, one solution is to increase this treshold within the nginx configuration, but it is advisable to use signature-based authentication as this also improves performance in general. + Starting with ACI v3.1 the APIC will actively throttle password-based authenticated connection rates over a specific treshold. This is as part of an anti-DDOS measure but can act up when using Ansible with ACI using password-based authentication. Currently, one solution is to increase this treshold within the nginx configuration, but using signature-based authentication is recommended. **NOTE:** It is advisable to use signature-based authentication with ACI as it not only prevents connection-throttling, but also improves general performance when using the ACI modules. @@ -370,3 +381,12 @@ All below issues either have been reported to the vendor, or can simply be avoid More information from: `#35544 aci_aaa_user: Setting user password is not idempotent `_ **NOTE:** There is no workaround for this issue. + + +.. _aci_community: + +ACI Ansible community +--------------------- +If you have specific issues with the ACI modules, or a feature request, or you like to contribute to the ACI project by proposing changes or documentation updates, look at the Ansible Community wiki ACI page at: https://github.com/ansible/community/wiki/Network:-ACI + +You will find our roadmap, an overview of open ACI issues and pull-requests and more information about who we are. If you have an interest in using ACI with Ansible, feel free to join ! We occasionally meet online to track progress and prepare for new Ansible releases.