Ucs vnic template and integration tests (#35136)

* UCS vNIC templates and integration tests

* docs updated

* UCS vNIC template and integration test

* Update docs and argument_spec for description, mtu, and target.

test/integration/targets/ucs_vnic_template/aliases

@@ -0,0 +1,6 @@
+# Not enabled, but can be used with the UCS Platform Emulator or UCS hardware.
+# Example integration_config.yml:
+# ---
+# ucs_hostname: 172.16.143.136
+# ucs_username: admin
+# ucs_password: password

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

@@ -0,0 +1,131 @@
+# Test code for the UCS modules
+# Copyright 2017, David Soper (@dsoper2)
+
+- name: Test that we have a UCS host, UCS username, and UCS password
+  fail:
+    msg: 'Please define the following variables: ucs_hostname, ucs_username and ucs_password.'
+  when: ucs_hostname is not defined or ucs_username is not defined or ucs_password is not defined
+  vars:
+    login_info: &login_info
+      hostname: "{{ ucs_hostname }}"
+      username: "{{ ucs_username }}"
+      password: "{{ ucs_password }}"
+
+
+# Setup (clean environment)
+- name: vNIC template absent
+  ucs_vnic_template: &vnic_templates_absent
+    <<: *login_info
+    name: vNIC-A-B
+    state: absent
+
+
+# Test present (check_mode)
+- name: vNIC template present (check_mode)
+  ucs_vnic_template: &vnic_templates_present
+    <<: *login_info
+    name: vNIC-A-B
+    fabric: A-B
+    vlans_list:
+    - name: default
+      native: 'yes'
+    - name: finance
+  check_mode: yes
+  register: cm_vnic_templates_present
+
+
+# Present (normal mode)
+- name: vNIC template present (normal mode)
+  ucs_vnic_template: *vnic_templates_present
+  register: nm_vnic_templates_present
+
+
+# Test present again (idempotent)
+- name: vNIC template present again (check_mode)
+  ucs_vnic_template: *vnic_templates_present
+  check_mode: yes
+  register: cm_vnic_templates_present_again
+
+
+# Present again (normal mode)
+- name: vNIC template present again (normal mode)
+  ucs_vnic_template: *vnic_templates_present
+  register: nm_vnic_templates_present_again
+
+
+# Verfiy present
+- name: Verify vNIC template present results
+  assert:
+    that:
+    - cm_vnic_templates_present.changed == nm_vnic_templates_present.changed == true
+    - cm_vnic_templates_present_again.changed == nm_vnic_templates_present_again.changed == false
+
+
+# Test change (check_mode)
+- name: vNIC template description change (check_mode)
+  ucs_vnic_template: &vnic_templates_change
+    <<: *vnic_templates_present
+    descr: Testing Ansible
+  check_mode: yes
+  register: cm_vnic_templates_descr_change
+
+
+# Change (normal mode)
+- name: vNIC template description change (normal mode)
+  ucs_vnic_template: *vnic_templates_change
+  register: nm_vnic_templates_descr_change
+
+
+# Test change again (idempotent)
+- name: vNIC template description again (check_mode)
+  ucs_vnic_template: *vnic_templates_change
+  check_mode: yes
+  register: cm_vnic_templates_descr_change_again
+
+
+# Change again (normal mode)
+- name: vNIC template description change again (normal mode)
+  ucs_vnic_template: *vnic_templates_change
+  register: nm_vnic_templates_descr_change_again
+
+
+# Verfiy change
+- name: Verify vNIC template change results
+  assert:
+    that:
+    - cm_vnic_templates_descr_change.changed == nm_vnic_templates_descr_change.changed == true
+    - cm_vnic_templates_descr_change_again.changed == nm_vnic_templates_descr_change_again.changed == false
+
+
+# Teardown (clean environment)
+- name: vNIC template absent (check_mode)
+  ucs_vnic_template: *vnic_templates_absent
+  check_mode: yes
+  register: cm_vnic_templates_absent
+
+
+# Absent (normal mode)
+- name: vNIC template absent (normal mode)
+  ucs_vnic_template: *vnic_templates_absent
+  register: nm_vnic_templates_absent
+
+
+# Test absent again (idempotent)
+- name: vNIC template absent again (check_mode)
+  ucs_vnic_template: *vnic_templates_absent
+  check_mode: yes
+  register: cm_vnic_templates_absent_again
+
+
+# Absent again (normal mode)
+- name: vNIC template absent again (normal mode)
+  ucs_vnic_template: *vnic_templates_absent
+  register: nm_vnic_templates_absent_again
+
+
+# Verfiy absent
+- name: Verify vNIC template absent results
+  assert:
+    that:
+    - cm_vnic_templates_absent.changed == nm_vnic_templates_absent.changed == true
+    - cm_vnic_templates_absent_again.changed == nm_vnic_templates_absent_again.changed == false