From 0bccec9fb5cc29bfb4660469f1fd072ef834001b Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Sun, 11 Mar 2012 21:09:21 -0400 Subject: [PATCH] Add polling info to docs --- ansible | 2 +- examples.html | 19 ++++++++++++++----- man/ansible-playbook.1.html | 4 ++-- man/ansible.1.html | 8 ++++++-- rst/examples.rst | 19 ++++++++++++++++--- searchindex.js | 2 +- 6 files changed, 40 insertions(+), 14 deletions(-) diff --git a/ansible b/ansible index 209760f8f60..328f58479dc 160000 --- a/ansible +++ b/ansible @@ -1 +1 @@ -Subproject commit 209760f8f60ec24e3ccb176914965cd1e223abe4 +Subproject commit 328f58479dc2d0ed5d22cbfeaac060c59eb901dc diff --git a/examples.html b/examples.html index 5070e42d4b7..9fcf205df9e 100644 --- a/examples.html +++ b/examples.html @@ -269,16 +269,25 @@ directly from git and then restarting apache.

Time Limited Background Operations

Long running operations can be backgrounded, and their status can be checked on later. The same job ID is given to the same task on all -hosts, so you won’t lose track. Polling support is pending in the -command line.:

-
ansible all -B 3600 -a "/usr/bin/long_running_operation --do-stuff"
-ansible all -n job_status -a jid=123456789
+hosts, so you won’t lose track. If you kick hosts and don’t want +to poll, it looks like this:

+
ansible all -B 3600 -a "/usr/bin/long_running_operation --do-stuff"
+

If you do decide you want to check on the job status later, you can:

+
ansible all -n job_status -a jid=123456789
+
+

Polling is built-in and looks like this:

+
ansible all -B 3600 -P 60 -a "/usr/bin/long_running_operation --do-stuff"
+
+

The above example says “run for 60 minutes max (60*60=3600), poll for status every 60 seconds”. +Poll mode is smart so all jobs will be started before polling will begin on any machine. +Be sure to use a high enough –forks value if you want to get all of your jobs started +very quickly.

Any module other than copy or template can be backgrounded. Typically you’ll be backgrounding shell commands or software upgrades only.

After the time limit (in seconds) runs out (-B), the process on -the remote nodes will be killed.

+the remote nodes will be killed. Forcibly.

diff --git a/man/ansible-playbook.1.html b/man/ansible-playbook.1.html index 9bf9718e0df..cf1adddec1a 100644 --- a/man/ansible-playbook.1.html +++ b/man/ansible-playbook.1.html @@ -1,6 +1,6 @@ -ansible-playbook

Name

ansible-playbook — run an ansible playbook

Synopsis

ansible-playbook <filename.yml> … [options]

DESCRIPTION

Ansible playbooks are a configuration and multinode deployment system. Ansible-playbook is the tool +ansible-playbook

Name

ansible-playbook — run an ansible playbook

Synopsis

ansible-playbook <filename.yml> … [options]

DESCRIPTION

Ansible playbooks are a configuration and multinode deployment system. Ansible-playbook is the tool used to run them. See the project home page (link below) for more information.

ARGUMENTS

filename.yml
@@ -22,5 +22,5 @@ Desired level of parallelism. Default 5.
Prompt for the SSH password instead of assuming key-based authentication with ssh-agent.

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 +for a complete list of contributors.

COPYRIGHT

Copyright © 2012, Michael DeHaan

Ansible is released under the terms of the GPLv3 License.

SEE ALSO

ansible(1)

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

diff --git a/man/ansible.1.html b/man/ansible.1.html index 328cf0e6b63..797e99f41ee 100644 --- a/man/ansible.1.html +++ b/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
@@ -47,11 +47,15 @@ Connection timeout to use when trying to talk to hosts, in seconds.
Runs commands in the background, killing the task after N seconds.
+-P, --poll +
+Poll a background job every (this many) seconds. Requires -B. +
-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 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 +for a complete list of contributors.

COPYRIGHT

Copyright © 2012, Michael DeHaan

Ansible is released under the terms of the GPLv3 License.

SEE ALSO

ansible-playbook(1)

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

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