VMware: Module for managing mirroring sessions. (#50338)

This module manages the mirroring sessions, and the necessary port settings.

* Correct Documentation and CS
* PEP8, YAML, Documentation Error Fix
* Added empty return statement

Co-Authored-By: gyorgypeter <32464524+gyorgypeter@users.noreply.github.com>

test/integration/targets/vmware_vspan_session/aliases

@@ -0,0 +1,2 @@
+cloud/vcenter
+unsupported

test/integration/targets/vmware_vspan_session/tasks/main.yml

@@ -0,0 +1,151 @@
+# Test code for the vmware_vspan_session module.
+# Copyright: (c) 2018, Peter Gyorgy <gyorgy.peter@edu.bme.hu>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+- name: store the vcenter container ip
+  set_fact:
+    vcsim: "{{ lookup('env', 'vcenter_host') }}"
+
+- debug: var=vcsim
+
+- name: Wait for Flask controller to come up online
+  wait_for:
+    host: "{{ vcsim }}"
+    port: 5000
+    state: started
+
+- name: kill vcsim
+  uri:
+    url: http://{{ vcsim }}:5000/killall
+
+- name: start vcsim
+  uri:
+    url: http://{{ vcsim }}:5000/spawn?cluster=2
+  register: vcsim_instance
+
+- name: Wait for vcsim server to come up online
+  wait_for:
+    host: "{{ vcsim }}"
+    port: 443
+    state: started
+
+- name: get a list of Datacenter from vcsim
+  uri:
+    url: http://{{ vcsim }}:5000/govc_find?filter=DC
+  register: datacenters
+
+- debug: var=vcsim_instance
+- debug: var=datacenters
+
+- name: add distributed vSwitch
+  vmware_dvswitch:
+    validate_certs: False
+    hostname: "{{ vcsim }}"
+    username: "{{ vcsim_instance['json']['username'] }}"
+    password: "{{ vcsim_instance['json']['password'] }}"
+    datacenter_name: "{{ item | basename }}"
+    state: present
+    switch_name: dvswitch_0001
+    mtu: 9000
+    uplink_quantity: 2
+    discovery_proto: lldp
+    discovery_operation: both
+  register: dvs_result_0001
+  with_items:
+    - "{{ datacenters['json'] }}"
+
+- name: ensure distributed vswitch is present
+  assert:
+    that:
+        - "{{ dvs_result_0001.changed == true }}"
+
+- name: get a list of distributed vswitch from vcsim after adding
+  uri:
+    url: http://{{ vcsim }}:5000/govc_find?filter=DVS
+  register: new_dvs_0001
+
+- debug:
+    msg: "{{ item | basename }}"
+  with_items: "{{ new_dvs_0001['json'] }}"
+
+- set_fact: new_dvs_name="{% for dvs in new_dvs_0001['json'] %} {{ True if (dvs | basename) == 'dvswitch_0001' else False }}{% endfor %}"
+
+- debug: var=new_dvs_name
+- assert:
+    that:
+      - "{{ 'True' in new_dvs_name }}"
+
+- name: Create vlan portgroup with all security and port policies
+  vmware_dvs_portgroup:
+    hostname: "{{ vcsim }}"
+    username: "{{ vcsim_instance['json']['username'] }}"
+    password: "{{ vcsim_instance['json']['password'] }}"
+    validate_certs: False
+    portgroup_name: vlan-123-portrgoup
+    switch_name: dvswitch_0001
+    vlan_id: 123
+    num_ports: 120
+    portgroup_type: earlyBinding
+    state: present
+    network_policy:
+      promiscuous: yes
+      forged_transmits: yes
+      mac_changes: yes
+    port_policy:
+      block_override: yes
+      ipfix_override: yes
+      live_port_move: yes
+      network_rp_override: yes
+      port_config_reset_at_disconnect: yes
+      security_override: yes
+      shaping_override: yes
+      traffic_filter_override: yes
+      uplink_teaming_override: yes
+      vendor_config_override: yes
+      vlan_override: yes
+  delegate_to: localhost
+  register: portgroup_create_result
+
+- name: ensure portgroup was created
+  assert:
+    that:
+        - portgroup_create_result.changed
+
+- name: create a session.
+  vmware_vspan_session:
+    hostname: "{{ vcsim }}"
+    username: "{{ vcsim_instance['json']['username'] }}"
+    password: "{{ vcsim_instance['json']['password'] }}"
+    validate_certs: False
+    switch: dvswitch_0001
+    name: "session_0001"
+    state: "present"
+    enabled: True
+    description: "basic_description"
+    source_port_transmitted: 13
+    source_port_received: 13
+    destination_port: 12
+  delegate_to: localhost
+  register: vspan_session_create_result
+
+- name: ensure session was created
+  assert:
+    that:
+        - vspan_session_create_result.changed
+
+- name: delete a session.
+  vmware_vspan_session:
+    hostname: "{{ vcsim }}"
+    username: "{{ vcsim_instance['json']['username'] }}"
+    password: "{{ vcsim_instance['json']['password'] }}"
+    validate_certs: False
+    switch: dvswitch_0001
+    name: "session_0001"
+    state: "absent"
+  delegate_to: localhost
+  register: vspan_session_delete_result
+
+- name: ensure session was deleted
+  assert:
+    that:
+        - vspan_session_delete_result.changed