From a631c21e5a35d6f37b71a6abfec02696f5b62ac2 Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Fri, 9 Mar 2012 22:11:41 -0500 Subject: [PATCH] Add ansible-playbook(1) manpage. --- Makefile | 3 +-- ansible | 2 +- html/index.html | 1 + html/man.html | 10 +++++++- html/man/ansible-modules.5.html | 2 +- html/man/ansible-playbook.5.html | 2 +- html/man/ansible.1.html | 43 ++++++++++++++++++++++++++------ html/searchindex.js | 2 +- rst/man.rst | 8 +++++- 9 files changed, 57 insertions(+), 16 deletions(-) diff --git a/Makefile b/Makefile index 63115d73299..4a7fb546db6 100644 --- a/Makefile +++ b/Makefile @@ -13,8 +13,7 @@ viewdocs: clean htmlman: mkdir -p html/man $(ASCII2HTMLMAN) ansible/docs/man/man1/ansible.1.asciidoc - $(ASCII2HTMLMAN) ansible/docs/man/man5/ansible-modules.5.asciidoc - $(ASCII2HTMLMAN) ansible/docs/man/man5/ansible-playbook.5.asciidoc + $(ASCII2HTMLMAN) ansible/docs/man/man1/ansible-playbook.1.asciidoc htmldocs: ./build-site.py rst diff --git a/ansible b/ansible index 96d39a0dff9..209760f8f60 160000 --- a/ansible +++ b/ansible @@ -1 +1 @@ -Subproject commit 96d39a0dff9ccba4074479ca42eac0068733b803 +Subproject commit 209760f8f60ec24e3ccb176914965cd1e223abe4 diff --git a/html/index.html b/html/index.html index 52208cb978b..8aad5d23871 100644 --- a/html/index.html +++ b/html/index.html @@ -285,6 +285,7 @@ you with questions about Ansible.

  • Man Pages
    • diff --git a/html/man.html b/html/man.html index d5de13b4d77..306f5a98fe9 100644 --- a/html/man.html +++ b/html/man.html @@ -112,6 +112,7 @@ @@ -145,13 +146,20 @@

    Man Pages

    -

    Ansible’s manpage lists available command line options.

    +

    Ansible’s man pages list available command line options. See the rest of the web site for +examples of these tools in use.

    ansible(1)

    +
    +

    ansible-playbook(1)

    + +
    diff --git a/html/man/ansible-modules.5.html b/html/man/ansible-modules.5.html index 4992300760d..172b247bb84 100644 --- a/html/man/ansible-modules.5.html +++ b/html/man/ansible-modules.5.html @@ -1,6 +1,6 @@ -ansible-modules

    Name

    ansible-modules — stock modules shipped with ansible

    DESCRIPTION

    Ansible ships with a number of modules that can be executed directly on remote hosts or through +ansible-modules

    Name

    ansible-modules — stock modules shipped with ansible

    DESCRIPTION

    Ansible ships with a number of modules that can be executed directly on remote hosts or through ansible playbooks.

    IDEMPOTENCE

    Most modules other than command are idempotent, meaning they will seek to avoid changes unless a change needs to be made. When using ansible playbooks, these modules can trigger change events, as described in ansible-playbooks(5).

    Unless otherwise noted, all modules support change hooks.

    command

    The command module takes the command name followed by a list of arguments, space delimited. diff --git a/html/man/ansible-playbook.5.html b/html/man/ansible-playbook.5.html index 9ff20e12b3b..9a195d52f2a 100644 --- a/html/man/ansible-playbook.5.html +++ b/html/man/ansible-playbook.5.html @@ -1,6 +1,6 @@ -ansible-modules

    Name

    ansible-playbook — format and function of an ansible playbook file

    DESCRIPTION

    Ansible ships with ansible-playbook, a tool for running playbooks. +ansible-modules

    Name

    ansible-playbook — format and function of an ansible playbook file

    DESCRIPTION

    Ansible ships with ansible-playbook, a tool for running playbooks. Playbooks can represent frequent tasks, desired system configurations, or deployment processes.

    FORMAT

    Playbooks are written in YAML.

    EXAMPLE

    See:

    • https://github.com/mpdehaan/ansible/blob/master/examples/playbook.yml diff --git a/html/man/ansible.1.html b/html/man/ansible.1.html index df1085ff5da..5b5323c3f14 100644 --- a/html/man/ansible.1.html +++ b/html/man/ansible.1.html @@ -1,6 +1,6 @@ -ansible

      Name

      ansible — run a command somewhere else

      Synopsis

      ansible <host-pattern> [-f forks] [-m module_name] [-a args]

      DESCRIPTION

      Ansible is an extra-simple tool/framework/API for doing 'remote things' over +ansible

      Name

      ansible — run a command somewhere else

      Synopsis

      ansible <host-pattern> [-f forks] [-m module_name] [-a args]

      DESCRIPTION

      Ansible is an extra-simple tool/framework/API for doing 'remote things' over SSH.

      ARGUMENTS

      host-pattern
      @@ -19,12 +19,39 @@ Level of parallelism. Specify as an integer, the default is 5.
      Module name to execute.
      --p, --pattern +-M, --module-path
      -Hostname pattern. Accepts shell-like globs which can be seperated with ";" -The default is "*" which matches all hosts in the ansible hosts file. Group -names from the ansible inventory file can also be used. -

      See ansible --help for additional options.

      INVENTORY

      Ansible stores the hosts it can potentially operate on in an inventory +Where to load modules from. The default is /usr/share/ansible +

      +-a, --args +
      +Arguments to pass to the module +
      +-k, --ask-pass +
      +Prompt for the SSH password instead of assuming key-based authentication with ssh-agent. +
      +-o, --one-line +
      +Try to output everything on one line. +
      +-t, --tree +
      +Save contents in this output directory, with the results named in a file named after each host. +
      +-T, --timeout +
      +Connection timeout to use when trying to talk to hosts, in seconds. +
      +-B, --background +
      +Runs commands in the background, killing the task after N seconds. +
      +-u, --remote-user +
      +Use this remote username instead of root +

      INVENTORY

      Ansible stores the hosts it can potentially operate on in an inventory file. The syntax is one host per line. Groups headers are allowed and -are included on their own line, enclosed in square brackets.

      FILES

      /etc/ansible/hosts — Default hosts file

      /usr/share/ansible — Default module library

      ENVIRONMENT

      The following environment variables may specified.

      ANSIBLE_HOSTS  — Override the default ansible hosts file

      ANSIBLE_LIBRARY — Override the default ansible module library path

      AUTHOR

      Ansible was originally written by Michael DeHaan. See the AUTHORS file -for a complete list of contributors.

      COPYRIGHT

      Copyright © 2012, Michael DeHaan

      Ansible is released under the terms of the GPLv3 License.

      SEE ALSO

      Ansible home page: https://github.com/mpdehaan/ansible/

      ansible-modules(5)

      ansible-playbook(5)

      +are included on their own line, enclosed in square brackets.

      FILES

      /etc/ansible/hosts — Default inventory file

      /usr/share/ansible/ — Default module library

      ENVIRONMENT

      The following environment variables may specified.

      ANSIBLE_HOSTS  — Override the default ansible hosts file

      ANSIBLE_LIBRARY — Override the default ansible module library path

      AUTHOR

      Ansible was originally written by Michael DeHaan. See the AUTHORS file +for a complete list of contributors.

      COPYRIGHT

      Copyright © 2012, Michael DeHaan

      Ansible is released under the terms of the GPLv3 License.

      SEE ALSO

      Extensive documentation as well as IRC and mailing list info +is available on the ansible home page: https://ansible.github.com/

    diff --git a/html/searchindex.js b/html/searchindex.js index 528acfe6b57..63123278fbd 100644 --- a/html/searchindex.js +++ b/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{},terms:{all:[0,1,2,3,4,5,6,7,8],concept:8,mcollect:1,consum:2,pluggabl:2,invent:[],prefix:[3,4,8],code:[1,2,3,8],abil:2,follow:[2,3,4,6,7,8],scp:8,bubbl:[3,4],decid:2,middl:4,depend:2,secur:2,graph:2,sorri:[],elsewher:8,readabl:[],program:[1,2,3,4],selinux:4,larg:2,blindingli:1,spec:4,introduc:1,"case":2,sourc:[1,2,3,4,7,8],everi:[5,4],string:3,without:2,fals:[5,3],multi:[1,2,4],mechan:[],difficult:2,failur:[7,2,3],veri:[7,1,2,4],affect:4,implicitli:2,magic:2,level:[5,3,4],id_rsa:[0,8],list:[1,2,3,4,5,6,8,9],"try":2,item:[5,7],sane:2,form:[5,4],team:2,dotnet:5,saltstack:1,spent:2,straight:8,pkg:3,pleas:2,alic:4,natur:3,seper:2,direct:2,batch:2,chef:[1,2],second:[5,8],design:[1,2],pass:[3,4],download:[0,1],further:4,submit:2,port:[2,8],even:[2,8],what:[0,2,3,4,1],insid:4,compar:2,favcolor:[4,8],fine:2,section:[1,3,4],abl:[],current:2,abbrevi:5,version:[3,8],suspect:2,"new":2,net:2,varnam:4,ever:1,method:7,told:4,xml:[],hasn:2,hash:3,abov:4,conf:[4,8],eckersberg:[5,2],gener:[2,4],never:2,here:[3,4,8],shouldn:2,let:[2,4,8],pub:8,address:[6,2,3],path:3,sinc:8,valu:[5,3,4],box:[1,3],great:[1,2],tire:2,ahead:4,precursor:1,technolog:1,step:[2,3,4],adopt:2,prior:3,pick:[5,2,8],action:[1,3,4],extrem:0,implement:7,commonli:8,ourselv:4,employe:5,via:[0,1],regardless:[5,1,2,4],extra:[2,4],solut:2,modul:[0,1,2,3,4,7,8],releas:[0,2],unix:[2,4],"boolean":5,instal:[0,1,2,3,4,8],select:[1,3,4,6],httpd:[4,8],from:[0,1,2,3,4,5,8],describ:[3,4],would:[3,8],commun:2,"super":1,visit:1,two:[5,0,6],noarch:0,live:0,handler:[1,4,8],call:3,usr:[7,3,4,8],handl:2,msg:[7,3],suppos:4,checkout:[2,3],tell:[3,4,8],more:[0,1,2,3,4,6],sort:2,flat:4,desir:4,idempot:[2,3,4,8],comparison:[1,2],unneccessari:[],sshd:1,notic:2,train:2,agent:[0,8],particular:[1,4],central:2,compani:2,easiest:1,starter:[],must:[5,3,4],none:7,join:1,ibm:1,module_arg:7,dest:[3,4,8],setup:[1,3,8],work:[0,1,2,4,6,8],knows_oop:5,dev:2,remain:1,minimum:4,can:[0,1,2,3,4,5,6,7,8],erb:2,learn:[6,0,2,4,1],about:[0,1,2,3,4,5],purpos:3,root:[5,1,4],control:[1,3,4,8],want:[7,2,3,4,8],tar:0,process:[1,2,8],rpath:1,sudo:0,share:3,templat:[0,1,2,3,4,8],high:[],critic:1,tag:[0,3],explor:0,occur:4,nearli:[3,4],alwai:[2,3],cours:2,multipl:[6,2,4,8],newlin:5,thoug:[],lame:5,capistrano:[1,2],anoth:2,ping:[0,7,3,1],uptim:7,write:[1,2,3,4,5,8],how:[0,1,2,3,4,5,6,7,8],anyon:2,pure:[],instead:[2,3],simpl:[1,2,4,5,7,8],updat:[3,8],map:4,product:[],financ:1,resourc:2,referenc:[6,4],clone:0,after:[2,4,8],usabl:[1,4],befor:[2,3,4],ohai_:[3,4],mai:[5,0,2,7],end:[2,3,4],suck:[],data:[5,2,3,8,7],parallel:[1,2,8],man:[1,9],"short":[1,2],orchestr:[1,2,4],practic:2,bootstrap:[1,2],favorit:1,element:[5,3],issu:[1,2],inform:[7,3,4],mango:5,combin:5,allow:[2,4],order:[2,4],talk:[0,4],oper:[1,8],help:1,xmpp:2,over:[1,8],move:[3,4],orang:5,mission:1,elit:5,rpmbuild:0,comma:5,hierarchi:2,amqp:[],suffer:2,mainli:2,paramet:[3,4],facter_:[3,4],jid:8,overlord:0,group:[1,7,4,6],cli:7,taboot:2,better:[],yaml:[5,1,2,4],pend:[4,8],rapidli:7,infrastructur:[6,0,2,4,1],mail:[1,2,6],job_statu:8,main:4,might:4,easier:2,wouldn:2,them:[2,3,4,8],good:2,"return":[7,1,2,3],hop:2,thei:[7,2,3,4,8],food:5,dai:2,scene:3,framework:[7,1,2],jinja2:[0,2,3,4,8],half:2,now:[0,2,3],discuss:2,nor:3,choic:1,multiprocess:[0,2],vidal:2,name:[5,1,3,4,8],anyth:[2,3],neccessari:[],config:[1,4],drop:3,datastructur:7,separ:[5,4],easili:[],mode:2,each:[5,2,3,4,8],found:7,stock:3,spend:2,mean:[2,3,4],harm:4,mental:2,michael:1,individu:6,hard:2,idea:[1,2],realli:[5,2,3,4],contributor:[],backport:0,facter:[1,2,3,4,8],our:5,happen:[2,3,4],event:[2,3],special:[],out:[1,2,3,4,5,7,8],variabl:[2,3,4,8],cefengin:[],network:1,space:[1,3],bserver:0,reboot:8,content:[0,2,1],adapt:2,rel:3,internet:1,print:7,got:2,correct:[5,1,2,4],red:[1,2,8],integr:[],painless:1,barrier:[],advanc:[7,2],ntp:8,given:[2,3,8],free:[],someon:[],small:[],reason:2,base:[1,2,4],lab:[1,2],dictionari:5,put:[0,8],org:0,bash:[0,2,8],basi:4,pyyaml:0,sytem:2,indent:5,real:0,could:[7,4],ask:[1,2],fqdn:8,thing:[1,2,4],place:1,isn:[1,2],adrian:2,retain:2,assign:[1,4],frequent:[1,2],first:[0,1,2,3,4,8],origin:1,softwar:[1,2,3,8],rang:1,notifi:[1,2,4,8],directli:[3,4,8],onc:[2,3,4],number:3,yourself:0,hook:3,instruct:[0,2],alreadi:[0,2,3,4],puppet:[1,2],least:[],extend:[1,2],massiv:1,open:2,differ:[8,0,2,4,1],convent:3,script:[7,1,2,8],associ:5,top:[2,3,4],mkdir:4,system:[0,1,2,3,4,6,8],construct:[7,2],grow:[],inventori:[0,6,3,4,1],too:[1,2],statement:[1,4],which:[5,0,6,4,1],gather:2,zeromq:[],john:[5,2],"final":5,iptabl:4,shell:[1,3,8],option:[5,7,4,9,8],especi:2,tool:[7,1,2,3,8],copi:[1,3,8],took:2,specifi:[5,2,3,8],retyp:0,bcfg2:[],pars:2,domin:[],than:[0,1,2,3,4,8],wide:2,liter:3,silli:4,target:[1,6],keyword:2,provid:5,remov:3,richer:2,structur:5,banana:5,project:[0,2,8,1],inquir:[],reus:4,architect:1,were:[2,4],tion:[],uses_cv:5,transport:[1,2],provis:2,pre:0,sai:[2,4],fashion:2,comput:[],runner:7,explicit:3,mind:2,ani:[1,2,3,4,7,8],seth:2,sysadmin:2,packag:[2,3],have:[0,2,4,1],need:[0,2,3,4,5,8],seem:2,cfengin:2,seek:3,paramiko:0,sat:2,imagin:4,engin:8,built:[0,2],veteran:[],contact:[7,0,2,3],note:[6,3,4,8],also:[0,1,2,3,4,5,6,7,8],ideal:[1,2],client:1,build:[7,0,2],indic:3,datacent:4,divers:1,singl:2,begin:5,unless:3,distribut:[0,2,1],deploy:[1,2,4,8],track:8,who:[],deleg:2,discov:4,most:[5,2,3],plai:[3,4],regular:4,plan:2,deploi:[1,2,3,4,8],pair:3,why:1,prove:[],don:[2,3],doc:1,later:8,cover:[2,8],doe:[1,2,3,6],meanwhil:2,bracket:[5,6],snapshot:3,yum:[1,3],wildcard:6,databas:4,salt:[],awesom:[1,4],think:2,show:[4,8],cheat:2,text:2,verbos:3,syntax:[5,2,4],bring:4,raleigh:1,particularli:4,playbook:[0,1,2,3,4,5,6,7,8],hack:1,radic:1,identifi:2,trivial:[1,3],find:2,rotat:4,involv:[],absolut:3,onli:[0,2,3,4,8],explicitli:4,locat:3,acquir:[],pretti:[7,2],configur:[0,1,2,3,4,5,6,8],apach:[2,4,8],behind:[2,3],should:[5,2,3],somevar:4,freenod:1,local:3,yml:4,custom:2,long_running_oper:8,contribut:1,variou:[2,3],get:[0,1,2,4,5,8],express:[5,1,7,4],stop:[3,4],kind:2,autom:2,repo:[3,8],ssl:2,obviou:1,ssh:[0,2,8,1],requir:[0,2,3,1],uvh:0,experi:2,bar:6,patch:2,sha:3,stuff:8,common:4,contain:[2,3,4],through:[0,3,1],where:[1,2,3,4],view:[1,9],set:[0,2,3,4],hierachi:2,still:2,roadmap:[],see:[0,1,3,4,5,6,8],result:[7,3],fail:[7,2,4],charact:5,becaus:2,ntp_server:8,best:[2,4],planet:1,statu:8,wire:[],manpag:[0,9],expert:2,pattern:[1,7,4,6],someth:[1,2,3,8],discoveri:3,restart:[2,3,4,8],state:[2,3,4,8],won:8,between:[5,2,4],"import":7,irc:1,across:2,attribut:3,altern:8,solo:2,kei:[5,0,3,4],style:3,extens:[1,2],job:[5,8],entir:[2,4],aserv:0,pull:2,webapp:[2,8],asdescrib:[],minut:2,addit:[5,1,4],both:2,j2ee:[],delimit:3,goal:1,howev:2,equal:2,against:[1,2,4,6],etc:[0,1,2,4,6,8],instanc:4,logic:4,mani:[4,8],com:[0,7,4,6],among:2,assur:4,simpli:[3,4],author:1,figur:2,overview:5,inspir:[1,2],header:6,written:[1,3,4,8],colon:4,shutdown:3,linux:[1,2,4],poll:[1,4,8],rpm:[0,1],three:6,coupl:2,platform:2,multiplay:1,due:2,been:[1,2],timmi:4,json:[7,1,2,3],much:[1,2,3],treat:2,interest:[],basic:[0,1,2,3,5,6],quickli:[5,1],indenta:[],rather:2,fire:[1,2],rubi:[5,2,3,8],argument:3,likes_emac:5,func:[1,2],atlanta:[4,8],those:[5,2,3],statist:[],emploi:5,authorized_kei:0,exception:2,look:[6,4,8],replac:4,hoc:[1,2,4,8],servic:[1,3,4,8],md5sum:3,straighten:2,defin:4,"while":[2,4],kick:2,facter_hostnam:4,error:2,cobbler:[1,2],dehaan:1,layer:2,motd:[4,8],max_client:4,stdout:7,almost:2,likin:2,site:2,believ:2,dag:2,myapp:8,module_nam:7,sever:[5,2],http_port:4,develop:[5,0,2,1],welcom:1,minim:0,perform:2,impact:2,make:[0,2,3,4,8],ohai:[1,2,3,4,8],cross:2,same:[5,6,8],member:5,python:[0,1,2,3,5,7,8],complex:[1,2,4],success:3,document:[7,0,2,4,8],ansibl:[0,1,2,3,4,5,6,7,8,9],complet:[0,2,4],http:3,hostnam:[7,4],again:[2,4],nest:3,permit:5,rail:2,effect:4,remot:[0,3,4,8],fruit:5,user:[2,4],php:8,distutil:[0,1],typic:[2,8],tune:2,recent:2,lower:2,appropri:2,off:[1,2],scenario:3,mention:4,setenforc:4,compos:4,well:[0,2,3,4],hypothet:4,non:1,exampl:[0,1,2,3,4,5,6,7,8],command:[0,1,2,3,4,6,7,8,9],thi:[0,1,2,3,4,5,6,8],choos:3,programm:[7,2],dereferenc:4,usual:4,next:4,protocol:3,entri:[],just:[0,1,2,3,4,8],less:[0,2,1],excel:[1,2],detail:[1,7],kill:8,human:[],heavili:2,skill:5,simultan:8,languag:[0,1,2,3,5,6],web:[7,2,8],versu:1,easi:[1,2,3],mix:6,trigger:[2,3],except:4,littl:[1,2],add:[0,2,8],notori:2,els:1,unlik:[2,4],hat:[1,2],app:2,match:4,take:[2,3],bin:[0,7,3,4,8],applic:[7,2,4],around:2,format:[0,1,2,3,4,5,6,8],read:[5,0,7],term:[],fast:1,dark:7,game:1,know:[5,2,3,4],background:[1,8],world:[0,2],bit:[2,3],password:0,licens:[],daemon:[1,2],motorola:1,like:[2,3,4,5,6,8],specif:[6,7,4,8],distil:2,corpor:[],signal:[2,4],arbitrari:2,manual:2,integ:3,noth:4,edit:0,api:[7,1,2,3],necessari:[3,8],either:[2,3],lose:8,popular:1,output:[2,4],manag:[0,1,2,3,4,5,6,8],stdin:[],shed:2,didn:2,often:2,webserv:[6,4,8],suppli:3,some:[0,2,3,1],back:[2,4],dead:1,born:2,heritag:2,server:[1,2,3,4,8],librari:[],tmp:[4,8],render:3,lead:2,assum:4,avoid:[0,2,3],though:[1,2,3],definit:4,thank:2,per:7,tracker:1,exit:7,cloud:2,foo:[6,8],complic:[1,2],refer:8,machin:[0,2,3,4,8],core:[1,2],encourag:2,yamllint:5,run:[0,2,3,4,7,8],itself:7,power:[7,1,2],usag:[3,8],devop:1,web2:7,host:[0,1,2,3,4,6,7,8],web1:7,promot:2,repositori:0,async:2,meantim:2,major:[],appli:2,task:[1,2,4,8],simpler:[2,8],src:[3,4,8],sbin:[3,4,8],actual:[2,3],gplv3:[],othervar:4,surround:5,page:[5,0,2,9,1],kept:[2,4],srv:[4,8],messag:[7,2],done:[2,4],industri:1,own:[1,2,3,4],effici:2,bounc:3,within:[2,3],contriv:4,sneaker:2,automat:3,upgrad:[3,8],down:7,bsd:2,multinod:2,ensur:[2,4,8],chang:[3,4,8],perl:8,soon:2,your:[0,1,2,3,4,5,6,8],merg:2,git:[0,2,3,8,1],type:[7,2],fabric:[1,2],wai:[5,0,2,4,8],aren:2,transfer:[1,8],execut:[7,1,2,3,4],support:[1,2,3,8],question:[1,2],"long":[1,2,3,8],happi:1,avail:[0,2,3,4,7,8,9],start:[0,1,2,3,4,5,8],appl:5,wordpress:4,includ:[1,3,4],lot:[1,4,8],suit:[2,4],"var":[1,4],fork:[7,2],head:[3,8],simplejson:0,enough:2,lint:5,yeah:4,github:[0,1],taken:[2,4],line:[0,1,2,3,4,5,6,7,8,9],"true":[5,3,4],congratul:0,info:4,strawberri:5,"throw":2,made:[2,3,8],possibl:[6,4,8],whether:[7,2],wish:[5,0,7,2,6],caller:3,until:0,asynchron:[1,4],record:5,limit:[1,8],rerun:4,otherwis:3,problem:2,similar:3,chip:1,curv:[1,2],featur:[2,4],tasti:5,creat:[1,2],certain:[2,4],"abstract":[],doesn:1,repres:5,strongli:2,exist:[1,4],file:[0,1,3,4,5,6,8],bob:4,ship:3,check:[2,3,8],probabl:2,echo:0,denot:6,coder:2,googl:1,dbserver:[6,4],when:[2,3,4,8],unnecessari:3,"default":[1,2,6],nich:[],other:[0,1,2,3,4,8],futur:0,varieti:2,test:[0,2,3],squar:5,you:[0,1,2,3,4,5,6,8],architectur:2,node:[0,2,3,8,1],contend:2,notif:2,intend:[],clean:2,sequenc:1,"class":[1,4],asciidoc:0,push:[2,4],scale:[1,2],intent:2,log:4,deferenc:4,gap:2,"60k":[1,2],stai:2,sphinx:0,amp:0,soap:[],directori:[3,4],reliabl:2,portion:6,emerg:1,fact:[],potenti:4,time:[0,1,2,3,4,6,8],far:1,hello:0},objtypes:{},titles:["Downloads & Getting Started","Introducing Ansible","Frequently Asked Questions","Ansible Modules","Playbooks","YAML Format","The Inventory File, Patterns, and Groups","Using the Python API","Command Line Examples","Man Pages"],objnames:{},filenames:["gettingstarted","index","faq","modules","playbooks","YAMLScripts","patterns","api","examples","man"]}) \ No newline at end of file +Search.setIndex({objects:{},terms:{all:[0,1,2,3,4,5,6,7,8],concept:8,wire:[],myapp:8,perl:8,mcollect:1,consum:2,pluggabl:2,invent:[],prefix:[3,4,8],code:[1,2,3,8],upgrad:[3,8],abil:2,follow:[2,3,4,6,7,8],scp:8,content:[0,2,1],decid:2,middl:4,depend:2,secur:2,git:[0,2,3,8,1],graph:2,sorri:[],elsewher:8,readabl:[],specif:[6,7,4,8],program:[1,2,3,4],selinux:4,exit:7,blindingli:1,spec:4,introduc:1,emploi:5,sourc:[1,2,3,4,7,8],everi:[5,4],string:3,fals:[5,3],exception:2,mechan:[],whether:[7,2],failur:[7,2,3],veri:[7,1,2,4],affect:4,implicitli:2,magic:2,level:[5,3,4],id_rsa:[0,8],list:[1,2,3,4,5,6,8,9],"try":2,item:[5,7],sane:2,team:2,dotnet:5,saltstack:1,servic:[1,3,4,8],playbook:[0,1,2,3,4,5,6,7,8,9],pleas:2,alic:4,natur:3,seper:2,direct:2,straighten:2,chef:[1,2],second:[5,8],design:[1,2],pass:[3,4],download:[0,1],further:4,port:[2,8],even:[2,8],what:[0,2,3,4,1],insid:4,compar:2,favcolor:[4,8],trivial:[1,3],section:[1,3,4],abl:[],current:2,abbrevi:5,version:[3,8],suspect:2,"new":2,net:2,varnam:4,ever:1,method:7,told:4,manag:[0,1,2,3,4,5,6,8],involv:[],hasn:2,hash:3,facter_hostnam:4,eckersberg:[5,2],gener:[2,4],never:2,here:[3,4,8],shouldn:2,let:[2,4,8],free:[],address:[6,2,3],path:3,sinc:8,valu:[5,3,4],box:[1,3],great:[1,2],pretti:[7,2],ahead:4,precursor:1,technolog:1,host:[0,1,2,3,4,6,7,8],later:8,prior:3,pick:[5,2,8],action:[1,3,4],extrem:0,implement:7,commonli:8,ourselv:4,employe:5,via:[0,1],regardless:[5,1,2,4],extra:[2,4],apach:[2,4,8],modul:[0,1,2,3,4,7,8],put:[0,8],unix:[2,4],"boolean":5,instal:[0,1,2,3,4,8],select:[1,3,4,6],httpd:[4,8],from:[0,1,2,3,4,5,8],describ:[3,4],would:[3,8],commun:2,"super":1,visit:1,two:[5,0,6],noarch:0,suit:[2,4],live:0,handler:[1,4,8],call:3,usr:[7,3,4,8],msg:[7,3],somevar:4,checkout:[2,3],tell:[3,4,8],more:[0,1,2,3,4,6],sort:2,flat:4,desir:4,idempot:[2,3,4,8],src:[3,4,8],python:[0,1,2,3,5,7,8],unneccessari:[],sshd:1,notic:2,train:2,agent:[0,8],particular:[1,4],actual:[2,3],compani:2,easiest:1,starter:[],must:[5,3,4],none:7,join:1,ibm:1,module_arg:7,setup:[1,3,8],work:[0,1,2,4,6,8],knows_oop:5,dev:2,remain:1,minimum:4,can:[0,1,2,3,4,5,6,7,8],erb:2,learn:[6,0,2,4,1],about:[0,1,2,3,4,5],purpos:3,root:[5,1,4],control:[1,3,4,8],gplv3:[],want:[7,2,3,4,8],tar:0,process:[1,2,8],rpath:1,sudo:0,share:3,templat:[0,1,2,3,4,8],high:[],critic:1,tag:[0,3],explor:0,occur:4,contribut:1,alwai:[2,3],cours:2,multipl:[6,2,4,8],newlin:5,thoug:[],lame:5,capistrano:[1,2],anoth:2,ping:[0,7,3,1],uptim:7,write:[1,2,3,4,5,8],how:[0,1,2,3,4,5,6,7,8],anyon:2,pure:[],instead:[2,3],config:[1,4],stock:3,map:4,product:[],express:[5,1,7,4],resourc:2,referenc:[6,4],clone:0,after:[2,4,8],lab:[1,2],befor:[2,3,4],ohai_:[3,4],mai:[5,0,2,7],end:[2,3,4],suck:[],data:[5,2,3,8,7],parallel:[1,2,8],man:[1,9],"short":[1,2],orchestr:[1,2,4],practic:2,read:[5,0,7],bootstrap:[1,2],favorit:1,element:[5,3],issu:[1,2],inform:[7,3,4],mango:5,combin:5,allow:[2,4],order:[2,4],talk:[0,4],origin:1,help:1,portion:6,xmpp:2,over:[1,8],move:[3,4],orang:5,mission:1,elit:5,rpmbuild:0,comma:5,hierarchi:2,suffer:2,mainli:2,paramet:[3,4],facter_:[3,4],jid:8,overlord:0,group:[1,7,4,6],cli:7,taboot:2,better:[],yaml:[5,1,2,4],pend:[4,8],rapidli:7,infrastructur:[6,0,2,4,1],bin:[0,7,3,4,8],mail:[1,2,6],job_statu:8,main:4,might:4,easier:2,wouldn:2,them:[2,3,4,8],good:2,"return":[7,1,2,3],hop:2,thei:[7,2,3,4,8],food:5,dai:2,number:3,framework:[7,1,2],jinja2:[0,2,3,4,8],half:2,now:[0,2,3],discuss:2,nor:3,choic:1,multiprocess:[0,2],vidal:2,name:[5,1,3,4,8],anyth:[2,3],neccessari:[],simpl:[1,2,4,5,7,8],drop:3,instruct:[0,2],separ:[5,4],easili:[],exampl:[0,1,2,3,4,5,6,7,8,9],mode:2,each:[5,2,3,4,8],found:7,updat:[3,8],mean:[2,3,4],harm:4,mental:2,michael:1,individu:6,hard:2,idea:[1,2],realli:[5,2,3,4],ensur:[2,4,8],backport:0,facter:[1,2,3,4,8],our:5,happen:[2,3,4],event:[2,3],special:[],out:[1,2,3,4,5,7,8],variabl:[2,3,4,8],network:1,space:[1,3],reboot:8,bubbl:[3,4],adapt:2,rel:3,internet:1,print:7,got:2,correct:[5,1,2,4],red:[1,2,8],common:4,barrier:[],advanc:[7,2],ntp:8,differ:[8,0,2,4,1],pub:8,effect:4,small:[],reason:2,base:[1,2,4],usabl:[1,4],dictionari:5,releas:[0,2],org:0,featur:[2,4],bash:[0,2,8],basi:4,pyyaml:0,sytem:2,indent:5,could:[7,4],ask:[1,2],fqdn:8,thing:[1,2,4],place:1,isn:[1,2],adrian:2,retain:2,assign:[1,4],frequent:[1,2],first:[0,1,2,3,4,8],oper:[1,8],softwar:[1,2,3,8],rang:1,notifi:[1,2,4,8],directli:[3,4,8],onc:[2,3,4],scene:3,yourself:0,hook:3,datastructur:7,alreadi:[0,2,3,4],puppet:[1,2],construct:[7,2],extend:[1,2],massiv:1,open:2,given:[2,3,8],"long":[1,2,3,8],convent:3,script:[7,1,2,8],associ:5,top:[2,3,4],mkdir:4,system:[0,1,2,3,4,6,8],least:[],grow:[],appl:5,too:[1,2],statement:[1,4],which:[5,0,6,4,1],zeromq:[],john:[5,2],"final":5,iptabl:4,shell:[1,3,8],option:[5,7,4,9,8],especi:2,welcom:1,tool:[1,2,3,7,8,9],copi:[1,3,8],took:2,specifi:[5,2,3,8],retyp:0,bcfg2:[],pars:2,domin:[],than:[0,1,2,3,4,8],wide:2,liter:3,silli:4,target:[1,6],keyword:2,provid:5,remov:3,richer:2,structur:5,banana:5,project:[0,2,8,1],reus:4,architect:1,were:[2,4],tion:[],uses_cv:5,provis:2,pre:0,sai:[2,4],fashion:2,comput:[],runner:7,explicit:3,mind:2,ani:[1,2,3,4,7,8],hypothet:4,sysadmin:2,packag:[2,3],complet:[0,2,4],have:[0,2,4,1],need:[0,2,3,4,5,8],seem:2,cfengin:2,seek:3,well:[0,2,3,4],paramiko:0,sat:2,imagin:4,engin:8,built:[0,2],veteran:[],client:1,note:[6,3,4,8],also:[0,1,2,3,4,5,6,7,8],ideal:[1,2],contact:[7,0,2,3],build:[7,0,2],indic:3,datacent:4,divers:1,singl:2,happi:1,begin:5,unless:3,distribut:[0,2,1],deploy:[1,2,4,8],track:8,who:[],deleg:2,discov:4,most:[5,2,3],plai:[3,4],regular:4,plan:2,deploi:[1,2,3,4,8],pair:3,why:1,strawberri:5,don:[2,3],wish:[5,0,7,2,6],doc:1,adopt:2,cover:[2,8],doe:[1,2,3,6],meanwhil:2,bracket:[5,6],snapshot:3,yum:[1,3],wildcard:6,pattern:[1,7,4,6],salt:[],awesom:[1,4],think:2,show:[4,8],cheat:2,text:2,verbos:3,syntax:[5,2,4],bring:4,raleigh:1,particularli:4,pkg:3,hack:1,radic:1,protocol:3,dereferenc:4,fine:2,find:2,rotat:4,xml:[],absolut:3,onli:[0,2,3,4,8],explicitli:4,locat:3,acquir:[],tire:2,configur:[0,1,2,3,4,5,6,8],solut:2,state:[2,3,4,8],should:[5,2,3],suppos:4,congratul:0,local:3,yml:4,long_running_oper:8,nearli:[3,4],variou:[2,3],get:[0,1,2,4,5,8],financ:1,stop:[3,4],kind:2,autom:2,repo:[3,8],ssl:2,obviou:1,ssh:[0,2,8,1],requir:[0,2,3,1],uvh:0,irc:1,bar:6,patch:2,sha:3,stuff:8,integr:[],contain:[2,3,4],through:[0,3,1],where:[1,2,3,4],view:[1,9],set:[0,2,3,4],hierachi:2,roadmap:[],see:[0,1,3,4,5,6,8,9],result:[7,3],fail:[7,2,4],charact:5,becaus:2,skill:5,best:[2,4],asynchron:[1,4],statu:8,still:2,kei:[5,0,3,4],expert:2,databas:4,someth:[1,2,3,8],discoveri:3,restart:[2,3,4,8],behind:[2,3],won:8,between:[5,2,4],"import":7,experi:2,across:2,attribut:3,altern:8,solo:2,manpag:0,style:3,extens:[1,2],job:[5,8],entir:[2,4],aserv:0,webapp:[2,8],asdescrib:[],minut:2,addit:[5,1,4],both:2,j2ee:[],delimit:3,goal:1,howev:2,equal:2,against:[1,2,4,6],etc:[0,1,2,4,6,8],instanc:4,logic:4,mani:[4,8],com:[0,7,4,6],among:2,assur:4,simpli:[3,4],figur:2,overview:5,inspir:[1,2],header:6,written:[1,3,4,8],colon:4,shutdown:3,linux:[1,2,4],poll:[1,4,8],rpm:[0,1],coupl:2,platform:2,multiplay:1,three:6,been:[1,2],timmi:4,json:[7,1,2,3],much:[1,2,3],treat:2,interest:[],basic:[0,1,2,3,5,6],futur:0,quickli:[5,1],indenta:[],rather:2,fire:[1,2],rubi:[5,2,3,8],argument:3,func:[1,2],minim:0,atlanta:[4,8],those:[5,2,3],statist:[],"case":2,authorized_kei:0,multi:[1,2,4],look:[6,4,8],hoc:[1,2,4,8],straight:8,md5sum:3,permit:5,batch:2,defin:4,"while":[2,4],match:4,abov:4,error:2,exist:[1,4],dehaan:1,layer:2,motd:[4,8],max_client:4,stdout:7,almost:2,likin:2,site:[2,9],believ:2,dag:2,conf:[4,8],module_nam:7,sever:[5,2],http_port:4,develop:[5,0,2,1],inventori:[0,6,3,4,1],author:1,perform:2,impact:2,make:[0,2,3,4,8],format:[0,1,2,3,4,5,6,8],cross:2,same:[5,6,8],member:5,handl:2,complex:[1,2,4],document:[7,0,2,4,8],ansibl:[0,1,2,3,4,5,6,7,8,9],difficult:2,http:3,hostnam:[7,4],denot:6,nest:3,painless:1,rail:2,someon:[],remot:[0,3,4,8],fruit:5,user:[2,4],php:8,distutil:[0,1],typic:[2,8],tune:2,recent:2,lower:2,appropri:2,off:[1,2],scenario:3,mention:4,setenforc:4,compos:4,seth:2,spent:2,non:1,without:2,command:[0,1,2,3,4,6,7,8,9],thi:[0,1,2,3,4,5,6,8],choos:3,programm:[7,2],spend:2,usual:4,next:4,identifi:2,entri:[],just:[0,1,2,3,4,8],less:[0,2,1],when:[2,3,4,8],rest:9,kill:8,human:[],heavili:2,ntp_server:8,simultan:8,languag:[0,1,2,3,5,6],web:[7,2,8,9],versu:1,easi:[1,2,3],mix:6,except:4,littl:[1,2],add:[0,2,8],other:[0,1,2,3,4,8],simplejson:0,notori:2,els:1,unlik:[2,4],hat:[1,2],app:2,kick:2,take:[2,3],real:0,applic:[7,2,4],around:2,ohai:[1,2,3,4,8],dest:[3,4,8],term:[],dark:7,game:1,know:[5,2,3,4],background:[1,8],world:[0,2],bit:[2,3],password:0,licens:[],daemon:[1,2],motorola:1,like:[2,3,4,5,6,8],success:3,distil:2,corpor:[],signal:[2,4],arbitrari:2,manual:2,integ:3,noth:4,edit:0,api:[7,1,2,3],necessari:[3,8],either:[2,3],lose:8,popular:1,output:[2,4],page:[5,0,2,9,1],stdin:[],shed:2,didn:2,often:2,webserv:[6,4,8],suppli:3,some:[0,2,3,1],back:[2,4],dead:1,born:2,heritag:2,server:[1,2,3,4,8],transport:[1,2],tmp:[4,8],googl:1,render:3,lead:2,assum:4,avoid:[0,2,3],though:[1,2,3],definit:4,thank:2,per:7,tracker:1,larg:2,cloud:2,foo:[6,8],complic:[1,2],refer:8,machin:[0,2,3,4,8],core:[1,2],encourag:2,yamllint:5,run:[0,2,3,4,7,8],power:[7,1,2],usag:[3,8],asciidoc:0,web2:7,step:[2,3,4],web1:7,promot:2,repositori:0,async:2,meantim:2,major:[],appli:2,task:[1,2,4,8],soon:2,simpler:[2,8],comparison:[1,2],sbin:[3,4,8],central:2,prove:[],othervar:4,surround:5,unnecessari:3,kept:[2,4],srv:[4,8],messag:[7,2],done:[2,4],industri:1,own:[1,2,3,4],effici:2,bounc:3,within:[2,3],contriv:4,sneaker:2,automat:3,due:2,down:7,bsd:2,multinod:2,contributor:[],chang:[3,4,8],cefengin:[],bserver:0,your:[0,1,2,3,4,5,6,8],merg:2,fast:1,fabric:[1,2],wai:[5,0,2,4,8],aren:2,transfer:[1,8],execut:[7,1,2,3,4],support:[1,2,3,8],question:[1,2],submit:2,custom:2,avail:[0,2,3,4,7,8,9],start:[0,1,2,3,4,5,8],trigger:[2,3],wordpress:4,includ:[1,3,4],lot:[1,4,8],replac:4,"var":[1,4],far:1,fork:[7,2],head:[3,8],form:[5,4],enough:2,lint:5,yeah:4,github:[0,1],taken:[2,4],line:[0,1,2,3,4,5,6,7,8,9],"true":[5,3,4],freenod:1,info:4,pull:2,"throw":2,made:[2,3,8],possibl:[6,4,8],inquir:[],type:[7,2],caller:3,until:0,planet:1,record:5,limit:[1,8],rerun:4,otherwis:3,problem:2,similar:3,chip:1,curv:[1,2],gather:2,tasti:5,creat:[1,2],certain:[2,4],"abstract":[],doesn:1,repres:5,strongli:2,cobbler:[1,2],file:[0,1,3,4,5,6,8],bob:4,ship:3,check:[2,3,8],probabl:2,echo:0,again:[2,4],coder:2,amqp:[],dbserver:[6,4],excel:[1,2],detail:[1,7],"default":[1,2,6],nich:[],likes_emac:5,librari:[],varieti:2,test:[0,2,3],squar:5,you:[0,1,2,3,4,5,6,8],architectur:2,node:[0,2,3,8,1],contend:2,notif:2,intend:[],clean:2,sequenc:1,"class":[1,4],devop:1,scale:[1,2],intent:2,log:4,deferenc:4,gap:2,"60k":[1,2],stai:2,sphinx:0,amp:0,soap:[],directori:[3,4],reliabl:2,itself:7,emerg:1,fact:[],potenti:4,time:[0,1,2,3,4,6,8],push:[2,4],hello:0},objtypes:{},titles:["Downloads & Getting Started","Introducing Ansible","Frequently Asked Questions","Ansible Modules","Playbooks","YAML Format","The Inventory File, Patterns, and Groups","Using the Python API","Command Line Examples","Man Pages"],objnames:{},filenames:["gettingstarted","index","faq","modules","playbooks","YAMLScripts","patterns","api","examples","man"]}) \ No newline at end of file diff --git a/rst/man.rst b/rst/man.rst index 41dd4e650ee..f1252980252 100644 --- a/rst/man.rst +++ b/rst/man.rst @@ -3,10 +3,16 @@ Man Pages ========= -Ansible's manpage lists available command line options. +Ansible's man pages list available command line options. See the rest of the web site for +examples of these tools in use. ansible(1) ---------- * `View ansible.1 `_ +ansible-playbook(1) +------------------- + +* `View ansible-playbook.1 `_ +