Updating examples to include required fields (#3242)

Updated examples to include required fields (host, username).  Also updated src option to be listed as required.
This commit is contained in:
Justin Kennedy 2016-04-19 14:46:34 -07:00 committed by Brian Coca
parent 53c4827da5
commit 7a2b00b625

View file

@ -22,7 +22,7 @@ version_added: "2.1"
author: "Peter sprygada (@privateip)" author: "Peter sprygada (@privateip)"
short_description: Manage Cisco IOS device configurations over SSH short_description: Manage Cisco IOS device configurations over SSH
description: description:
- Manages network device configurations over SSH. This module - Manages Cisco IOS network device configurations over SSH. This module
allows implementors to work with the device running-config. It allows implementors to work with the device running-config. It
provides a way to push a set of commands onto a network device provides a way to push a set of commands onto a network device
by evaluting the current running-config and only pushing configuration by evaluting the current running-config and only pushing configuration
@ -37,7 +37,7 @@ options:
runtime. By default the task will first search for the source runtime. By default the task will first search for the source
file in role or playbook root folder in templates unless a full file in role or playbook root folder in templates unless a full
path to the file is given. path to the file is given.
required: false required: true
default: null default: null
force: force:
description: description:
@ -84,15 +84,21 @@ options:
EXAMPLES = """ EXAMPLES = """
- name: push a configuration onto the device - name: push a configuration onto the device
ios_template: ios_template:
host: hostname
username: foo
src: config.j2 src: config.j2
- name: forceable push a configuration onto the device - name: forceable push a configuration onto the device
ios_template: ios_template:
host: hostname
username: foo
src: config.j2 src: config.j2
force: yes force: yes
- name: provide the base configuration for comparision - name: provide the base configuration for comparision
ios_template: ios_template:
host: hostname
username: foo
src: candidate_config.txt src: candidate_config.txt
config: current_config.txt config: current_config.txt
""" """