This section contains reference documentation on all the topics available from the global-config repository. Each topic's documentation contains an overview of the configuration it ships with and a list of the puppet classes it declares. To enable a given configuration topic on an instance, just add it to this instance's metadata parameter (this parameter is a space delimited list of topics).

base

This topic loads most of Autostrap's puppet-base module (the key handling logic of the ssh topic are part of puppet-base but not loaded by the base topic. puppet-base handles basic system configuration. This includes among other things:

• Setting a root password

• Setting various sysctls to sensible values

• apt(8) configuration

• Installing a few useful packages

• Sane bash, vim and screen settings

Declared Classes

base::role::common	Declares most profiles from puppet-base. It does 'not' load base::role::sshkeys, for instance (that is declared in the ssh).

nginx-static

This topic sets up a nginx web server that responds to your instance's floating IP address and serves the static files it finds in /usr/share/nginx/html. It is meant for very simple setups, i.e. if you want to do anything beyond serving a bunch of static files through unencrypted HTTP do not use this topic.

Declared Classes

nginx	Configures nginx.

puppet-agent

This topic configures a puppet agent. It is part of our standard puppet setup process for stacks of two or more instances. If you have a puppet master that is not named puppetmaster.local, you will need to set the puppetmaster meta data entry to its host name on all instances you deploy this topic to.

Declared Classes

autopuppet::role::agent	Configures a puppet agent.

puppet-master

This topic configures a puppet master. It is part of our standard puppet setup process for stacks consisting of two or more instances. Only configure it on the instance you want to be the puppet master.

Declared Classes

autopuppet::role::puppetmaster	Configures a puppet master.

puppet-masterless

This topic configures a masterless puppet setup. This is our standard puppet setup for stacks consisting of just one instance.

Declared Classes

autopuppet::role::masterless	Configures masterless (local) puppet.

ssh

This topic configures an instance's ssh daemon in a secure manner and deploys SSH public keys from several Hiera hashes to the root user's authorized_keys file (see our key deployment HOWTO for details on configuring authorized keys).

Declared Classes

ssh	Our puppet module for ssh configuration.
'base::role::sshkeys`	Deploys authorized keys.