Commit Graph

643 Commits (06795374959d3325031b0abe3a14a09be6a0f33c)

Author SHA1 Message Date
Dag Wieers 70b063ce0e Use the standard 'dest' option for target files, make 'name' an alias 12 years ago
Michael DeHaan f470ebe6b7 Merge pull request #1213 from dagwieers/debug-module
Module debug to assist users in understanding Ansible
12 years ago
Michael DeHaan a95bff0f5f Merge pull request #1230 from dagwieers/module-vsphere_facts
Module vsphere_facts to add facts from a VMWare vSphere guest
12 years ago
Michael DeHaan 5d7ab8a300 Merge pull request #1231 from dagwieers/fail-doc-fix
This hopefully fixes the documentation for the fail module
12 years ago
Dag Wieers 8c8552ac32 Module vsphere_facts to add facts from a VMWare vSphere guest
This module gathers facts from a VMWare vSphere guest by querying vSphere. The facts include OS, network info (vlan, macaddress) and system info (cpu, memory, uuid) information. Useful information for provisioning and management.
12 years ago
Dag Wieers e07674d756 Module hpilo_facts to add facts from HP iLO interfaces
This module gathers facts from the hardware interface by querying HP iLO. The facts include network info (vlan, macaddress) and system info (cpu, memory, uuid) information. Useful information for provisioning and management.

This module was previously named ilo_facts and mentioned in #1080, #1085, #1125 and #1217.
12 years ago
Dag Wieers 3d5c4df2ac This hopefully fixes the documentation for the fail module 12 years ago
Dag Wieers 03af450bdc Module to assist users in understanding Ansible
After helping someone on IRC he was interested to have this debug module in upstream. This module simply 'prints' a message, and can be ordered to fail if needed. It helps to troubleshoot or understand inventory/facts issues and/or experiment with statements and conditions using only_if.

Here is a small example playbook:

```yaml
- hosts: all
  tasks:
  - local_action: debug msg="System $inventory_hostname has uuid ${ansible_product_uuid}"
  - local_action: debug msg="System $inventory_hostname lacks a gateway" fail=yes
    only_if: "is_unset('$ansible_default_ipv4.gateway')"
  - local_action: debug msg="System $inventory_hostname has gateway ${ansible_default_ipv4.gateway}"
    only_if: "is_set('$ansible_default_ipv4.gateway')"
```

outputting:
```
[root@moria ansible]# ansible-playbook -v -l localhost:x220 test6.yml

PLAY [all] *********************

GATHERING FACTS *********************
ok: [localhost]
ok: [x220]

TASK: [debug msg="System $inventory_hostname has uuid $ansible_product_uuid"] *********************
ok: [localhost] => {"msg": "System localhost has uuid d125a48c-364f-4e65-b225-fed42ed61fac"}
ok: [x220] => {"msg": "System x220 has uuid d125a48c-364f-4e65-b225-fed42ed61fac"}

TASK: [debug msg="System $inventory_hostname lacks a gateway" fail=yes] *********************
failed: [localhost] => {"failed": true, "msg": "System localhost lacks a gateway", "rc": 1}
ok: [x220] => {"msg": "System x220 has gateway 192.168.1.1"}

PLAY RECAP *********************
localhost                      : ok=2    changed=0    unreachable=0    failed=1
x220                           : ok=3    changed=0    unreachable=0    failed=0

```

I had some other plans for the module, like displaying host inventory and complete inventory to help understand inventory and facts modules, but that would require an action-plugin for transfering inventory information etc... And I am not sure this is wanted/best done in a module.
12 years ago
Michael DeHaan e170d7304b Added documentation on file force parameter 12 years ago
Michael DeHaan 046c6c66f2 various small doc tweaks 12 years ago
Michael DeHaan f67aa85c3f Fixing various module related things. 12 years ago
Michael DeHaan 85a31616de Call os.path.expanduser in the creates= and removes= section of the command module so ~/ and the like works. 12 years ago
Dag Wieers 1d27909ec0 Added a fail module in order to fail execution on certain conditions
In some cases you may want to deliberately fail the execution of a playbook. In our provisioning workflow we want to have safeguards in place to avoid provisioning systems that are already in production. Since we reboot physical and virtual systems, it is mandatory we take all the precautions to prevent accidental provisioning.

So in our use-case we have the following at the very start of the provisioning playbook:

    ### Safeguard to protect production systems
    - local_action: fail msg="System is not ready to be staged according to CMDB"
      only_if: "'$cmdb_status' != 'to-be-staged'"

and we repeat the same task in the (separate included) play that takes care of (re)booting the system using our own boot-media, so that it cannot be accidentally separately run by someone.
12 years ago
Petetin Ludovic 17423c9268 Fix issue https://github.com/ansible/ansible/issues/1194 12 years ago
Michael DeHaan 6616fba1ab Merge pull request #1189 from jpmens/nagpause
standardize DOCUMENTATION for nagios, pause
12 years ago
Jan-Piet Mens a1f192976f attempt at DOCUMENTATION for async_status 12 years ago
Jan-Piet Mens 83029755f7 standardize DOCUMENTATION for nagios, pause 12 years ago
Michael DeHaan f897f19fc5 Teach fireball mode to disable the fireball by paying attention to 'minutes=N' (default 30) and do not let fireball module crash
on input.
12 years ago
Michael DeHaan 2165351f2c Merge pull request #1185 from tbielawa/pause_docs
Add DOCUMENTATION to pause task
12 years ago
Tim Bielawa ca87fa56d8 Add DOCUMENTATION to pause task 12 years ago
Tim Bielawa f3d9f8da7b Add DOCUMENTATION to nagios module. 12 years ago
Michael DeHaan 886a17853f Merge pull request #1176 from jpmens/fireball-doc1
fireball DOCUMENTATION
12 years ago
Jan-Piet Mens f2dc815e3f fireball DOCUMENTATION
- amended
12 years ago
Michael DeHaan 6600f7b7ac Merge pull request #1170 from jpmens/docspatch01
Jumbo DOCUMENTATION patch
12 years ago
Michael DeHaan ac3ec0a410 Merge pull request #1173 from dhozac/command-quote-less
Use a regexp to filter out arguments instead
12 years ago
Jan-Piet Mens a72a6e42c5 Added attribution to all module DOCUMENTATION strings 12 years ago
Daniel Hokka Zakrisson 6477bdc6fc Use a regexp to filter out arguments instead
pipes.quote is a bit overzealous for what we want to do, quoting ;
and other characters that you most likely want to use in your shell
invocations. The regexp is the best I could come up with to be able
to only replace the parts of the arguments that shouldn't be
executed.
12 years ago
Jan-Piet Mens e620fed755 Jumbo DOCUMENTATION patch 12 years ago
Michael DeHaan 190e4c26d1 Merge pull request #1167 from jpmens/slurp01
module docs for slurp
12 years ago
Jan-Piet Mens 8b737c959d module docs for slurp 12 years ago
Michael DeHaan a00d6d7234 Merge pull request #1166 from mavimo/documentation-seboolean
Added DOCUMENTATION to seboolean module.
12 years ago
Marco Vito Moscaritolo f9bdf07387 Added DOCUMENTATION to seboolean module. 12 years ago
Michael DeHaan f8060d109e Merge pull request #1165 from mavimo/documentation-selinux
Added DOCUMENTATION to selinux module.
12 years ago
Michael DeHaan 349af83c91 Merge pull request #1164 from jpmens/modformatter
module_formatter now also uses Jinja2 trim_blocks
12 years ago
Marco Vito Moscaritolo 7491054ed6 Added DOCUMENTATION to selinux module. 12 years ago
Jan-Piet Mens e4338d0ca3 module_formatter now also uses Jinja2 trim_blocks
- Updated man template accordingly
- seem to have left in illegal char in facter DOCUMENTATION...
12 years ago
Jan-Piet Mens 8a4df98f69 template DOCUMENTATION added to fireball 12 years ago
Jan-Piet Mens 28698d5fcf Attribute author of virt correctly (sorry) 12 years ago
Michael DeHaan b8a2a526fc Merge pull request #1156 from jpmens/m-docs5
DOCUMENTATION for virt
12 years ago
Michael DeHaan 39c4a4f8a7 Merge pull request #1155 from jpmens/m-docs4
DOCUMENTATION for fetch,mount,ohai,easy_install; .rst template tweaks
12 years ago
Michael DeHaan bf6e783d7a Merge pull request #1152 from sfromm/moduledocs
Add module documentation for git, group, service, and user
12 years ago
Jan-Piet Mens 7a3b2ac287 DOCUMENTATION for virt 12 years ago
Jan-Piet Mens 754888d896 DOCUMENTATION for fetch,mount,ohai,easy_install
- .rst now supresses default if none is set (looks better in HTML)
  - .rst now handles empty options list
  - Fixed postgresql_user and mysql_user because YAML contained colons
  - docs for facter
12 years ago
Stephen Fromm ed07940386 Add LSB facts, as derived from lsb_release -a
This gathers LSB facts via lsb_release.  This complements the
platform facts collected via the platform module.  This reoprts
release, id, description, release, and codename.  It also adds
'major_release', which is the major version number of a distribution.
12 years ago
Stephen Fromm be19e21126 Add module documentation for git, group, service, and user 12 years ago
Michael DeHaan 13e8ef5f35 Merge pull request #1146 from dhozac/command-escape-args
Properly parse escaped special arguments
12 years ago
Michael DeHaan e744e864d9 Merge pull request #1140 from mavimo/devel
Refs #1116: DOCUMENTATION string update
12 years ago
Michael DeHaan 78911f1b26 Merge pull request #1145 from mavimo/documentation-supervisorctl
Added DOCUMENTATION to supervisorctl module.
12 years ago
Michael DeHaan 4823371aff Merge pull request #1144 from mavimo/documentation-pip
Added DOCUMENTATION to pip module.
12 years ago
Daniel Hokka Zakrisson 9261d3962b Properly parse escaped special arguments
Fixes issue #1134
12 years ago