From 7d54e796542c7c0ae16c56de98dc856ad4a7000d Mon Sep 17 00:00:00 2001 From: Nico Schottelius Date: Sat, 2 Apr 2011 01:58:02 +0200 Subject: [PATCH] cdist update --- software/cdist/man/cdist-best-practice.html | 32 +++++++++++++++++-- software/cdist/man/cdist-reference.html | 2 +- .../cdist-type__debconf_set_selections.html | 15 +++++++++ .../cdist/man/cdist-type__package_apt.html | 9 +----- 4 files changed, 46 insertions(+), 12 deletions(-) create mode 100644 software/cdist/man/cdist-type__debconf_set_selections.html diff --git a/software/cdist/man/cdist-best-practice.html b/software/cdist/man/cdist-best-practice.html index a82d10fd..478e4566 100644 --- a/software/cdist/man/cdist-best-practice.html +++ b/software/cdist/man/cdist-best-practice.html @@ -1,6 +1,6 @@ -cdist-best-practice(7)

cdist-best-practice(7)

Nico Schottelius

Table of Contents

1. NAME
2. PASSWORDLESS CONNECTIONS
3. SPEEDING UP SSH CONNECTIONS
4. MULTI MASTER OR ENVIRONMENT SETUPS
5. SEE ALSO
6. COPYING

1. NAME

cdist-best-practice - Practices used in real environments

2. PASSWORDLESS CONNECTIONS

It is recommended to run cdist with public key authentication. +cdist-best-practice(7)

cdist-best-practice(7)

Table of Contents

1. NAME
2. PASSWORDLESS CONNECTIONS
3. SPEEDING UP SSH CONNECTIONS
4. MULTI MASTER OR ENVIRONMENT SETUPS
5. SEPERATING WORK BY GROUPS
6. MAINTAINING MULTIPLE CONFIGURATIONS
7. SEE ALSO
8. COPYING

1. NAME

cdist-best-practice - Practices used in real environments

2. PASSWORDLESS CONNECTIONS

It is recommended to run cdist with public key authentication. This requires a private/public key pair and the entry "PermitRootLogin without-password" in the sshd server. See sshd_config(5) and ssh-keygen(1).

3. SPEEDING UP SSH CONNECTIONS

When connecting to a new host, the initial delay with ssh connections @@ -25,7 +25,33 @@ git branch production # Make use of a branch, for instance production git checkout production

Similar if you want to have cdist checked out at multiple machines, you can clone it multiple times:

machine-a % git clone git://your-git-server/cdist
-machine-b % git clone git://your-git-server/cdist

5. SEE ALSO

  • +machine-b % git clone git://your-git-server/cdist

5. SEPERATING WORK BY GROUPS

If you are working with different groups on one cdist-configuration, +you can delegate to other manifests and have the groups edit only +their manifests. You can use the following snippet in +conf/manifests/init:

# Include other groups
+sh -e "$__manifest/systems"
+
+sh -e "$__manifest/cbrg"

6. MAINTAINING MULTIPLE CONFIGURATIONS

When you need to manage multiple sites with cdist, like company_a, company_b +and private for instance, you can easily use git for this purpose. +Including a possible common base that is reused accross the different sites:

# create branches
+git branch company_a company_b common private
+
+# make stuff for company a
+git checkout company_a
+# work, commit, etc.
+
+# make stuff for company b
+git checkout company_b
+# work, commit, etc.
+
+# make stuff relevant for all sites
+git checkout common
+# work, commit, etc.
+
+# change to private and include latest common stuff
+git checkout private
+git merge common

Have a look at git-remote(1) to adjust the remote configuration, which allows +you to push certain branches to certain remotes.

7. SEE ALSO

  • cdist(7) -

6. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is +

8. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/cdist-reference.html b/software/cdist/man/cdist-reference.html index 4a019f10..ca3964ed 100644 --- a/software/cdist/man/cdist-reference.html +++ b/software/cdist/man/cdist-reference.html @@ -1,6 +1,6 @@ -cdist-reference(7)

cdist-reference(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. PATHS
4. TYPES
5. VARIABLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-reference - Variable, path and type reference for cdist

2. DESCRIPTION

Various scripts which are not in the core need information on how +cdist-reference(7)

cdist-reference(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. PATHS
4. TYPES
5. VARIABLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-reference - Variable, path and type reference for cdist

2. DESCRIPTION

Various scripts which are not in the core need information on how to find information. This manpage summarises the available environment variables, types and paths and clearifies with part may access which variables.

3. PATHS

If not specified otherwise, all paths are relative to the checkout directory.

conf/ diff --git a/software/cdist/man/cdist-type__debconf_set_selections.html b/software/cdist/man/cdist-type__debconf_set_selections.html new file mode 100644 index 00000000..c75a9494 --- /dev/null +++ b/software/cdist/man/cdist-type__debconf_set_selections.html @@ -0,0 +1,15 @@ + + +cdist-type__debconf_set_selections(7)

cdist-type__debconf_set_selections(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. EXAMPLES
5. SEE ALSO
6. COPYING

1. NAME

cdist-type__debconf_set_selections - Setup debconf selections

2. DESCRIPTION

On Debian and alike systems debconf-set-selections(1) can be used +to setup configuration parameters.

3. REQUIRED PARAMETERS

+file +
+ If supplied, use the given filename as input for debconf-set-selections(1) +

4. EXAMPLES

# Setup configuration for nslcd
+__debconf_set_selections nslcd --file /path/to/file
+
+# Setup configuration for nslcd from another type
+__debconf_set_selections nslcd --file "$__type/files/preseed/nslcd"

5. SEE ALSO

  • +cdist-type(7) +

6. COPYING

Copyright (C) 2011 Nico Schottelius. Free use of this software is +granted under the terms of the GNU General Public License version 3 (GPLv3).

diff --git a/software/cdist/man/cdist-type__package_apt.html b/software/cdist/man/cdist-type__package_apt.html index 20b1b86f..fc32ac6f 100644 --- a/software/cdist/man/cdist-type__package_apt.html +++ b/software/cdist/man/cdist-type__package_apt.html @@ -1,6 +1,6 @@ -cdist-type__package_apt(7)

cdist-type__package_apt(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_apt - Manage packages with apt-get

2. DESCRIPTION

apt-get is usually used on Debian and variants (like Ubuntu) to +cdist-type__package_apt(7)

cdist-type__package_apt(7)

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. EXAMPLES
6. SEE ALSO
7. COPYING

1. NAME

cdist-type__package_apt - Manage packages with apt-get

2. DESCRIPTION

apt-get is usually used on Debian and variants (like Ubuntu) to manage packages.

3. REQUIRED PARAMETERS

state
@@ -9,19 +9,12 @@ state name
If supplied, use the name and not the object id as the package name. -
-preseed -
- If supplied, use the given filename as input for debconf-set-selections(1)

5. EXAMPLES

# Ensure zsh in installed
 __package_apt zsh --state installed
 
 # In case you only want *a* webserver, but don't care which one
 __package_apt webserver --state installed --name nginx
 
-# Install package with defaults (from a type)
-__package_apt postfix --state installed --preseed "$__type/files/postfix-seed"
-
 # Remove obsolete package
 __package_apt puppet --state deinstalled

6. SEE ALSO

  • cdist-type(7)