https://github.com/magmax/puppet-inception

Structure to start a puppet to manage your home or enterprise hosts
https://github.com/magmax/puppet-inception

Last synced: 13 days ago
JSON representation

Structure to start a puppet to manage your home or enterprise hosts

• Host: GitHub
• URL: https://github.com/magmax/puppet-inception
• Owner: magmax
• Created: 2014-09-27T11:40:13.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2014-10-05T14:36:09.000Z (about 10 years ago)
• Last Synced: 2024-10-11T14:34:58.577Z (about 1 month ago)
• Language: Shell
• Size: 242 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
**WARNING**: Under development, but it is already usable. Structure may change, but it should be quite easy to addapt it to the new one.

# Puppet quick start project

The idea is to start using [Puppet] in 2 minutes.

## Quick start

1. Download this repository

1. Run `./inception.sh`

Boom! That's it.

## After the quick start

1. Edit the `Puppetfile` file to add those modules you want to download.

1. The `inception.sh` script should have created the file `data/[HOSTNAME].yaml`. Edit it to add more packages to your host or configure them.

1. Run `./inception.sh` again

1. Repeat this recipe as many times you want.

From now on, you should be able to manage everything just editing [yaml] files.

Optionally, you can group several classes into profiles and just use the profiles in your node. This practice is highly recommended. Some examples are provided.

### Where can I find puppet modules to be added into Puppetfile?

The easiest way to find them is by using `puppet module search`. I hightly recommend to use those in the [Example42 project], but you can add yor own ones.

## Options

- `-a ` Passes PUPPET_OPTIONS to `puppet apply`

- `-h` Shows the help

- `-s` Skips the installations. Useful when you already have puppet and librarian installed.

- `-p ` Selects the path to puppet files (the place where puppet-inception will deploy its files)

The most important puppet options to be used with `-a` are:

- `-v`: Verbose mode

- `--noop`: Do not apply puppet (be careful, because `apt` and `gem` will apply their changes)

## Project status

[![Build Status](https://travis-ci.org/magmax/puppet-inception.svg)](https://travis-ci.org/magmax/puppet-inception)

### Changelog

- Profiles included, based on [Craig Dunn presentation].

[yaml]: http://www.yaml.org/

[Puppet]: http://puppetlabs.com/

[Craig Dunn presentation]: http://puppetlabs.com/presentations/designing-puppet-rolesprofiles-pattern

[Example42 project]: https://github.com/example42