From 1346fd02c907db5a625a6194ae86a9b2408f7147 Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Fri, 9 Mar 2012 19:04:40 -0500 Subject: [PATCH] Added stub yum docs + docs rebuild --- html/index.html | 1 + html/man/ansible-modules.5.html | 2 +- html/man/ansible-playbook.5.html | 2 +- html/man/ansible.1.html | 2 +- html/modules.html | 21 ++++++++++++++++++++- html/objects.inv | Bin 317 -> 320 bytes html/searchindex.js | 2 +- rst/modules.rst | 22 +++++++++++++++++++++- 8 files changed, 46 insertions(+), 6 deletions(-) diff --git a/html/index.html b/html/index.html index f22a8f7d943..a7ea5123ff0 100644 --- a/html/index.html +++ b/html/index.html @@ -238,6 +238,7 @@ you with questions about Ansible.

  • service
  • setup
  • template
  • +
  • yum
  • Writing your own modules
  • diff --git a/html/man/ansible-modules.5.html b/html/man/ansible-modules.5.html index 5d1c3471843..280580b776f 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 5bc84ef1dc5..9bf3b60b5d6 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 401f3bc29dd..c718b60d566 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
      diff --git a/html/modules.html b/html/modules.html index ef0f610301e..7da8b1faa12 100644 --- a/html/modules.html +++ b/html/modules.html @@ -120,6 +120,7 @@
    • service
    • setup
    • template
    • +
    • yum
    • Writing your own modules
    @@ -288,7 +289,7 @@ tell their source. All variables are then bubbled up to the caller.

    template

    Templates a file out to a remote server. Call the setup module -prior to usage.

    +prior to usage if you are not running from a playbook.

    src:

    • Path of a Jinja2 formatted template on the local server. This can @@ -300,6 +301,24 @@ be a relative or absolute path.

    This module also returns md5sum information about the resultant file.

    +
    +

    yum

    +

    Will install, upgrade, remove, and list packages with the yum package manager.

    +

    pkg:

    +
      +
    • A package name or package specifier with version, like name-1.0
    • +
    +

    state:

    +
      +
    • Can be either ‘installed’ or ‘removed’
    • +
    +

    list:

    +
      +
    • When ‘list’ is supplied instead of ‘state’, the yum module can list +various configuration attributes. Values include ‘installed’, ‘updates’, +‘available’, ‘repos’, or any package specifier.
    • +
    +

    Writing your own modules

    To write your own modules, simply follow the convention of those diff --git a/html/objects.inv b/html/objects.inv index 75be6db89a32c46703a7af371693337064a9b015..f8148fc33a333f0f97100402e52e117e2f189f56 100644 GIT binary patch delta 188 zcmV;t07L)10>A>0jDO-m5cCDsW@`)iBiV?3d()o?7O}_7d^1dvK?3|rqf)@$U&6l5lEKFy~LL)E20)ff?(`k%eEw8$6f6*VTN05lSg-bNQhZM7bb q|F76!ouVrclXeQ3Rg1$ak>-6wp!@` delta 185 zcmV;q07n170=)u|jDOODAm|IM&Ds|7N3s?B_NJ{7TBJQ@=9^)X1VUdm5LliRK1e}+ zgfMD{hPB$kZ33=Xlh9VSM$&tZyFO3GH*>MFQv~H8i9p=Bc|wnVnCLy^q9*gFIH}*( zsjf9IGHiYSv|b}GrXVwU^J^{>3`H9U6=OssYCU^zXpzt2D>6(>252Olz3p5OmDPGU nu3zzqRg7*xOxh`A+Q2I7`VAy5S`cWGdx_rgpFw;8f*G#+xoTD$ diff --git a/html/searchindex.js b/html/searchindex.js index 2f664d872a6..a3f2abd70af 100644 --- a/html/searchindex.js +++ b/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{},terms:{all:[0,1,2,3,4,5,6,7],concept:7,mcollect:1,prefix:[2,3,7],code:[1,2,7],follow:[5,6,2,3,7],scp:7,bubbl:[2,3],middl:3,elsewher:7,program:[1,2,3],selinux:3,blindingli:1,spec:3,introduc:1,sourc:[1,6,2,3,7],everi:[4,3],string:2,fals:[4,2],failur:[6,2],veri:[1,6,3],affect:3,level:[4,2,3],id_rsa:[0,7],list:[1,2,3,4,5,7,8],item:[4,6],form:[4,3],dotnet:4,saltstack:1,straight:7,alic:3,natur:2,seper:[],chef:1,second:[4,7],design:1,pass:[2,3],download:0,further:3,port:7,even:7,what:[0,2,3],favcolor:[3,7],section:[1,2,3],abbrevi:4,version:[2,7],varnam:3,ever:1,method:6,told:3,tar:0,hash:2,abov:3,conf:[3,7],eckersberg:4,gener:3,here:[2,3,7],let:[3,7],address:[5,2],path:2,sinc:7,valu:[4,2,3],box:[1,2],great:1,ahead:3,precursor:1,technolog:1,step:[2,3],prior:2,pick:[4,7],action:[1,2,3],extrem:0,implement:6,commonli:7,ourselv:3,employe:4,via:[0,1],regardless:[4,1,3],extra:3,modul:[0,1,2,3,6,7],releas:0,unix:3,"boolean":4,instal:[7,0,2,3,1],select:[1,2,3,5],httpd:[3,7],from:[0,1,2,3,4,7],describ:[2,3],would:[2,7],commun:1,visit:1,two:[4,0,5],noarch:0,live:0,handler:[1,3,7],call:2,usr:[6,2,3,7],msg:[6,2],suppos:3,checkout:2,tell:[2,3,7],more:[0,5,2,3,1],flat:3,desir:3,idempot:[2,3,7],comparison:1,unneccessari:[],sshd:1,agent:[0,7],particular:[1,3],easiest:1,must:[4,2,3],none:6,join:1,ibm:1,module_arg:6,dest:[2,3,7],setup:[1,2,7],work:[7,0,5,3,1],knows_oop:4,remain:1,minimum:3,can:[0,1,2,3,4,5,6,7],learn:[0,5,3,1],about:[4,0,2,3,1],purpos:2,root:[4,1,3],control:[1,2,3,7],want:[6,2,3,7],yamllint:4,process:[1,7],rpath:1,sudo:0,share:2,templat:[7,0,2,3,1],critic:1,liter:2,explor:0,occur:3,nearli:[2,3],alwai:2,multipl:[5,3,7],newlin:4,thoug:[],lame:4,capistrano:1,ping:[0,6,2,1],uptim:6,write:[4,1,2,3,7],how:[0,2,3,4,5,6,7],instead:2,simpl:[4,1,6,3,7],updat:7,map:3,financ:1,referenc:[5,3],clone:0,after:[3,7],usabl:[1,3],befor:[2,3],ohai_:[2,3],mai:[4,0,6],end:[2,3],data:[4,6,2,7],parallel:[1,7],man:[1,8],github:[0,1],orchestr:[1,3],bootstrap:1,favorit:1,element:[4,2],issu:1,inform:[6,2,3],mango:4,combin:4,allow:3,order:3,talk:[0,3],oper:[1,7],help:1,over:[1,7],move:[2,3],orang:4,mission:1,elit:4,rpmbuild:0,comma:4,paramet:[2,3],facter_:[2,3],jid:7,overlord:0,group:[1,6,3,5],cli:6,yaml:[4,1,3],pend:[3,7],rapidli:6,infrastructur:[0,5,3,1],mail:[1,5],job_statu:7,main:3,might:3,them:[2,3,7],"return":[1,6,2],thei:[6,2,3,7],food:4,contriv:3,scene:2,framework:[1,6],jinja2:[0,2,3,7],now:[0,2],nor:2,choic:1,multiprocess:0,name:[4,1,2,3,7],anyth:2,neccessari:[],config:[1,3],drop:2,datastructur:6,separ:[4,3],exampl:[0,1,2,3,4,5,6,7],each:[4,2,3,7],found:6,stock:2,mean:[2,3],harm:3,michael:1,individu:5,idea:1,realli:[4,2,3],backport:0,facter:[1,2,3,7],our:4,happen:[2,3],event:2,out:[1,2,3,4,6,7],variabl:[2,3,7],network:1,space:[1,2],reboot:7,content:[0,1],rel:2,internet:1,print:6,correct:[4,1,3],red:[1,7],painless:1,insid:3,advanc:6,ntp:7,given:[2,7],pub:7,base:[1,3],lab:1,dictionari:4,put:[0,7],org:0,bash:[0,7],basi:3,pyyaml:0,indent:4,could:[6,3],fqdn:7,thing:[1,3],place:1,isn:1,assign:[1,3],first:[7,0,2,3,1],origin:1,softwar:[1,2,7],rang:1,notifi:[1,3,7],directli:[2,3,7],onc:[2,3],number:2,yourself:0,hook:2,instruct:0,alreadi:[0,2,3],puppet:1,construct:6,extend:1,massiv:1,differ:[7,0,3,1],convent:2,script:[1,6,7],associ:4,top:[2,3],mkdir:3,system:[0,1,2,3,5,7],messag:6,inventori:[0,5,2,3,1],too:1,statement:[1,3],john:4,"final":4,iptabl:3,shell:[1,2,7],option:[4,6,3,8,7],tool:[1,6,2,7],copi:[1,2,7],specifi:[4,2,7],retyp:0,sha:2,"short":1,kept:3,than:[0,2,3,7],silli:3,target:[1,5],remot:[0,2,3,7],structur:4,banana:4,project:[0,7,1],reus:3,architect:1,were:3,tion:[],uses_cv:4,pre:0,sai:3,runner:6,explicit:2,ani:[1,6,2,3,7],have:[0,3,1],need:[4,0,2,3,7],seek:2,paramiko:0,imagin:3,engin:7,built:0,note:[5,2,3,7],also:[0,1,2,3,4,5,6,7],client:1,build:[0,6],indic:2,datacent:3,divers:1,begin:4,unless:2,distribut:[0,1],deploy:[1,3,7],track:7,discov:3,most:[4,2],plai:[2,3],regular:3,deploi:[1,2,3,7],pair:2,why:1,don:2,doc:1,later:7,cover:7,doe:[1,2,5],likes_emac:4,snapshot:2,wildcard:5,databas:3,awesom:[1,3],show:[3,7],verbos:2,syntax:[4,3],bring:3,raleigh:1,particularli:3,playbook:[0,1,2,3,4,5,6,7],hack:1,radic:1,trivial:[1,2],rotat:3,involv:1,absolut:2,onli:[0,2,3,7],explicitli:3,locat:2,just:[7,0,2,3,1],pretti:6,configur:[0,1,3,4,5,7],apach:[3,7],behind:2,should:[4,2],somevar:3,freenod:1,local:2,yml:3,long_running_oper:7,contribut:1,get:[4,0,3,7,1],express:[4,1,6,3],stop:[2,3],repo:[2,7],next:3,obviou:1,ssh:[0,7],requir:[0,2,1],uvh:0,bar:5,provid:4,stuff:7,common:3,contain:[2,3],through:[0,2,1],where:[1,2,3],view:[1,8],set:[0,2,3],see:[0,1,2,3,4,5,7],result:[6,2],fail:[6,3],charact:4,ntp_server:7,best:3,planet:1,statu:7,manpag:[0,8],pattern:[1,6,3,5],someth:[1,2,7],discoveri:2,restart:[2,3,7],state:[2,3,7],won:7,between:[4,3],"import":6,irc:1,altern:7,kei:[4,0,2,3],style:2,extens:1,job:[4,7],entir:3,aserv:0,webapp:7,asdescrib:[],timmi:3,addit:[4,1,3],delimit:2,goal:1,against:[1,3,5],etc:[7,0,5,3,1],instanc:3,logic:3,mani:[3,7],com:[0,6,3,5],assur:3,simpli:[2,3],author:1,overview:4,header:5,written:[1,2,3,7],colon:3,shutdown:2,linux:[1,3],poll:[1,3,7],rpm:[0,1],three:5,multiplay:1,compos:3,been:1,json:[1,6,2],much:[1,2],basic:[4,0,5,2,1],quickli:[4,1],indenta:[],fire:1,rubi:[4,2,7],argument:2,func:1,atlanta:[3,7],those:[4,2],emploi:4,authorized_kei:0,multi:[1,3],look:[5,3,7],replac:3,hoc:[1,3,7],servic:[1,2,3,7],md5sum:2,defin:3,"while":3,facter_hostnam:3,cobbler:1,dehaan:1,motd:[3,7],max_client:3,stdout:6,non:1,itself:6,myapp:7,module_nam:6,sever:4,http_port:3,develop:[4,0,1],welcom:1,minim:0,make:[0,2,3,7],ohai:[1,2,3,7],same:[4,5,7],member:4,python:[0,1,2,4,6,7],complex:[1,3],success:2,document:[0,6,3,7],ansibl:[0,1,2,3,4,5,6,7,8],complet:[0,3],http:2,hostnam:[6,3],again:3,nest:2,permit:4,effect:3,fruit:4,user:3,php:7,distutil:[0,1],typic:7,squar:4,task:[1,3,7],off:1,scenario:2,mention:3,setenforc:3,well:[0,2,3],hypothet:3,contact:[0,6,2],command:[0,1,2,3,5,6,7,8],thi:[0,1,2,3,4,5,7],choos:2,programm:6,dereferenc:3,usual:3,protocol:2,execut:[1,6,2,3],less:[0,1],excel:1,kill:7,skill:4,simultan:7,languag:[4,0,5,2,1],web:[6,7],versu:1,easi:[1,2],mix:5,trigger:2,except:3,littl:1,add:[0,7],els:1,unlik:3,hat:1,match:3,take:2,bin:[0,6,2,3,7],applic:[6,3],which:[4,0,5,3,1],format:[0,1,2,3,4,5,7],read:[4,0,6],fast:1,dark:6,game:1,know:[4,2,3],background:[1,7],world:0,bit:2,password:0,daemon:1,motorola:1,like:[4,5,2,3,7],specif:[5,6,3,7],signal:3,integ:2,noth:3,edit:0,api:[1,6,2],necessari:[2,7],either:2,lose:7,popular:1,output:3,page:[4,0,8,1],webserv:[5,3,7],some:[0,2],back:3,dead:1,server:[1,2,3,7],tmp:[3,7],render:2,assum:3,avoid:[0,2],though:[1,2],definit:3,per:6,tracker:1,exit:6,foo:[5,7],complic:1,refer:7,machin:[0,2,3,7],core:1,run:[0,6,2,3,7],power:[1,6],usag:[2,7],devop:1,web2:6,host:[0,1,2,3,5,6,7],web1:6,repositori:0,"super":1,simpler:7,src:[2,3,7],sbin:[2,3,7],actual:2,othervar:3,surround:4,unnecessari:2,srv:[3,7],done:3,industri:1,own:[1,2,3],real:0,bounc:2,within:2,tag:[0,2],automat:2,upgrad:7,down:6,ensur:[3,7],chang:[2,3,7],perl:7,bserver:0,your:[0,1,2,3,4,5,7],manag:[0,1,3,4,5,7],git:[0,2,7,1],type:6,fabric:1,wai:[4,0,3,7],transfer:[1,7],support:[2,7],question:1,"long":[1,2,7],happi:1,avail:[0,2,3,6,7,8],start:[0,1,2,3,4,7],appl:4,wordpress:3,includ:[1,3],lot:[1,3,7],suit:3,"var":[1,3],fork:6,head:[2,7],simplejson:0,lint:4,yeah:3,taken:3,line:[0,1,2,3,4,5,6,7,8],"true":[4,2,3],congratul:0,info:3,strawberri:4,made:[2,7],possibl:[5,3,7],whether:6,wish:[4,0,6,5],caller:2,until:0,asynchron:[1,3],record:4,limit:[1,7],rerun:3,otherwis:2,similar:2,chip:1,curv:1,featur:3,tasti:4,creat:1,certain:3,doesn:1,repres:4,exist:[1,3],file:[0,1,2,3,4,5,7],bob:3,ship:2,check:[2,7],bracket:[4,5],echo:0,denot:5,googl:1,dbserver:[5,3],when:[2,3,7],detail:[1,6],"default":[1,5],other:[7,0,2,3,1],futur:0,test:[0,2],you:[0,1,2,3,4,5,7],node:[0,2,7,1],sequenc:1,"class":[1,3],asciidoc:0,push:3,log:3,deferenc:3,"60k":1,sphinx:0,directori:[2,3],portion:5,emerg:1,potenti:3,time:[0,1,2,3,5,7],far:1,hello:0},objtypes:{},titles:["Getting Started","Introducing Ansible","Ansible Modules","Playbooks","YAML Format","The Inventory File, Patterns, and Groups","Using the Python API","Command Line Examples","Man Pages"],objnames:{},filenames:["gettingstarted","index","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],concept:7,myapp:7,perl:7,mcollect:1,prefix:[2,3,7],code:[1,2,7],upgrad:[2,7],follow:[5,6,2,3,7],scp:7,content:[0,1],middl:3,elsewher:7,specif:[5,6,3,7],program:[1,2,3],selinux:3,blindingli:1,spec:3,introduc:1,sourc:[1,6,2,3,7],everi:[4,3],string:2,fals:[4,2],failur:[6,2],veri:[1,6,3],affect:3,max_client:3,level:[4,2,3],id_rsa:[0,7],list:[1,2,3,4,5,7,8],item:[4,6],dotnet:4,saltstack:1,servic:[1,2,3,7],playbook:[0,1,2,3,4,5,6,7],alic:3,natur:2,seper:[],chef:1,second:[4,7],design:1,pass:[2,3],download:0,further:3,port:7,even:7,what:[0,2,3],favcolor:[3,7],section:[1,2,3],abbrevi:4,version:[2,7],varnam:3,ever:1,method:6,told:3,hash:2,facter_hostnam:3,eckersberg:4,gener:3,here:[2,3,7],let:[3,7],address:[5,2],path:2,sinc:7,valu:[4,2,3],box:[1,2],great:1,ahead:3,precursor:1,technolog:1,host:[0,1,2,3,5,6,7],prior:2,pick:[4,7],action:[1,2,3],extrem:0,implement:6,commonli:7,ourselv:3,employe:4,via:[0,1],regardless:[4,1,3],extra:3,modul:[0,1,2,3,6,7],put:[0,7],unix:3,"boolean":4,instal:[7,0,2,3,1],select:[1,2,3,5],httpd:[3,7],from:[0,1,2,3,4,7],describ:[2,3],would:[2,7],commun:1,visit:1,two:[4,0,5],noarch:0,suit:3,live:0,handler:[1,3,7],call:2,usr:[6,2,3,7],msg:[6,2],somevar:3,type:6,tell:[2,3,7],more:[0,5,2,3,1],flat:3,desir:3,idempot:[2,3,7],src:[2,3,7],unneccessari:[],sshd:1,agent:[0,7],particular:[1,3],easiest:1,must:[4,2,3],none:6,join:1,ibm:1,module_arg:6,setup:[1,2,7],work:[7,0,5,3,1],knows_oop:4,remain:1,tag:[0,2],can:[0,1,2,3,4,5,6,7],learn:[0,5,3,1],about:[4,0,2,3,1],purpos:2,root:[4,1,3],control:[1,2,3,7],want:[6,2,3,7],yamllint:4,process:[1,7],rpath:1,sudo:0,share:2,templat:[7,0,2,3,1],critic:1,minimum:3,explor:0,occur:3,contribut:1,alwai:2,multipl:[5,3,7],newlin:4,thoug:[],lame:4,capistrano:1,ping:[0,6,2,1],uptim:6,write:[4,1,2,3,7],how:[0,2,3,4,5,6,7],instead:2,config:[1,3],stock:2,map:3,express:[4,1,6,3],referenc:[5,3],clone:0,after:[3,7],lab:1,befor:[2,3],ohai_:[2,3],mai:[4,0,6],end:[2,3],associ:4,parallel:[1,7],man:[1,8],"short":1,orchestr:[1,3],read:[4,0,6],bootstrap:1,explicit:2,element:[4,2],issu:1,inform:[6,2,3],mango:4,combin:4,allow:3,order:3,talk:[0,3],oper:[1,7],help:1,over:[1,7],move:[2,3],orang:4,mission:1,elit:4,rpmbuild:0,comma:4,paramet:[2,3],facter_:[2,3],jid:7,overlord:0,group:[1,6,3,5],cli:6,yaml:[4,1,3],pend:[3,7],rapidli:6,infrastructur:[0,5,3,1],mail:[1,5],job_statu:7,main:3,might:3,them:[2,3,7],"return":[1,6,2],thei:[6,2,3,7],food:4,scene:2,framework:[1,6],jinja2:[0,2,3,7],now:[0,2],nor:2,choic:1,multiprocess:0,name:[4,1,2,3,7],anyth:2,neccessari:[],simpl:[4,1,6,3,7],drop:2,instruct:0,separ:[4,3],exampl:[0,1,2,3,4,5,6,7],each:[4,2,3,7],found:6,updat:[2,7],mean:[2,3],harm:3,michael:1,individu:5,idea:1,realli:[4,2,3],backport:0,facter:[1,2,3,7],our:4,happen:[2,3],event:2,out:[1,2,3,4,6,7],variabl:[2,3,7],network:1,space:[1,2],reboot:7,bubbl:[2,3],rel:2,internet:1,print:6,correct:[4,1,3],red:[1,7],insid:3,advanc:6,ntp:7,given:[2,7],pub:7,base:[1,3],usabl:[1,3],dictionari:4,releas:0,org:0,bash:[0,7],basi:3,pyyaml:0,indent:4,could:[6,3],fqdn:7,thing:[1,3],place:1,isn:1,assign:[1,3],first:[7,0,2,3,1],origin:1,softwar:[1,2,7],rang:1,notifi:[1,3,7],directli:[2,3,7],onc:[2,3],number:2,yourself:0,hook:2,datastructur:6,alreadi:[0,2,3],puppet:1,construct:6,extend:1,massiv:1,differ:[7,0,3,1],"long":[1,2,7],convent:2,script:[1,6,7],data:[4,6,2,7],top:[2,3],mkdir:3,system:[0,1,2,3,5,7],messag:6,appl:4,too:1,statement:[1,3],john:4,banana:4,iptabl:3,shell:[1,2,7],option:[4,6,3,8,7],welcom:1,tool:[1,6,2,7],copi:[1,2,7],specifi:[4,2,7],retyp:0,provid:4,github:[0,1],off:1,than:[0,2,3,7],liter:2,silli:3,target:[1,5],remot:[0,2,3,7],remov:2,structur:4,"final":4,project:[0,7,1],reus:3,architect:1,were:3,tion:[],uses_cv:4,pre:0,sai:3,runner:6,favorit:1,ani:[1,6,2,3,7],packag:2,have:[0,3,1],need:[4,0,2,3,7],seek:2,paramiko:0,imagin:3,engin:7,built:0,note:[5,2,3,7],also:[0,1,2,3,4,5,6,7],client:1,build:[0,6],indic:2,datacent:3,divers:1,begin:4,unless:2,distribut:[0,1],deploy:[1,3,7],track:7,discov:3,most:[4,2],plai:[2,3],regular:3,deploi:[1,2,3,7],pair:2,why:1,don:2,doc:1,later:7,cover:7,doe:[1,2,5],likes_emac:4,snapshot:2,yum:[1,2],wildcard:5,pattern:[1,6,3,5],awesom:[1,3],show:[3,7],verbos:2,syntax:[4,3],bring:3,raleigh:1,particularli:3,pkg:2,hack:1,radic:1,trivial:[1,2],rotat:3,involv:1,absolut:2,onli:[0,2,3,7],explicitli:3,locat:2,execut:[1,6,2,3],pretti:6,configur:[0,1,2,3,4,5,7],apach:[3,7],state:[2,3,7],should:[4,2],suppos:3,congratul:0,local:2,yml:3,long_running_oper:7,nearli:[2,3],variou:2,get:[4,0,3,7,1],financ:1,stop:[2,3],repo:[2,7],obviou:1,ssh:[0,7],requir:[0,2,1],uvh:0,bar:5,sha:2,stuff:7,common:3,contain:[2,3],through:[0,2,1],where:[1,2,3],view:[1,8],set:[0,2,3],see:[0,1,2,3,4,5,7],result:[6,2],fail:[6,3],charact:4,skill:4,best:3,asynchron:[1,3],statu:7,kei:[4,0,2,3],databas:3,someth:[1,2,7],discoveri:2,restart:[2,3,7],behind:2,won:7,between:[4,3],"import":6,irc:1,attribut:2,altern:7,manpag:[0,8],style:2,extens:1,job:[4,7],entir:3,aserv:0,webapp:7,asdescrib:[],timmi:3,addit:[4,1,3],delimit:2,goal:1,against:[1,3,5],etc:[7,0,5,3,1],instanc:3,logic:3,mani:[3,7],com:[0,6,3,5],assur:3,simpli:[2,3],overview:4,header:5,written:[1,2,3,7],colon:3,shutdown:2,linux:[1,3],poll:[1,3,7],rpm:[0,1],multiplay:1,compos:3,been:1,json:[1,6,2],much:[1,2],far:1,basic:[4,0,5,2,1],quickli:[4,1],indenta:[],wish:[4,0,6,5],fire:1,rubi:[4,2,7],argument:2,func:1,minim:0,atlanta:[3,7],those:[4,2],emploi:4,authorized_kei:0,multi:[1,3],look:[5,3,7],hoc:[1,3,7],straight:7,md5sum:2,permit:4,defin:3,"while":3,abov:3,exist:[1,3],dehaan:1,motd:[3,7],tar:0,stdout:6,non:1,itself:6,conf:[3,7],module_nam:6,sever:4,http_port:3,develop:[4,0,1],inventori:[0,5,2,3,1],author:1,make:[0,2,3,7],format:[0,1,2,3,4,5,7],same:[4,5,7],member:4,python:[0,1,2,4,6,7],complex:[1,3],document:[0,6,3,7],ansibl:[0,1,2,3,4,5,6,7,8],complet:[0,3],http:2,hostnam:[6,3],denot:5,nest:2,painless:1,effect:3,fruit:4,user:3,php:7,distutil:[0,1],typic:7,squar:4,task:[1,3,7],kept:3,scenario:2,mention:3,setenforc:3,well:[0,2,3],hypothet:3,contact:[0,6,2],command:[0,1,2,3,5,6,7,8],thi:[0,1,2,3,4,5,7],choos:2,programm:6,dereferenc:3,usual:3,protocol:2,just:[7,0,2,3,1],less:[0,1],when:[2,3,7],kill:7,ntp_server:7,simultan:7,languag:[4,0,5,2,1],web:[6,7],versu:1,easi:[1,2],mix:5,except:3,littl:1,add:[0,7],other:[7,0,2,3,1],simplejson:0,els:1,unlik:3,hat:1,match:3,take:2,bin:[0,6,2,3,7],applic:[6,3],which:[4,0,5,3,1],ohai:[1,2,3,7],dest:[2,3,7],dark:6,game:1,know:[4,2,3],background:[1,7],world:0,bit:2,password:0,daemon:1,motorola:1,like:[4,5,2,3,7],success:2,signal:3,integ:2,noth:3,edit:0,api:[1,6,2],necessari:[2,7],either:2,lose:7,popular:1,output:3,page:[4,0,8,1],webserv:[5,3,7],suppli:2,some:[0,2],back:3,dead:1,server:[1,2,3,7],tmp:[3,7],render:2,assum:3,avoid:[0,2],though:[1,2],definit:3,per:6,tracker:1,exit:6,foo:[5,7],complic:1,refer:7,machin:[0,2,3,7],core:1,run:[0,6,2,3,7],power:[1,6],usag:[2,7],asciidoc:0,web2:6,step:[2,3],web1:6,repositori:0,"super":1,simpler:7,comparison:1,sbin:[2,3,7],actual:2,othervar:3,surround:4,unnecessari:2,srv:[3,7],done:3,industri:1,own:[1,2,3],real:0,bounc:2,within:2,contriv:3,automat:2,three:5,down:6,ensur:[3,7],chang:[2,3,7],next:3,bserver:0,your:[0,1,2,3,4,5,7],manag:[0,1,2,3,4,5,7],git:[0,2,7,1],fabric:1,wai:[4,0,3,7],transfer:[1,7],support:[2,7],question:1,fast:1,happi:1,avail:[0,2,3,6,7,8],start:[0,1,2,3,4,7],trigger:2,wordpress:3,includ:[1,2,3],lot:[1,3,7],replac:3,"var":[1,3],fork:6,head:[2,7],form:[4,3],lint:4,yeah:3,taken:3,line:[0,1,2,3,4,5,6,7,8],"true":[4,2,3],freenod:1,info:3,strawberri:4,made:[2,7],possibl:[5,3,7],whether:6,checkout:2,caller:2,until:0,planet:1,record:4,limit:[1,7],rerun:3,otherwis:2,similar:2,chip:1,curv:1,featur:3,tasti:4,creat:1,certain:3,doesn:1,repres:4,cobbler:1,file:[0,1,2,3,4,5,7],bob:3,ship:2,check:[2,7],echo:0,again:3,googl:1,dbserver:[5,3],excel:1,detail:[1,6],"default":[1,5],bracket:[4,5],futur:0,test:[0,2],you:[0,1,2,3,4,5,7],node:[0,2,7,1],sequenc:1,"class":[1,3],devop:1,log:3,deferenc:3,"60k":1,sphinx:0,directori:[2,3],portion:5,emerg:1,potenti:3,time:[0,1,2,3,5,7],push:3,hello:0},objtypes:{},titles:["Getting Started","Introducing Ansible","Ansible Modules","Playbooks","YAML Format","The Inventory File, Patterns, and Groups","Using the Python API","Command Line Examples","Man Pages"],objnames:{},filenames:["gettingstarted","index","modules","playbooks","YAMLScripts","patterns","api","examples","man"]}) \ No newline at end of file diff --git a/rst/modules.rst b/rst/modules.rst index a8832ac25ef..70de65ca441 100644 --- a/rst/modules.rst +++ b/rst/modules.rst @@ -173,7 +173,7 @@ template ```````` Templates a file out to a remote server. Call the :ref:`setup` module -prior to usage. +prior to usage if you are not running from a playbook. *src*: @@ -187,6 +187,26 @@ prior to usage. This module also returns md5sum information about the resultant file. +.. _yum: + +yum +``` + +Will install, upgrade, remove, and list packages with the yum package manager. + +*pkg*: + +* A package name or package specifier with version, like name-1.0 + +*state*: + +* Can be either 'installed' or 'removed' + +*list*: + +* When 'list' is supplied instead of 'state', the yum module can list + various configuration attributes. Values include 'installed', 'updates', + 'available', 'repos', or any package specifier. Writing your own modules ````````````````````````