Metadata-Version: 1.1
Name: networking-ansible
Version: 5.0.0
Summary: Ansible Networking ML2 Driver
Home-page: https://opendev.org/openstack/networking-ansible
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
License: UNKNOWN
Description: =============================
        Networking-Ansible ML2 Driver
        =============================
        
        Overview
        --------
        Networking-Ansible is a python library that abstracts management and
        interaction with switching hardware to Ansible Networking. This library is not
        tested with all the modules included with Ansible Networking. In theory it
        should work with any switch that has compatible modules included with Ansible
        Networking if the provider tasks are added to this library's Ansible role.
        See the contributor documentation for more information
        about adding support for an Ansible Networking driver to the openstack-ml2
        Ansible role.
        
        * Free software: Apache license
        * Documentation: https://networking-ansible.readthedocs.io/en/latest/
        * Source: https://opendev.org/openstack/networking-ansible/
        * Bugs: https://storyboard.openstack.org/#!/project/openstack/networking-ansible/
        
        Components
        ----------
        The Networking-Ansible library consists of the following components:
        
        ``ML2 Mechanism Driver``
          Invoked by neutron to configure L2 networking for OpenStack tenant networks.
        
        ``Python API``
          Imported directly by python.
        
        Use Cases
        ---------
        ``OpenStack Ironic Baremetal Guest Deployment``
        
        Ironic uses Networking-Ansible to configure the switch ports for the baremetal guests.
        Ironic needs to swap the port a baremetal guest is connected to between the
        Ironic provisioning network and the tenant VLAN that the guest is assigned.
        
        ``Python API``
        
        Any python application could need the ability to communicate with a switch
        to perform a task that networking-ansible is able to complete. The interaction
        with ansible is designed in a library style that will allow direct import and
        invocation in python independant of a running OpenStack deployment.
        
        API Features
        ------------
        The following matrix indicates which features have been implmented.
        
        +--------------------+-------------+-------+------+-----+---------+----------+
        |                    | openvswitch | junos | nxos | eos | cumulus | dellos10 |
        +====================+=============+=======+======+=====+=========+==========+
        | Create VLAN        |     N/A     |   Y   |  Y   |  Y  |    Y    |    Y     |
        +--------------------+-------------+-------+------+-----+---------+----------+
        | Delete VLAN        |     N/A     |   Y   |  Y   |  Y  |    Y    |    Y     |
        +--------------------+-------------+-------+------+-----+---------+----------+
        | Delete Port        |      Y      |   Y   |  Y   |  Y  |    Y    |    Y     |
        +--------------------+-------------+-------+------+-----+---------+----------+
        | Config Access Port |      Y      |   Y   |  Y   |  Y  |    Y    |    Y     |
        +--------------------+-------------+-------+------+-----+---------+----------+
        | Config Trunk Port  |      N      |   Y   |  N   |  N  |    N    |    N     |
        +--------------------+-------------+-------+------+-----+---------+----------+
        
        ML2 Implimentation Mapping
        --------------------------
        
        - ``create_network_postcommit``: Creates a VLAN
        - ``delete_network_postcommit``: Deletes a VLAN
        - ``update_port_postcommit``: Deletes the old port if bound
        - ``delete_port_postcommit``: Deletes a port
        - ``bind_port``: Configures an access port
        
        
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.8
