aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMicah Anderson <micah@riseup.net>2008-09-29 14:33:41 -0400
committerMicah Anderson <micah@riseup.net>2008-09-29 14:33:41 -0400
commitdd8e529538558cc24cdaba7514a1b2e75f464fa0 (patch)
tree9582b8600c0cd2e3513c60a4756f4f783e2df5a6
parent377e095431afc89b6e3bb4cc9abd2d1508a042b0 (diff)
downloadpuppet-apt-dd8e529538558cc24cdaba7514a1b2e75f464fa0.tar.gz
puppet-apt-dd8e529538558cc24cdaba7514a1b2e75f464fa0.tar.bz2
reformat the README to be easier on the eyes
add more detailed information for $custom_sources_list with an example add information about $custom_preferences with an example add information about $custom_key_dir add information about the apt::preseeded_package resource add information about the apt::upgrade_package resource
-rw-r--r--README113
1 files changed, 88 insertions, 25 deletions
diff --git a/README b/README
index fcf2777..c6e6c4e 100644
--- a/README
+++ b/README
@@ -19,24 +19,55 @@ This module needs lsb-release installed.
Variables
=========
-$apt_clean: Sets DSelect::Clean, defaults to 'auto' on normal hosts and
- 'pre-auto' in vservers, since the latter are usually more space-bound and
- have better recovery mechanisms via the host
- From apt.conf(5), 0.7.2: "Cache Clean mode; this value may be one of
- always, prompt, auto, pre-auto and never. always and prompt will
- remove all packages from the cache after upgrading, prompt (the
- default) does so conditionally. auto removes only those
- packages which are no longer downloadable (replaced with a new
- version for instance). pre-auto performs this action before
- downloading new packages."
-
-
-$lsbdistcodename: Contains the codename ("etch", "lenny", ...) of the client's
- release. While these values come from lsb-release by default, this value
- can be set manually too, e.g. to enable forced upgrades
-
-$custom_sources_list: If non-empty, the contents of this variable are used as
- new sources.list for the node.
+$apt_clean
+----------
+Sets DSelect::Clean, defaults to 'auto' on normal hosts and 'pre-auto'
+in vservers, since the latter are usually more space-bound and have
+better recovery mechanisms via the host:
+
+From apt.conf(5), 0.7.2:
+ "Cache Clean mode; this value may be one of always, prompt, auto,
+ pre-auto and never. always and prompt will remove all packages
+ from the cache after upgrading, prompt (the default) does so
+ conditionally. auto removes only those packages which are no
+ longer downloadable (replaced with a new version for
+ instance). pre-auto performs this action before downloading new
+ packages."
+
+
+$lsbdistcodename
+----------------
+Contains the codename ("etch", "lenny", ...) of the client's
+release. While these values come from lsb-release by default, this
+value can be set manually too, e.g. to enable forced upgrades
+
+$custom_sources_list
+--------------------
+By default this module will use a basic apt/sources.list with a
+generic debian mirror. If you need to set more specific sources,
+e.g. for country proximity, proxies, etc. you can set this variable to
+the location of your sources.list template. For example, setting the
+following variable before including this class will pull in the
+templates/apt/sources.list file:
+$custom_sources_list ='template("apt/sources.list")'
+
+$custom_preferences
+--------------------
+By default this module will use a basic apt/preferences file with
+unstable and testing pinned to very low values so that any package
+installation will not accidentally pull in packages from those suites
+unless you explicitly specify the version number. You can set this
+variable to pull in a customized apt/preferences template, for
+example, setting the following variable before including this class
+will pull in the templates/apt/preferences file:
+$custom_preferences = 'template("apt/preferences")'
+
+$custom_key_dir
+---------------
+If you have different apt-key files that you want to get added to your
+apt keyring, you can set this variable to a path in your fileserver
+where individual key files can be placed. If this is set and keys
+exist there, this module will apt-key add each key
Classes
=======
@@ -48,13 +79,45 @@ functionality.
Resources
=========
-File[apt_config]: Use this resource to depend on or add to a completed apt
- configuration
-
-Exec[apt_updated]: After this point, current packages can installed via apt,
- usually used like this:
- Package { require => Exec[apt_updated] }
-
+File[apt_config]
+----------------
+Use this resource to depend on or add to a completed apt configuration
+
+Exec[apt_updated]
+-----------------
+After this point, current packages can installed via apt, usually used
+like this:
+
+Package { require => Exec[apt_updated] }
+
+apt::preseeded_package
+----------------------
+This simplifies installation of packages that you wish to preseed the
+answers to debconf. For example, if you wish to provide a preseed file
+for the locales package, you would place the locales.seed file in
+templates/$debian_version/locales.seeds and then include the following
+in your manifest:
+
+apt::preseeded_package { locales: }
+
+apt::upgrade_package
+--------------------
+This simplifies upgrades for DSA security announcements or point-releases. This
+will ensure that the named package is upgrade to the version specified, only if the
+package is installed, otherwise nothing happens. If the specified version is 'latest' (the
+default), then the package is ensured to be upgraded to the latest package revision when
+it becomes available.
+
+For example, the following upgrades the perl package to version 5.8.8-7etch1 (if it is
+installed), it also upgrades the syslog-ng and perl-modules packages to their latest (also,
+only if they are installed):
+
+upgrade_package { "perl":
+ version => '5.8.8-7etch1';
+ "syslog-ng":
+ version => latest;
+ "perl-modules":
+}
TODO
====