Table of Contents for
Learning Puppet 4

Version ebook / Retour

Cover image for bash Cookbook, 2nd Edition Learning Puppet 4 by Jo Rhett Published by O'Reilly Media, Inc., 2016
  1. Cover
  2. nav
  3. Learning Puppet 4
  4. Learning Puppet 4
  5. Foreword
  6. Preface
  7. Introduction
  8. I. Controlling with Puppet Apply
  9. 1. Thinking Declarative
  10. 2. Creating a Learning Environment
  11. 3. Installing Puppet
  12. 4. Writing Manifests
  13. 5. Using the Puppet Configuration Language
  14. 6. Controlling Resource Processing
  15. 7. Expressing Relationships
  16. 8. Upgrading from Puppet 3
  17. 9. Wrap-Up of Puppet Basics
  18. II. Creating Puppet Modules
  19. 10. Creating a Test Environment
  20. 11. Separating Data from Code
  21. 12. Using Modules
  22. 13. Designing a Custom Module
  23. 14. Improving the Module
  24. 15. Extending Modules with Plugins
  25. 16. Documenting Modules
  26. 17. Testing Modules
  27. 18. Publishing Modules
  28. III. Using a Puppet Server
  29. 19. Preparing for a Puppet Server
  30. 20. Creating a Puppet Master
  31. 21. Creating a Puppet Server
  32. 22. Connecting a Node
  33. 23. Migrating an Existing Puppet Master
  34. 24. Utilizing Advantages of a Puppet Server
  35. 25. Managing TLS Certificates
  36. 26. Growing Your Puppet Deployment
  37. IV. Integrating Puppet
  38. 27. Tracking Puppet Status with Dashboards
  39. 28. Running the Puppet Agent on Windows
  40. 29. Customizing Environments
  41. 30. Controlling Puppet with MCollective
  42. 31. Managing Network Infrastructure with Puppet
  43. 32. Assimilating Puppet Best Practices
  44. 33. Finding Support Resources
  45. Afterword
  46. A. Installing Puppet on Other Platforms
  47. B. Configuring Firewalls on Other Platforms
  48. C. Installing Ruby
  49. Index
  50. About the Author
  51. Colophon

Appendix C. Installing Ruby

In this appendix, we will cover how to install Ruby on your personal system. To install the exact same version of Ruby utilized by Puppet, run the following command on one of the test hosts:

[vagrant@client ~]$ /opt/puppetlabs/puppet/bin/ruby --version
ruby 2.1.8p440 (2015-12-16 revision 53160) [x86_64-linux]

As of the last update of this book, Puppet uses Ruby 2.1.8.

Ruby for Mac

Macintosh systems come with a modern version of Ruby installed. You can utilize the system Ruby successfully for every purpose in this book. The only thing necessary is to install the Bundler gem:

$ sudo gem install bundler --no-ri --no-rdoc
Fetching: bundler-1.11.2.gem (100%)
Successfully installed bundler-1.11.2
1 gem installed

If you’d prefer to install the exact version of Ruby that Puppet uses, install HomeBrew and then use the following commands:

$ brew install rbenv ruby-build
...
$ eval "$(rbenv init -)"
$ rbenv install 2.1.8
...
$ rbenv shell 2.1.8

Any time you wish to utilize this version of Ruby, just run these commands again:

$ eval "$(rbenv init -)"
$ rbenv shell 2.1.8

Ruby for Windows

Install the latest Ruby 2.1 (or whatever version Puppet uses today) from RubyInstaller for Windows. You should also install the 64-bit DevKit for Ruby.

After these are installed, use the gem command to install Bundler:

C:\> gem install bundler --no-ri --no-rdoc
Fetching: bundler-1.11.2.gem (100%)
Successfully installed bundler-1.11.2
1 gem installed

Ruby for Linux

You can use the Ruby version that comes with your operating system. If you are using CentOS 7 as recommended in this book, it is easy to install Ruby into the system packages:

[vagrant@client ~]$ sudo yum install -y ruby-devel rubygems rake libxml2-devel

For any other operating system, use the system Ruby, rbenv, or RVM to install the Ruby version matching what Puppet uses (the latest version of Ruby 2.1).

Here is a quick installation of Ruby and Bundler using rbenv that should work on any Unix/Linux environment:

$ git clone https://github.com/rbenv/rbenv.git ~/.rbenv
...
$ git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
$ export PATH=~/.rbenv/bin:$PATH
$ eval "$(rbenv init -)"
$ /opt/puppetlabs/puppet/bin/ruby --version
ruby 2.1.8p440 (2015-12-16 revision 53160) [x86_64-linux]
$ rbenv install 2.1.8
...
$ rbenv shell 2.1.8
$ gem install bundler
Fetching: bundler-1.11.2.gem (100%)
Successfully installed bundler-1.11.2
1 gem installed

In order for Bundler and Beaker to build correctly, you’ll need to install some development packages. On CentOS or RHEL systems, the following command is necessary:

[vagrant@client ~]$ sudo yum install -y gcc-c++ libxml2-devel libxslt-devel

The Bundler gem is used for local install of all necessary dependencies:

$ sudo gem install bundler --no-ri --no-rdoc
Fetching: bundler-1.11.2.gem (100%)
Successfully installed bundler-1.11.2
1 gem installed