archive
/
ansible
mirror of https://github.com/ansible/ansible.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Table fixing (#60177)

Browse Source 
* Change formatting of the network/user_guide tables

* Tables had hardcoded line breaks to workaround a bug in the
  read-the-docs theme.  Change those so that they now flow according to
  the browser size.

* Also switch away from grid tables to the simpler to create and read
  simple tables

* Changes to table stylesheet

* valign all content, not just the first column.  This becomes important
  with more than two columns
* Set the font-weight to the first <p> element inside of the first
  column.  This allows us to simplify the first column when everything
  there is the attribute name

* Change platform_index footnote from numbered to dagger symbol

The footnote notation was very odd to read.  Try using a symbol for the
footnote instead of a number to see if that will clarify it.  We can't
manually specify symbolled footnotes, though, so we have to emulate a
footnote with an internal link.  This loses the backref to each place
that the footnote was used but since that was the portion which was hard
to read, perhaps that's for the best.
pull/60549/head
Toshio Kuratomi 5 years ago committed by Alicia Cozine
parent 14a7722e39
commit 3f784caed1
21 changed files with 533 additions and 447 deletions
Show Stats Download Patch File Download Diff File

13
docs/docsite/_static/ansible.css
Unescape Escape View File

@ -38,16 +38,27 @@
* required is given the class .value-required * required is given the class .value-required
*/ */
/* The extra .rst-content is so this will override rtd theme */
.rst-content table.documentation-table td {
vertical-align: top;
}
table.documentation-table td:first-child { table.documentation-table td:first-child {
white-space: nowrap; white-space: nowrap;
vertical-align: top; vertical-align: top;
} }
table.documentation-table td:first-child p:first-child {
font-weight: bold;
display: inline;
}
/* This is now redundant with above position-based styling */
/*
table.documentation-table .value-name { table.documentation-table .value-name {
font-weight: bold; font-weight: bold;
display: inline; display: inline;
} }
*/
table.documentation-table .value-type { table.documentation-table .value-type {
font-size: x-small; font-size: x-small;
color: purple; color: purple;

45
docs/docsite/rst/network/user_guide/platform_cnos.rst
Unescape Escape View File

@ -11,26 +11,31 @@ CNOS supports Enable Mode (Privilege Escalation). This page offers details on ho
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | with ``ansible_become_method: enable``
+---------------------------+-----------------------------------------------+ and ``ansible_become_password:``
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, CNOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, CNOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

45
docs/docsite/rst/network/user_guide/platform_dellos10.rst
Unescape Escape View File

@ -11,26 +11,31 @@ OS10 supports Enable Mode (Privilege Escalation). This page offers details on ho
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | with ``ansible_become_method: enable``
+---------------------------+-----------------------------------------------+ and ``ansible_become_password:``
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, OS10 still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, OS10 still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

45
docs/docsite/rst/network/user_guide/platform_dellos6.rst
Unescape Escape View File

@ -11,26 +11,31 @@ OS6 supports Enable Mode (Privilege Escalation). This page offers details on how
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | with ``ansible_become_method: enable``
+---------------------------+-----------------------------------------------+ and ``ansible_become_password:``
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, OS6 still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, OS6 still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

45
docs/docsite/rst/network/user_guide/platform_dellos9.rst
Unescape Escape View File

@ -11,26 +11,31 @@ OS9 supports Enable Mode (Privilege Escalation). This page offers details on how
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | with ``ansible_become_method: enable``
+---------------------------+-----------------------------------------------+ and ``ansible_become_password:``
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, OS9 still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, OS9 still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

45
docs/docsite/rst/network/user_guide/platform_enos.rst
Unescape Escape View File

@ -11,25 +11,32 @@ ENOS supports Enable Mode (Privilege Escalation). This page offers details on ho
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | with ``ansible_become_method: enable``
and ``ansible_become_password:``
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
+---------------------------+-----------------------------------------------+ +---------------------------+-----------------------------------------------+
For legacy playbooks, ENOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, ENOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

68
docs/docsite/rst/network/user_guide/platform_eos.rst
Unescape Escape View File

@ -11,35 +11,45 @@ Arista EOS supports multiple connections. This page offers details on how each c
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+---------------------------------------------+ .. table::
|.. | CLI | eAPI | :widths: auto
+===========================+===============================================+=============================================+ :class: documentation-table
| **Protocol** | SSH | HTTP(S) |
+---------------------------+-----------------------------------------------+---------------------------------------------+ ==================== ========================================== =========================
| | **Credentials** | | uses SSH keys / SSH-agent if present | | uses HTTPS certificates if present | .. CLI eAPI
| | | | accepts ``-u myuser -k`` if using password | | | ==================== ========================================== =========================
+---------------------------+-----------------------------------------------+---------------------------------------------+ Protocol SSH HTTP(S)
| **Indirect Access** | via a bastion (jump host) | via a web proxy |
+---------------------------+-----------------------------------------------+---------------------------------------------+ Credentials uses SSH keys / SSH-agent if present uses HTTPS certificates if
| | **Connection Settings** | | ``ansible_connection: network_cli`` | | * ``ansible_connection: httpapi`` | present
| | | | | | OR | accepts ``-u myuser -k`` if using password
| | | | | | |
| | | | | | * ``ansible_connection: local`` | Indirect Access via a bastion (jump host) via a web proxy
| | | | | | with ``transport: eapi`` |
| | | | | | in the ``provider`` dictionary | Connection Settings ``ansible_connection: network_cli`` ``ansible_connection: httpapi``
+---------------------------+-----------------------------------------------+---------------------------------------------+
| | **Enable Mode** | | supported - use ``ansible_become: yes`` | | supported: | OR
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | | * ``httpapi`` |
| | | | | | uses ``ansible_become: yes`` | ``ansible_connection: local``
| | | | | | with ``ansible_become_method: enable`` | with ``transport: eapi``
| | | | | | | in the ``provider`` dictionary
| | | | | | * ``local`` |
| | | | | | uses ``authorize: yes`` | |enable_mode| supported: |br| supported: |br|
| | | | | | and ``auth_pass:`` |
| | | | | | in the ``provider`` dictionary | * use ``ansible_become: yes`` * ``httpapi``
+---------------------------+-----------------------------------------------+---------------------------------------------+ with ``ansible_become_method: enable`` uses ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | ``stdout[0].messages[0].`` | with ``ansible_become_method: enable``
+---------------------------+-----------------------------------------------+---------------------------------------------+
* ``local``
uses ``authorize: yes``
and ``auth_pass:``
in the ``provider`` dictionary
Returned Data Format ``stdout[0].`` ``stdout[0].messages[0].``
==================== ========================================== =========================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, EOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` or ``ansible_connection: httpapi`` as soon as possible. For legacy playbooks, EOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` or ``ansible_connection: httpapi`` as soon as possible.

43
docs/docsite/rst/network/user_guide/platform_eric_eccli.rst
Unescape Escape View File

@ -11,26 +11,29 @@ Extreme ERIC_ECCLI Ansible modules only supports CLI connections today. This pag
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | not supported by ERIC_ECCLI |
| | (Privilege Escalation) | | | Connection Settings ``ansible_connection: network_cli``
| | | | |
+---------------------------+-----------------------------------------------+ |enable_mode| not supported by ERIC_ECCLI
| **Returned Data Format** | ``stdout[0].`` |
+---------------------------+-----------------------------------------------+ Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
ERIC_ECCLI does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``. ERIC_ECCLI does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``.

46
docs/docsite/rst/network/user_guide/platform_exos.rst
Unescape Escape View File

@ -11,28 +11,30 @@ Extreme EXOS Ansible modules support multiple connections. This page offers deta
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+-----------------------------------------+
|.. | CLI | EXOS-API | .. table::
+===========================+===============================================+=========================================+ :widths: auto
| **Protocol** | SSH | HTTP(S) | :class: documentation-table
+---------------------------+-----------------------------------------------+-----------------------------------------+
| | **Credentials** | | uses SSH keys / SSH-agent if present | | uses HTTPS certificates if present | ==================== ========================================== =========================
| | | | accepts ``-u myuser -k`` if using password | | | .. CLI EXOS-API
+---------------------------+-----------------------------------------------+-----------------------------------------+ ==================== ========================================== =========================
| **Indirect Access** | via a bastion (jump host) | via a web proxy | Protocol SSH HTTP(S)
+---------------------------+-----------------------------------------------+-----------------------------------------+
| | **Connection Settings** | | ``ansible_connection: network_cli`` | | ``ansible_connection: httpapi`` | Credentials uses SSH keys / SSH-agent if present uses HTTPS certificates if present
| | | | | | |
| | | | | | | accepts ``-u myuser -k`` if using password
| | | | | | |
| | | | | | | Indirect Access via a bastion (jump host) via a web proxy
+---------------------------+-----------------------------------------------+-----------------------------------------+
| | **Enable Mode** | | not supported by EXOS | | not supported by EXOS | Connection Settings ``ansible_connection: network_cli`` ``ansible_connection: httpapi``
| | (Privilege Escalation) | | | | |
| | | | | | | |enable_mode| not supported by EXOS not supported by EXOS
+---------------------------+-----------------------------------------------+-----------------------------------------+
| **Returned Data Format** | ``stdout[0].`` | ``stdout[0].messages[0].`` | Returned Data Format ``stdout[0].`` ``stdout[0].messages[0].``
+---------------------------+-----------------------------------------------+-----------------------------------------+ ==================== ========================================== =========================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
EXOS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli`` or ``ansible_connection: httpapi`` EXOS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli`` or ``ansible_connection: httpapi``

44
docs/docsite/rst/network/user_guide/platform_icx.rst
Unescape Escape View File

@ -11,26 +11,30 @@ ICX supports Enable Mode (Privilege Escalation). This page offers details on how
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes`` with
| **Returned Data Format** | ``stdout[0].`` | ``ansible_become_method: enable`` and ``ansible_become_password:``
+---------------------------+-----------------------------------------------+
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
Using CLI in Ansible Using CLI in Ansible

91
docs/docsite/rst/network/user_guide/platform_index.rst
Unescape Escape View File

@ -35,61 +35,38 @@ Some Ansible Network platforms support multiple connection types, privilege esca
Settings by Platform Settings by Platform
================================ ================================
+-------------------+-------------------------+--------------+---------+---------+---------+ =============================== ======================= =========== ======= ======= ===========
|.. | | ``ansible_connection:`` settings available | .. .. ``ansible_connection:`` settings available
+-------------------+-------------------------+-------------+---------+---------+----------+ ------------------------------- ----------------------- ------------------------------------------
| Network OS | ``ansible_network_os:`` | network_cli | netconf | httpapi | local | Network OS ``ansible_network_os:`` network_cli netconf httpapi local
+===================+=========================+=============+=========+=========+==========+ =============================== ======================= =========== ======= ======= ===========
| Arista EOS* | ``eos`` | ✓ | | ✓ | ✓ | Arista EOS `[†]`_ ``eos`` ✓ ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Cisco ASA ``asa`` ✓ ✓
| Cisco ASA | ``asa`` | ✓ | | | ✓ | Cisco IOS `[†]`_ ``ios`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Cisco IOS XR `[†]`_ ``iosxr`` ✓ ✓
| Cisco IOS* | ``ios`` | ✓ | | | ✓ | Cisco NX-OS `[†]`_ ``nxos`` ✓ ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Dell OS6 ``dellos6`` ✓ ✓
| Cisco IOS XR* | ``iosxr`` | ✓ | | | ✓ | Dell OS9 ``dellos9`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Dell OS10 ``dellos10`` ✓ ✓
| Cisco NX-OS* | ``nxos`` | ✓ | | ✓ | ✓ | Ericsson ECCLI ``eric_eccli`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Extreme EXOS ``exos`` ✓ ✓
| Dell OS6 | ``dellos6`` | ✓ | | | ✓ | Extreme IronWare ``ironware`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Extreme NOS ``nos`` ✓
| Dell OS9 | ``dellos9`` | ✓ | | | ✓ | Extreme SLX-OS ``slxos`` ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Extreme VOSS ``voss`` ✓
| Dell OS10 | ``dellos10`` | ✓ | | | ✓ | F5 BIG-IP ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ F5 BIG-IQ ✓
| Ericsson ECCLI | ``eric_eccli`` | ✓ | | | ✓ | Junos OS `[†]`_ ``junos`` ✓ ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Lenovo CNOS ``cnos`` ✓ ✓
| Extreme EXOS | ``exos`` | ✓ | | ✓ | | Lenovo ENOS ``enos`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ MikroTik RouterOS ``routeros`` ✓
| Extreme IronWare | ``ironware`` | ✓ | | | ✓ | Nokia SR OS ``sros`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ Pluribus Netvisor ``netvisor`` ✓
| Extreme NOS | ``nos`` | ✓ | | | | Ruckus ICX `[†]`_ ``icx`` ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ VyOS `[†]`_ ``vyos`` ✓ ✓
| Extreme SLX-OS | ``slxos`` | ✓ | | | | OS that supports Netconf `[†]`_ ``<network-os>`` ✓ ✓
+-------------------+-------------------------+-------------+---------+---------+----------+ =============================== ======================= =========== ======= ======= ===========
| Extreme VOSS | ``voss`` | ✓ | | | |
+-------------------+-------------------------+-------------+---------+---------+----------+
| F5 BIG-IP | | | | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| F5 BIG-IQ | | | | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| Junos OS* | ``junos`` | ✓ | ✓ | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| Lenovo CNOS | ``cnos`` | ✓ | | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| Lenovo ENOS | ``enos`` | ✓ | | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| MikroTik RouterOS | ``routeros`` | ✓ | | | |
+-------------------+-------------------------+-------------+---------+---------+----------+
| Nokia SR OS | ``sros`` | ✓ | | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| Pluribus Netvisor | ``netvisor`` | ✓ | | | |
+-------------------+-------------------------+-------------+---------+---------+----------+
| Ruckus ICX* | ``icx`` | ✓ | | | |
+-------------------+-------------------------+-------------+---------+---------+----------+
| VyOS* | ``vyos`` | ✓ | | | ✓ |
+-------------------+-------------------------+-------------+---------+---------+----------+
| OS that supports | ``<network-os>`` | | ✓ | | ✓ |
| Netconf* | | | | | |
+-------------------+-------------------------+-------------+---------+---------+----------+
`*` Maintained by Ansible Network Team .. _`[†]`:
**[†]** Maintained by Ansible Network Team

45
docs/docsite/rst/network/user_guide/platform_ios.rst
Unescape Escape View File

@ -11,26 +11,31 @@ IOS supports Enable Mode (Privilege Escalation). This page offers details on how
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes`` with
| **Returned Data Format** | ``stdout[0].`` | ``ansible_become_method: enable`` and ``ansible_become_password:``
+---------------------------+-----------------------------------------------+
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, IOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, IOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

46
docs/docsite/rst/network/user_guide/platform_ironware.rst
Unescape Escape View File

@ -11,26 +11,32 @@ IronWare supports Enable Mode (Privilege Escalation). This page offers details o
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | Connection Settings ``ansible_connection: network_cli``
| | | | and ``ansible_become_password:`` |
+---------------------------+-----------------------------------------------+ |enable_mode| supported: use ``ansible_become: yes``
| **Returned Data Format** | ``stdout[0].`` | with ``ansible_become_method: enable``
+---------------------------+-----------------------------------------------+ and ``ansible_become_password:``
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, IronWare still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible. For legacy playbooks, IronWare still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` as soon as possible.

49
docs/docsite/rst/network/user_guide/platform_junos.rst
Unescape Escape View File

@ -11,26 +11,35 @@ Juniper Junos OS supports multiple connections. This page offers details on how
Connections Available Connections Available
================================================================================ ================================================================================
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+ .. table::
| | | | CLI | | NETCONF | :widths: auto
| | | | * ``junos_netconf`` & ``junos_command`` modules only | | * all modules except ``junos_netconf``, which enables NETCONF | :class: documentation-table
+============================+========================================================+====================================================================================================+
| **Protocol** | SSH | XML over SSH | ==================== ========================================== =========================
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+ .. CLI NETCONF
| | **Credentials** | | uses SSH keys / SSH-agent if present | | uses SSH keys / SSH-agent if present |
| | | | accepts ``-u myuser -k`` if using password | | accepts ``-u myuser -k`` if using password | ``junos_netconf`` & ``junos_command`` all modules except ``junos_netconf``,
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+ modules only which enables NETCONF
| **Indirect Access** | via a bastion (jump host) | via a bastion (jump host) | ==================== ========================================== =========================
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+ Protocol SSH XML over SSH
| **Connection Settings** | ``ansible_connection: network_cli`` | ``ansible_connection: netconf`` |
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+ Credentials uses SSH keys / SSH-agent if present uses SSH keys / SSH-agent if present
| | **Enable Mode** | | not supported by Junos OS | | not supported by Junos OS |
| | (Privilege Escalation) | | | | | accepts ``-u myuser -k`` if using password accepts ``-u myuser -k`` if using password
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+
| | **Returned Data Format** | | ``stdout[0].`` | | json: ``result[0]['software-information'][0]['host-name'][0]['data'] foo lo0`` | Indirect Access via a bastion (jump host) via a bastion (jump host)
| | | | | | text: ``result[1].interface-information[0].physical-interface[0].name[0].data foo lo0`` |
| | | | | | xml: ``result[1].rpc-reply.interface-information[0].physical-interface[0].name[0].data foo lo0`` | Connection Settings ``ansible_connection: network_cli`` ``ansible_connection: netconf``
+----------------------------+--------------------------------------------------------+----------------------------------------------------------------------------------------------------+
|enable_mode| not supported by Junos OS not supported by Junos OS
Returned Data Format ``stdout[0].`` * json: ``result[0]['software-information'][0]['host-name'][0]['data'] foo lo0``
* text: ``result[1].interface-information[0].physical-interface[0].name[0].data foo lo0``
* xml: ``result[1].rpc-reply.interface-information[0].physical-interface[0].name[0].data foo lo0``
==================== ========================================== =========================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
For legacy playbooks, Ansible still supports ``ansible_connection=local`` on all JUNOS modules. We recommend modernizing to use ``ansible_connection=netconf`` or ``ansible_connection=network_cli`` as soon as possible. For legacy playbooks, Ansible still supports ``ansible_connection=local`` on all JUNOS modules. We recommend modernizing to use ``ansible_connection=netconf`` or ``ansible_connection=network_cli`` as soon as possible.

33
docs/docsite/rst/network/user_guide/platform_netconf_enabled.rst
Unescape Escape View File

@ -10,20 +10,27 @@ This page offers details on how the netconf connection works in Ansible and how
Connections Available Connections Available
================================================================================ ================================================================================
.. table::
:widths: auto
:class: documentation-table
==================== ==========================================
.. NETCONF
all modules except ``junos_netconf``,
which enables NETCONF
==================== ==========================================
Protocol XML over SSH
Credentials uses SSH keys / SSH-agent if present
accepts ``-u myuser -k`` if using password
Indirect Access via a bastion (jump host)
Connection Settings ``ansible_connection: netconf``
==================== ==========================================
+----------------------------+----------------------------------------------------------------------------------------------------+
| | | | NETCONF |
| | | | * all modules except ``junos_netconf``, which enables NETCONF |
+============================+====================================================================================================+
| **Protocol** | XML over SSH |
+----------------------------+----------------------------------------------------------------------------------------------------+
| | **Credentials** | | uses SSH keys / SSH-agent if present |
| | | | accepts ``-u myuser -k`` if using password |
+----------------------------+----------------------------------------------------------------------------------------------------+
| **Indirect Access** | via a bastion (jump host) |
+----------------------------+----------------------------------------------------------------------------------------------------+
| **Connection Settings** | ``ansible_connection: netconf`` |
+----------------------------+----------------------------------------------------------------------------------------------------+
For legacy playbooks, Ansible still supports ``ansible_connection=local`` for the netconf_config module only. We recommend modernizing to use ``ansible_connection=netconf`` as soon as possible. For legacy playbooks, Ansible still supports ``ansible_connection=local`` for the netconf_config module only. We recommend modernizing to use ``ansible_connection=netconf`` as soon as possible.

44
docs/docsite/rst/network/user_guide/platform_netvisor.rst
Unescape Escape View File

@ -12,27 +12,29 @@ This page offers details on how to use ``network_cli`` on NETVISOR in Ansible.
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
| | | | | Indirect Access via a bastion (jump host)
| | | | |
+---------------------------+-----------------------------------------------+ Connection Settings ``ansible_connection: network_cli``
| | **Enable Mode** | | not supported by NETVISOR |
| | (Privilege Escalation) | | | |enable_mode| not supported by NETVISOR
+---------------------------+-----------------------------------------------+
| **Returned Data Format** | ``stdout[0].`` | Returned Data Format ``stdout[0].``
+---------------------------+-----------------------------------------------+ ==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
Pluribus NETVISOR does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``. Pluribus NETVISOR does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``.

44
docs/docsite/rst/network/user_guide/platform_nos.rst
Unescape Escape View File

@ -12,27 +12,29 @@ This page offers details on how to use ``network_cli`` on NOS in Ansible.
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
| | | | | Indirect Access via a bastion (jump host)
| | | | |
+---------------------------+-----------------------------------------------+ Connection Settings ``ansible_connection: network_cli``
| | **Enable Mode** | | not supported by NOS |
| | (Privilege Escalation) | | | |enable_mode| not supported by NOS
+---------------------------+-----------------------------------------------+
| **Returned Data Format** | ``stdout[0].`` | Returned Data Format ``stdout[0].``
+---------------------------+-----------------------------------------------+ ==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
NOS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``. NOS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``.

55
docs/docsite/rst/network/user_guide/platform_nxos.rst
Unescape Escape View File

@ -11,29 +11,38 @@ Cisco NXOS supports multiple connections. This page offers details on how each c
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+-----------------------------------------+ .. table::
|.. | CLI | NX-API | :widths: auto
+===========================+===============================================+=========================================+ :class: documentation-table
| **Protocol** | SSH | HTTP(S) |
+---------------------------+-----------------------------------------------+-----------------------------------------+ ==================== ========================================== =========================
| | **Credentials** | | uses SSH keys / SSH-agent if present | | uses HTTPS certificates if present | .. CLI NX-API
| | | | accepts ``-u myuser -k`` if using password | | | ==================== ========================================== =========================
+---------------------------+-----------------------------------------------+-----------------------------------------+ Protocol SSH HTTP(S)
| **Indirect Access** | via a bastion (jump host) | via a web proxy |
+---------------------------+-----------------------------------------------+-----------------------------------------+ Credentials uses SSH keys / SSH-agent if present uses HTTPS certificates if
| | **Connection Settings** | | ``ansible_connection: network_cli`` | | * ``ansible_connection: httpapi`` | present
| | | | | | OR | accepts ``-u myuser -k`` if using password
| | | | | | |
| | | | | | * ``ansible_connection: local`` | Indirect Access via a bastion (jump host) via a web proxy
| | | | | | with ``transport: nxapi`` |
| | | | | | in the ``provider`` dictionary | Connection Settings ``ansible_connection: network_cli`` ``ansible_connection: httpapi``
+---------------------------+-----------------------------------------------+-----------------------------------------+
| | **Enable Mode** | | supported - use ``ansible_become: yes`` | | not supported by NX-API | OR
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | | |
| | supported as of 2.5.3 | | and ``ansible_become_password:`` | | | ``ansible_connection: local``
+---------------------------+-----------------------------------------------+-----------------------------------------+ with ``transport: nxapi``
| **Returned Data Format** | ``stdout[0].`` | ``stdout[0].messages[0].`` | in the ``provider`` dictionary
+---------------------------+-----------------------------------------------+-----------------------------------------+
|enable_mode| supported: use ``ansible_become: yes`` not supported by NX-API
with ``ansible_become_method: enable``
and ``ansible_become_password:``
Returned Data Format ``stdout[0].`` ``stdout[0].messages[0].``
==================== ========================================== =========================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation) |br| supported as of 2.5.3
For legacy playbooks, NXOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` or ``ansible_connection: httpapi`` as soon as possible. For legacy playbooks, NXOS still supports ``ansible_connection: local``. We recommend modernizing to use ``ansible_connection: network_cli`` or ``ansible_connection: httpapi`` as soon as possible.

43
docs/docsite/rst/network/user_guide/platform_routeros.rst
Unescape Escape View File

@ -9,25 +9,30 @@ RouterOS Platform Options
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
+---------------------------+-----------------------------------------------+ Indirect Access via a bastion (jump host)
| | **Enable Mode** | | not supported by RouterOS |
| | (Privilege Escalation) | | | Connection Settings ``ansible_connection: network_cli``
+---------------------------+-----------------------------------------------+
| **Returned Data Format** | ``stdout[0].`` | |enable_mode| not supported by RouterOS
+---------------------------+-----------------------------------------------+
Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
Using CLI in Ansible Using CLI in Ansible
==================== ====================

45
docs/docsite/rst/network/user_guide/platform_slxos.rst
Unescape Escape View File

@ -12,27 +12,30 @@ This page offers details on how to use ``network_cli`` on SLX-OS in Ansible.
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
| | | | | Indirect Access via a bastion (jump host)
| | | | |
+---------------------------+-----------------------------------------------+ Connection Settings ``ansible_connection: network_cli``
| | **Enable Mode** | | not supported by SLX-OS |
| | (Privilege Escalation) | | | |enable_mode| not supported by SLX-OS
+---------------------------+-----------------------------------------------+
| **Returned Data Format** | ``stdout[0].`` | Returned Data Format ``stdout[0].``
+---------------------------+-----------------------------------------------+ ==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
SLX-OS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``. SLX-OS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``.

46
docs/docsite/rst/network/user_guide/platform_voss.rst
Unescape Escape View File

@ -12,27 +12,31 @@ use ``network_cli`` on VOSS in Ansible.
Connections Available Connections Available
================================================================================ ================================================================================
+---------------------------+-----------------------------------------------+ .. table::
|.. | CLI | :widths: auto
+===========================+===============================================+ :class: documentation-table
| **Protocol** | SSH |
+---------------------------+-----------------------------------------------+ ==================== ==========================================
| | **Credentials** | | uses SSH keys / SSH-agent if present | .. CLI
| | | | accepts ``-u myuser -k`` if using password | ==================== ==========================================
+---------------------------+-----------------------------------------------+ Protocol SSH
| **Indirect Access** | via a bastion (jump host) |
+---------------------------+-----------------------------------------------+ Credentials uses SSH keys / SSH-agent if present
| | **Connection Settings** | | ``ansible_connection: network_cli`` |
| | | | | accepts ``-u myuser -k`` if using password
| | | | |
| | | | | Indirect Access via a bastion (jump host)
| | | | |
+---------------------------+-----------------------------------------------+ Connection Settings ``ansible_connection: network_cli``
| | **Enable Mode** | | supported - use ``ansible_become: yes`` |
| | (Privilege Escalation) | | with ``ansible_become_method: enable`` | |enable_mode| supported: use ``ansible_become: yes``
+---------------------------+-----------------------------------------------+ with ``ansible_become_method: enable``
| **Returned Data Format** | ``stdout[0].`` |
+---------------------------+-----------------------------------------------+ Returned Data Format ``stdout[0].``
==================== ==========================================
.. |enable_mode| replace:: Enable Mode |br| (Privilege Escalation)
VOSS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``. VOSS does not support ``ansible_connection: local``. You must use ``ansible_connection: network_cli``.

Write Preview
Loading…
Cancel
Save