forked from ungleich-public/cdist
		
	begin section about the initial manifest
Signed-off-by: Nico Schottelius <nico@brief.schottelius.org>
This commit is contained in:
		
					parent
					
						
							
								46b23c507b
							
						
					
				
			
			
				commit
				
					
						f9d6ce349d
					
				
			
		
					 1 changed files with 15 additions and 79 deletions
				
			
		| 
						 | 
					@ -98,40 +98,20 @@ cdist, which are usually underline prefixed (__).
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					DEFINE STATE IN THE INITIAL MANIFEST
 | 
				
			||||||
 | 
					------------------------------------
 | 
				
			||||||
 | 
					The **initial manifest** is the entry point for cdist to find out, which
 | 
				
			||||||
 | 
					**objects** to configure on the selected host. Objects are instances of
 | 
				
			||||||
 | 
					**types**, like in object orientated programming. An object is represented
 | 
				
			||||||
 | 
					by the type + slash + object name: ***__file/etc/cdist-configured*** is an
 | 
				
			||||||
 | 
					object of the type ***__file*** with the name ***etc/cdist-configured***.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
PREPARING YOUR MACHINE / SETUP
 | 
					Cdist searches for the initial manifest at **conf/manifest/init** and
 | 
				
			||||||
------------------------------
 | 
					executes it as a shell script using **/bin/sh -e**.
 | 
				
			||||||
Before you actually
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- ensure sshd is running on the target host:
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
ssh target_host
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- ensure you can login as root
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
ssh root@target host
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- ensure login as root works without keys
 | 
					 | 
				
			||||||
(see ssh... manpage)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
cdist will do a lot of requests to the target
 | 
					 | 
				
			||||||
host, thus you'll have to enter your password
 | 
					 | 
				
			||||||
many times, if you don't do this :-)
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
- speedup processing with ControlMaster option of
 | 
					 | 
				
			||||||
ssh
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
YOUR FIRST CONFIGURATION
 | 
					 | 
				
			||||||
------------------------
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
DEFINE STATE IN THE INITAL MANIFEST
 | 
					 | 
				
			||||||
-----------------------------------
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
The initial manifest is used to map
 | 
					 | 
				
			||||||
configurations to a host.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
USING SOME BASIC TYPES
 | 
					USING SOME BASIC TYPES
 | 
				
			||||||
----------------------
 | 
					----------------------
 | 
				
			||||||
what is a type, how to use it,
 | 
					what is a type, how to use it,
 | 
				
			||||||
| 
						 | 
					@ -162,58 +142,14 @@ __debug::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					BRANCHES IN HERE?
 | 
				
			||||||
 | 
					------------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					TUNING CDIST
 | 
				
			||||||
 | 
					------------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- speedup processing with ControlMaster option of
 | 
				
			||||||
 | 
					ssh
 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
SEE ALSO
 | 
					SEE ALSO
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue