A control repository template
Go to file
Nate McCurdy c69edaddda Reorganize the README and improve the documentation
This commit moves the "where did all the previous code go" section to
the bottom as it's been a while since that change was made. Nowadays,
people new to Control Repositories will find this and won't understand
the reference as they never knew about previous versions.

Now the README starts right away with information on what this project
is and how to use it.

Also cleaned up some of the Markdown syntax to make it easier to read.
2018-02-06 17:35:34 -08:00
data Enable Hiera 5 2017-11-15 09:24:40 -08:00
manifests Provide permalink for filebucket deprecation (#43) 2016-10-26 07:46:56 -07:00
scripts config_version: Show the compiling master's name 2017-07-05 17:09:51 -07:00
site Removed old role 2016-06-14 14:37:43 +10:00
.gitignore Ignore modules pulled from r10k into modules/ 2017-11-27 19:08:54 -05:00
environment.conf Reverting whitespace commit 2017-09-06 16:37:30 -07:00
hiera.yaml Enable Hiera 5 2017-11-15 09:24:40 -08:00
LICENSE Initial commit 2015-08-11 10:07:49 -07:00
Puppetfile point "forge" to new canonical URL, with https 2017-11-27 21:41:11 +01:00
README.md Reorganize the README and improve the documentation 2018-02-06 17:35:34 -08:00

A Puppet Control Repository

What You Get From This control-repo

This is a template control repository that has the minimum amount of scaffolding to make it easy to get started with r10k or Puppet Enterprise's Code Manager.

The important files and items in this template are as follows:

  • Basic example of roles and profiles.
  • An example Puppetfile with various module references.
  • An example Hiera configuration file and data directory with pre-created common.yaml and nodes directory.
    • These match the default hierarchy that ships with PE.
  • An environment.conf that correctly implements:
    • A site directory for roles, profiles, and any custom modules for your organization.
    • A config_version script.
  • An example config_version script that outputs the git commit ID of the code that was used during a Puppet run.

Copy This Repo Into Your Own Git Server

To get started with using the control-repo template in your own environment and git server, we've provided steps for the three most common servers we see: GitLab, BitBucket, and GitHub.

GitLab

  1. Install GitLab.
  2. After GitLab is installed you may sign in with the root user and password 5iveL!fe.
  3. Make a user for yourself.
  4. Make an SSH key to link with your user. Youll want to do this on the machine you intend to edit code from (most likely not your Puppet master, but your local workstation or laptop).
  5. Create a group called puppet (this is case sensitive).
  6. Add your user to the puppet group as well.
  7. Create a project called control-repo, and set the Namespace to be the puppet group.
  8. Clone this control repository to your laptop/workstation:
    • git clone <repository url>
    • cd control-repo
  9. Remove this repository as the origin remote:
    • git remote remove origin
  10. Add your internal repository as the origin remote:
    • git remote add origin <url of your gitlab repository>
  11. Push the production branch of the repository from your machine up to your git server
    • git push origin production

Bitbucket/Stash

  1. Install Bitbucket
  2. Make a Project called puppet (with a short name of PUP)
  3. Create a repository called control-repo
  4. Create a user called r10k with a password of puppet.
    • Make the r10k user an admin of the PUP project.
  5. Either use the admin user to test pushing code, or create a user for yourself and add your SSH key to that user.
    • If making a user for yourself, give your user account read/write or admin privilege to the PUP project.
  6. Clone this control repository to your laptop/workstation
    • git clone <repository url>
    • cd control-repo
  7. Remove this repository as the origin remote
    • git remote remove origin
  8. Add your internal repository as the origin remote
    • git remote add origin <url of your bitbucket repository>
  9. Push the production branch of the repository from your machine up to your git server
    • git push origin production

GitHub

  1. Prepare your local git client to authenticate with GitHub.com or a local GitHub Enterprise instance.
  2. Create a repository called control-repo in your user account or organization. Ensure that "Initialize this repository with a README" is not selected.
  3. Make a note of your repository URL (HTTPS or SSH, depending on your security configuration).
  4. Clone this control repository to your laptop/workstation:
    • git clone <repository url>
    • cd control-repo
  5. Remove this repository as the origin remote:
    • git remote remove origin
  6. Add your internal repository as the origin remote:
    • git remote add origin <url of your github repository>
  7. Push the production branch of the repository from your machine up to your git server
    • git push origin production

Where Did All The Previous Code Go?

Initially, the control-repo project began as a 'starter' template for anyone who wanted to get started with r10k. As time passed and Code Manager was integrated into Puppet Enterprise, the scope of this project grew to include opinionated Puppet profiles to set up many Puppet Enterprise components. As the code increased, so did the complexity of the control-repo project. To reduce that complexity, as well as continuing to meet the needs of individuals who would like a more minimal template, this repository was stripped of anything other than the bare minimum files necessary to get started with a functioning control-repo.

All of the code that was previously in this repository still exists in separate repositories under the Puppet Ramp Up Program namespace within Github and can be re-connected to an existing control-repo if that is required by adding the modules to the Puppetfile. Alternatively, if that previously opinionated control-repo is desired, it still exists on Github under the Puppet Ramp Up Program namespace. This control-repo project will remain a template for anyone who would like a minimal 'starter' template.