From 7ccddecb6b361efcb99f39a74b8d1003e1b319e7 Mon Sep 17 00:00:00 2001 From: Abhishek Sarolia Date: Fri, 28 Jun 2019 07:44:07 +0530 Subject: [PATCH] fix: update puppet guide article after review (#29030) --- guide/english/devops/puppet/index.md | 37 +++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 4 deletions(-) diff --git a/guide/english/devops/puppet/index.md b/guide/english/devops/puppet/index.md index 8982521a9d..56932a167c 100644 --- a/guide/english/devops/puppet/index.md +++ b/guide/english/devops/puppet/index.md @@ -3,14 +3,43 @@ title: Puppet --- ## Puppet -This is a stub. Help our community expand it. +### What is Puppet -This quick style guide will help ensure your pull request gets accepted. +Puppet is a configuration management tool where a developer describes the target state of a number of resources using a declarative language. +In simple words, Puppet is a system for automating system administration tasks. + +Here are a few resources that will help in introduction to Puppet: + + * [Puppet wiki](https://docs.puppet.com/wiki_redirect.html) + * [Introduction to Puppet](https://puppet.com/docs/puppet/6.0/architecture.html) + +### Puppet documentation + * [Complete Puppet reference manual](https://puppet.com/docs/puppet/6.0/puppet_index.html) + * [Language Basics](https://puppet.com/docs/puppet/6.0/lang_summary.html) + * [Resource Type Reference](https://puppet.com/docs/puppet/6.0/type.html) + +### Where to start + + - Play around with Puppet. You might want to use Puppet Training + - Adopt Hiera as early as possible to allow you to write clean code + - Adopt the Roles and Profiles pattern as early as possible + - Once Hiera and the Roles and Profiles pattern have been adopted look into the following: + - Test Driven Development using rspec-puppet + - Deployment through controlled environments with r10k + +### Hiera + +Use Hiera to separate your data / parameter values from your Puppet code + +### eyaml + +When you need to store sensitive data such as password for service accounts, use eyaml as a Hiera back-end. The secrets will become available in your puppet code as facts. + +Have a look at the following article for more information: Encrypt Your Data Using Hiera-Eyaml - #### More Information: - + Official Puppet documentation