New module: Add module to add/remove a network static route on windows (windows/win_route) (#23405)

* adds win_route windows module

* fix documentation indent

* fix documentation pep8 issues

* fix documentation issues

* genaral code review

* changed 'supported_by' in doc, supports_check_mode removed

* use of powershell cmdlet instead of route command, destnation in CIDR format, adds check mode support

* adds win_psmodule module

* documentation review

* documentation review

* removed files accidentatlly pushed

* add integration tests, add return in documentation

* add conditional statement in test, add os requirementes in documentation

* fix documentation

* fix os check in tests
This commit is contained in:
Daniele Lazzari 2017-06-07 19:25:50 +02:00 committed by Matt Davis
commit eda6a6baee
7 changed files with 316 additions and 0 deletions

View file

@ -0,0 +1 @@
windows/ci/group1

View file

@ -0,0 +1,3 @@
---
default_gateway: 192.168.1.1
destination_ip_address: 192.168.2.10

View file

@ -0,0 +1,13 @@
$os = [Environment]::OSVersion
$major = $os.Version.Major
$minor = $os.Version.Minor
$ok = $false
if(($major -gt 6)){
$ok = $true
}
elseif (($major -eq 6) -and ($minor -ge 3)){
$ok = $true
}
$ok

View file

@ -0,0 +1,29 @@
---
# test code for the win_psmodule module when using winrm connection
# (c) 2017, Daniele Lazzari <lazzari@mailup.com>
# This file is part of Ansible
#
# Ansible is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Ansible is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
- name: get os info
script: ../files/Test-Os.ps1
register: os
- name: Perform with os Windows 2012R2 or newer
when: os.stdout_lines[0] == "True"
block:
- name: run all tasks
include: tests.yml

View file

@ -0,0 +1,74 @@
---
- name: add a static route
win_route:
destination: "{{ destination_ip_address }}/32"
gateway: "{{ default_gateway }}"
metric: 1
state: present
register: route
- name: check if route successfully addedd
win_shell: (Get-CimInstance win32_ip4PersistedrouteTable -Filter "Destination = '{{ destination_ip_address }}'").Caption
register: route_added
- name: test if route successfully addedd
assert:
that:
- route|changed
- route_added.stdout_lines[0] == "{{ destination_ip_address }}"
- name: add a static route to test idempotency
win_route:
destination: "{{ destination_ip_address }}/32"
gateway: "{{ default_gateway }}"
metric: 1
state: present
register: idempotent_route
- name: test idempotency
assert:
that:
- not idempotent_route|changed
- idempotent_route.output == "Static route already exists"
- name: remove route
win_route:
destination: "{{ destination_ip_address }}/32"
state: absent
register: route_removed
- name: check route is removed
win_shell: Get-CimInstance win32_ip4PersistedrouteTable -Filter "Destination = '{{ destination_ip_address }}'"
register: check_route_removed
- name: test route is removed
assert:
that:
- route_removed|changed
- check_route_removed.stdout == ''
- name: remove static route to test idempotency
win_route:
destination: "{{ destination_ip_address }}/32"
state: absent
register: idempotent_route_removed
- name: test idempotency
assert:
that:
- not idempotent_route_removed|changed
- idempotent_route_removed.output == "No route to remove"
- name: add route to wrong ip address
win_route:
destination: "715.18.0.0/32"
gateway: "{{ default_gateway }}"
metric: 1
state: present
ignore_errors: yes
register: wrong_ip
- name: test route to wrong ip address
assert:
that:
- wrong_ip|failed