File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/openvswitch.cpython-310.pyc
Back
o ;jD � @ s d Z ddlZddlZddlmZmZ ddlmZ e� e �Z dd� Z dd� Z d d � Zd d � Zd9dd�Zdd� Zdd� Zdd� Zdd� Zd:dd�Zd;d d �Zd d � Zd d!� Zd<d#d$�Zd;d%d&�Zd'd(� Zd)d*� Z d+d,� Z d-d.� Z d=d/d0�Z d1d2� Z d>d3d4�Z!d=d5d6�Z"d=d7d8�Z#dS )?z� Support for Open vSwitch - module with basic Open vSwitch commands. Suitable for setting up Openstack Neutron. :codeauthor: Jiri Kotlin <jiri.kotlin@ultimum.io> � N)�ArgumentValueError�CommandExecutionError)�jsonc C s t jj�d�r dS dS )z; Only load the module if Open vSwitch is installed � ovs-vsctlZ openvswitch)Fz Missing dependency: ovs-vsctl)�salt�utils�path�which� r r �L/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/openvswitch.py� __virtual__ s r c C � | rdS dS )z� Returns --may-exist parameter for Open vSwitch command. Args: may_exist: Boolean whether to use this parameter. Returns: String '--may-exist ' or empty string. z --may-exist � r )� may_existr r r �_param_may_exist � r c C r )z� Returns --if-exist parameter for Open vSwitch command. Args: if_exists: Boolean whether to use this parameter. Returns: String '--if-exist ' or empty string. z --if-exists r r )� if_existsr r r �_param_if_exists+ r r c C s | dkrdS dS )z� Evaulates Open vSwitch command`s retcode value. Args: retcode: Value of retcode field from response, should be 0, 1 or 2. Returns: True on 0, else False r TFr )�retcoder r r �_retcode_to_bool; s r r � c C s | dkr |� |�}|S dS )a1 Evaulates Open vSwitch command`s retcode value. Args: retcode: Value of retcode field from response, should be 0, 1 or 2. stdout: Value of stdout filed from response. splitstring: String used to split the stdout default new line. Returns: List or False. r F)�split)r �stdoutZ splitstring�retr r r �_stdout_list_splitK s r c C s� t | t�rdd� | �� D �S t | t�rWt| �dkrW| d }| d }|dkr1t |t�r1dd� |D �S |d krUt |t�rU|D ]}t |t�rIt|�dkrM| S q<d d� |D �S | S t | t�rcd d� | D �S | S ) a, Converts from the JSON output provided by ovs-vsctl into a usable Python object tree. In particular, sets and maps are converted from lists to actual sets or maps. Args: obj: Object that shall be recursively converted. Returns: Converted version of object. c S s i | ] \}}t |�t |��qS r �� _convert_json)�.0�key�valr r r � <dictcomp>k � z!_convert_json.<locals>.<dictcomp>� r � �setc S � g | ]}t |��qS r r �r �elemr r r � <listcomp>p � z!_convert_json.<locals>.<listcomp>�mapc S s i | ] }|d t |d ��qS )r r# r r& r r r r u r! c S r% r r r& r r r r( y r) )� isinstance�dict�items�list�len)�obj�first�secondr' r r r r ^ s" � r c C s t �| �}t|�S )z� Parses JSON output from ovs-vsctl and returns the corresponding object tree. Args: stdout: Output that shall be parsed. Returns: Object represented by the output. )r �loadsr )r r0 r r r �_stdout_parse_json~ s r4 c C s* d} t d | �}|d }|d }t||�S )z� Lists all existing real and fake bridges. Returns: List of bridges (or empty list), False on failure. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.bridge_list zovs-vsctl list-br� cmd.run_allr r ��__salt__r )�cmd�resultr r r r r � bridge_list� s r: c C s& d| � �}t d |�}|d }t|�S )z� Tests whether bridge exists as a real or fake bridge. Returns: True if Bridge exists, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.bridge_exists br0 zovs-vsctl br-exists r5 r )r7 r )�brr8 r9 r r r r � bridge_exists� s r< Tc C s� t |�}|dur|du rtd��|dur |du r td��|du r"dnd|� �}|du r-dnd|� �}d�| |||�}td |�}t|d �S ) a� Creates a new bridge. Args: br : string bridge name may_exist : bool if False - attempting to create a bridge that exists returns False. parent : string name of the parent bridge (if the bridge shall be created as a fake bridge). If specified, vlan must also be specified. .. versionadded:: 3006.0 vlan : int VLAN ID of the bridge (if the bridge shall be created as a fake bridge). If specified, parent must also be specified. .. versionadded:: 3006.0 Returns: True on success, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.bridge_create br0 Nz4If parent is specified, vlan must also be specified.z4If vlan is specified, parent must also be specified.r � z ovs-vsctl {1}add-br {0}{2}{3}r5 r )r r �formatr7 r ) r; r �parentZvlan�param_may_existZ param_parentZ param_vlanr8 r9 r r r � bridge_create� s � rA c C s4 t |�}d|� d| � �}td |�}|d }t|�S )ar Deletes bridge and all of its ports. Args: br: A string - bridge name if_exists: Bool, if False - attempting to delete a bridge that does not exist returns False. Returns: True on success, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.bridge_delete br0 � ovs-vsctl zdel-br r5 r �r r7 r )r; r �param_if_existsr8 r9 r r r r � bridge_delete� s rE c C s2 d| � �}t d |�}|d dkrdS |d �� S )a� .. versionadded:: 3006.0 Returns the parent bridge of a bridge. Args: br : string bridge name Returns: Name of the parent bridge. This is the same as the bridge name if the bridge is not a fake bridge. If the bridge does not exist, False is returned. CLI Example: .. code-block:: bash salt '*' openvswitch.bridge_to_parent br0 zovs-vsctl br-to-parent r5 r r Fr )r7 �strip�r; r8 r9 r r r �bridge_to_parent� s rH c C s2 d| � �}t d |�}|d dkrdS t|d �S )az .. versionadded:: 3006.0 Returns the VLAN ID of a bridge. Args: br : string bridge name Returns: VLAN ID of the bridge. The VLAN ID is 0 if the bridge is not a fake bridge. If the bridge does not exist, False is returned. CLI Example: .. code-block:: bash salt '*' openvswitch.bridge_to_parent br0 zovs-vsctl br-to-vlan r5 r r Fr )r7 �intrG r r r �bridge_to_vlan s rJ Fc C sN t |�}d|� d| � d|� �}|r|d|� d�7 }td |�}|d }t|�S )a� Creates on bridge a new port named port. Returns: True on success, else False. Args: br: A string - bridge name port: A string - port name may_exist: Bool, if False - attempting to create a port that exists returns False. internal: A boolean to create an internal interface if one does not exist. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_add br0 8080 rB z add-port r= � -- set interface � type=internalr5 r )r r7 r )r; �portr �internalr@ r8 r9 r r r r �port_add4 s rO c C sT t |�}|r| sd|� d|� �}n d|� d| � d|� �}td |�}|d }t|�S )a� Deletes port. Args: br: A string - bridge name (If bridge is None, port is removed from whatever bridge contains it) port: A string - port name. if_exists: Bool, if False - attempting to delete a por that does not exist returns False. (Default True) Returns: True on success, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_remove br0 8080 rB z del-port r= r5 r rC )r; rM r rD r8 r9 r r r r � port_removeR s rP c C s0 d| � �}t d |�}|d }|d }t||�S )a Lists all of the ports within bridge. Args: br: A string - bridge name. Returns: List of bridges (or empty list), False on failure. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_list br0 zovs-vsctl list-ports r5 r r r6 )r; r8 r9 r r r r r � port_listq s rQ c C �2 d| � d�}t d |�}|d }|d }t||�S )a Lists tags of the port. Args: port: A string - port name. Returns: List of tags (or empty list), False on failure. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_get_tag tap0 zovs-vsctl get port z tagr5 r r r6 �rM r8 r9 r r r r r � port_get_tag� � rT c C rR )aH Port's interface's optional parameters. Args: port: A string - port name. Returns: String containing optional parameters of port's interface, False on failure. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.interface_get_options tap0 �ovs-vsctl get interface z optionsr5 r r r6 rS r r r �interface_get_options� rU rW c C rR )a( Type of port's interface. Args: port: A string - port name. Returns: String - type of interface or empty string, False on failure. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.interface_get_type tap0 rV z typer5 r r r6 rS r r r �interface_get_type� rU rX c C s� t d � }d| krdksdS dS t| �sdS |s!||vr!dS |t| �v rEd|� d|� �}|r9|d|� d�7 }t d |�}t|d �S d | � d |� d|� �}|rZ|d|� d�7 }t d |�}t|d �S ) a� Isolate VM traffic using VLANs. Args: br: A string - bridge name. port: A string - port name. id: An integer in the valid range 0 to 4095 (inclusive), name of VLAN. internal: A boolean to create an internal interface if one does not exist. Returns: True on success, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_create_vlan br0 tap0 100 znetwork.interfacesr i� Fzovs-vsctl set port z tag=rK rL r5 r zovs-vsctl add-port r= )r7 r< rQ r )r; rM �idrN Z interfacesr8 r9 r r r �port_create_vlan� s( � rZ c C s� d| kr dk sdS dS t d |�sdS t| �s dS |t| �v r5d�|||�}t d |�}t|d �S d�| |||�}t d |�}t|d �S ) a� Generic Routing Encapsulation - creates GRE tunnel between endpoints. Args: br: A string - bridge name. port: A string - port name. id: An integer - unsigned 32-bit number, tunnel's key. remote: A string - remote endpoint's IP address. Returns: True on success, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_create_gre br0 gre1 5001 192.168.1.10 r l F� dig.check_ipzGovs-vsctl set interface {} type=gre options:remote_ip={} options:key={}r5 r z^ovs-vsctl add-port {0} {1} -- set interface {1} type=gre options:remote_ip={2} options:key={3})r7 r< rQ r> r )r; rM rY �remoter8 r9 r r r �port_create_gre� s& � � � r] c C s� d| k r dkrn ndt |� nd}d| kr dk s"dS dS td |�s*dS t| �s0dS |t| �v rJd�||||�}td |�}t|d �S d �| ||||�}td |�}t|d �S ) aD Virtual eXtensible Local Area Network - creates VXLAN tunnel between endpoints. Args: br: A string - bridge name. port: A string - port name. id: An integer - unsigned 64-bit number, tunnel's key. remote: A string - remote endpoint's IP address. dst_port: An integer - port to use when creating tunnelport in the switch. Returns: True on success, else False. .. versionadded:: 2016.3.0 CLI Example: .. code-block:: bash salt '*' openvswitch.port_create_vxlan br0 vx1 5001 192.168.1.10 8472 r i�� z options:dst_port=r l Fr[ zKovs-vsctl set interface {} type=vxlan options:remote_ip={} options:key={}{}r5 r zcovs-vsctl add-port {0} {1} -- set interface {1} type=vxlan options:remote_ip={2} options:key={3}{4})�strr7 r< rQ r> r )r; rM rY r\ Zdst_portr8 r9 r r r �port_create_vxlan) s, (� � �� r_ c C s� ddd|� �g}|r|dg7 }|d| |g7 }t d |�}|d dkr(t|d ��t|d �}|d r@|d d r@|d d d S d S ) a .. versionadded:: 3006.0 Gets a column's value for a specific record. Args: table : string name of the database table record : string identifier of the record column : string name of the column if_exists : boolean if True, it is not an error if the record does not exist. Returns: The column's value. CLI Example: .. code-block:: bash salt '*' openvswitch.db_get Port br0 vlan_mode r z --format=jsonz --columns=� --if-existsr. r5 r r �stderrr �dataN)r7 r r4 )�table�record�columnr r8 r9 �outputr r r �db_getX s rg c C sX dg}|r |dg7 }|d| ||� dt �|�� �g7 }td |�}|d dkr*|d S d S ) ae .. versionadded:: 3006.0 Sets a column's value for a specific record. Args: table : string name of the database table record : string identifier of the record column : string name of the column value : string the value to be set if_exists : boolean if True, it is not an error if the record does not exist. Returns: None on success and an error message on failure. CLI Example: .. code-block:: bash salt '*' openvswitch.db_set Interface br0 mac 02:03:04:05:06:07 r r` r$ �=r5 r r ra N)r �dumpsr7 )rc rd re �valuer r8 r9 r r r �db_set s rk )r r )TNN)T)FF)F)N)$�__doc__�loggingZsalt.utils.pathr Zsalt.exceptionsr r Z salt.utilsr � getLogger�__name__�logr r r r r r r4 r: r< rA rE rH rJ rO rP rQ rT rW rX rZ r] r_ rg rk r r r r �<module> s< + * * /'
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings