├── README.md ├── 000-Introduction.md └── 002-TOC.md /README.md: -------------------------------------------------------------------------------- 1 | # The [DevOps] Guide to Puppet, Universe, and Everything 2 | 3 | This is an holistic documentation project about Puppet. 4 | 5 | It consists on: 6 | 7 | - An Open Source book (developed in this repository) 8 | 9 | - A set of Puppet [architectures](https://github.com/example42/puppetguide-architectures), samples of how to organise your local data and code. 10 | 11 | - A modular set of [Slides](https://github.com/example42/puppetguide-slides) for Workshops and Internal tranings 12 | 13 | 14 | To support this project check our [IndieGogo campaign](https://www.indiegogo.com/campaigns/the-devops-guide-to-puppet-universe-and) 15 | -------------------------------------------------------------------------------- /000-Introduction.md: -------------------------------------------------------------------------------- 1 | # Introduction 2 | 3 | There's a question that everybody keeps on making. 4 | 5 | A question that has no real answer. 6 | 7 | Maybe it has more answers than the people you ask to. 8 | 9 | A question that embodies deeper meanings and wider knowledge. 10 | 11 | A question that nobody really knows how to answer correctly, 12 | but everybody know something about it. 13 | 14 | The answer is not 42, 15 | the question is "What is DevOps?" 16 | 17 | In this book you will not get any answer to such an overwhelming query. 18 | 19 | This is a Puppet book. 20 | 21 | A book about Puppet Universe, possibly about any topic you can think about when dealing with Puppet. 22 | 23 | This *might* be a book around [DevOps] practices, 24 | or it might not be. 25 | 26 | Such as dead and alive cats: It depends on the observer. 27 | 28 | Or maybe the authors. 29 | 30 | Worst of all, this book will try to be funny, 31 | 32 | sometimes, 33 | 34 | and it will fail. 35 | 36 | Bear with us, it's the price we ask for your deeper Puppet awareness. 37 | -------------------------------------------------------------------------------- /002-TOC.md: -------------------------------------------------------------------------------- 1 | # Table of Contents (WIP) 2 | 3 | Contents based on Puppet 4 with references to earlier compatibility 4 | 5 | ## First steps in Puppet land 6 | Introduction to Puppet concepts in a smooth and progressive way (needed for absolute beginners to grasp the following, much more "robust" parts). 7 | 8 | - Introduction to Puppet and Configuration Management 9 | - From Zero to Results 10 | - Language basics 11 | - Next steps in Puppet world 12 | 13 | ## Paths to Puppet Awareness 14 | Getting deeper into Puppet language, ecosystem and components: advanced language, Hiera, PuppetDB... 15 | A wide and complete topics coverage with focus on practical needs. 16 | 17 | - Deeper in Puppet DSL 18 | - Facter 19 | - Hiera 20 | - PuppetDB 21 | 22 | ## A world of Modules 23 | How to find and use modules. How write them. 24 | Usage patterns for the most common public modules and for local ones. 25 | 26 | - Using and writing modules 27 | - Modules reusability practices 28 | - Exploring a world of modules 29 | 30 | 31 | ## Puppet architectures 32 | How to put things together: nodes classifications, code organization, data layout, files and secrets management. 33 | 34 | - Components of a Puppet architecture 35 | - Designing and scaling Puppet infrastructures 36 | - Pulling things together 37 | - Integrations with other tools 38 | 39 | 40 | ## Puppet deployment workflows 41 | How to manage Puppet code workflow, from code writing to deployment: testing, rollouts, migration patterns. 42 | 43 | - Writing and testing Puppet code 44 | - Deployment workflows 45 | - Migrating Puppet environments 46 | 47 | ## Software defined infrastructures 48 | Getting beyond systems management: how to use Puppet in the cloud, how to manage network and storage devices, 49 | 50 | - Software defined infrastructures 51 | - Cloud interactions 52 | 53 | ## Puppet Internals 54 | The gory details under the hood. How to extend Puppet code. 55 | 56 | - An orientation guide to the Internals 57 | - Extending Puppet DSL 58 | - [Developers Posts] 59 | 60 | 61 | ## APPENDIX: The Puppet Universal Reference 62 | An handy and practical reference with practical info about Puppet universe. The stuff that matter and the links for details. 63 | 64 | - Puppet reference: usage, configuration, language, types, variables, modules, functions. 65 | - Hiera reference: usage, configuration, plugins 66 | - PuppetDB reference: configuration, querying, 67 | - PuppetServer reference: configuration 68 | --------------------------------------------------------------------------------