Server automation framework and application
Перейти к файлу
Joshua Peek 759acdb529 Revert "(PUP-2577) Fix version comparison for OS X >= 10.10" 2014-08-25 20:56:36 -05:00
acceptance (PUP-2999) Use host.tmpdir for agent tmpdirs 2014-08-20 17:27:58 -07:00
api Merge pull request #2994 from demophoon/maint/master/fix-http-environment-doc 2014-08-20 17:47:02 -07:00
autotest (maint) Ensure every file has a trailing newlines 2012-04-23 15:24:34 -07:00
benchmarks (maint) Fix run of "empty catalog" benchmark missing current_environment 2014-07-27 17:03:15 +02:00
bin (PUP-2478) Remove current directory from Ruby load path. 2014-05-27 11:21:31 -07:00
conf Maint: Fix buggy auth.conf example in fileserver.conf 2014-03-27 13:53:13 -07:00
docs (maint) Guard preserve_configuration in acceptance 2014-08-06 17:02:20 -07:00
examples/hiera (Maint) Update commands to use new forms in hiera examples 2013-09-19 03:29:31 -07:00
ext (PUP-2914) Remove remaining rgen dependencies 2014-08-22 16:15:11 -07:00
lib Revert "(PUP-2577) Fix version comparison for OS X >= 10.10" 2014-08-25 20:56:36 -05:00
man spelling/grammatical fixes 2013-04-23 18:40:21 -07:00
spec PUP-2040/PE-3113 Ignore symlinks in module build with pmtignore. 2014-08-25 12:11:15 -07:00
tasks (maint) Move local egrammar makefile tasks to main Rakefile 2014-08-05 16:24:31 -07:00
util (doc) Note how to obtain spec_order from parallel-spec runs 2014-07-24 16:48:53 -07:00
yardoc/templates/default (#18023) Document user facing classes using yardoc and show api. 2013-01-05 02:45:33 +01:00
.gemspec (PUP-1821) Require Facter 1.7 or greater 2014-03-03 15:24:10 -08:00
.gitignore (maint) Adding .ruby-version and .ruby-gemset to .gitignore for RVM users. 2014-01-28 15:16:15 -08:00
.mailmap (maint) Update mailmap for git shortlog 2012-10-18 16:14:06 -07:00
.noexec.yaml (#15464) Exclude gem command from bundler 2012-08-20 15:32:05 -07:00
.travis.yml (maint) Set Travis CI to run two spec runner processes. 2014-06-25 21:30:34 -07:00
.yardopts (maint) Remove reference to README_DEVELOPER 2014-04-22 11:44:06 -07:00
COMMITTERS.md (maint) Clarify the merge-up process in COMMITTERS 2013-05-13 15:26:31 -07:00
CONTRIBUTING.md (doc) Recommend git checkout -b in CONTRIBUTING.md 2014-06-04 10:19:56 -07:00
Gemfile (PUP-2914) Remove rgen 0.7.0 dependency 2014-08-19 21:50:50 -07:00
LICENSE Updating copyright years in LICENSE 2014-01-17 15:28:14 -08:00
README.md (maint) Update docs badge in README 2014-06-04 00:26:18 +02:00
Rakefile (Maint) Alias TESTS as TEST 2014-01-17 09:29:14 -08:00
install.rb (PUP-392) Remove sys-admin gem 2014-06-30 10:00:18 -07:00

README.md

Puppet

Build Status Inline docs

Puppet, an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks (such as adding users, installing packages, and updating server configurations) based on a centralized specification.

Documentation

Documentation for Puppet and related projects can be found online at the Puppet Docs site.

HTTP API

HTTP API Index

Installation

The best way to run Puppet is with Puppet Enterprise, which also includes orchestration features, a web console, and professional support. The PE documentation is available here.

To install an open source release of Puppet, see the installation guide on the docs site.

If you need to run Puppet from source as a tester or developer, see the running from source guide on the docs site.

Developing and Contributing

We'd love to get contributions from you! For a quick guide to getting your system setup for developing take a look at our Quickstart Guide. Once you are up and running, take a look at the Contribution Documents to see how to get your changes merged in.

For more complete docs on developing with puppet you can take a look at the rest of the developer documents.

License

See LICENSE file.

Support

Please log tickets and issues at our JIRA tracker. A mailing list is available for asking questions and getting help from others. In addition there is an active #puppet channel on Freenode.

We use semantic version numbers for our releases, and recommend that users stay as up-to-date as possible by upgrading to patch releases and minor releases as they become available.

Bugfixes and ongoing development will occur in minor releases for the current major version. Security fixes will be backported to a previous major version on a best-effort basis, until the previous major version is no longer maintained.

For example: If a security vulnerability is discovered in Puppet 4.1.1, we would fix it in the 4 series, most likely as 4.1.2. Maintainers would then make a best effort to backport that fix onto the latest Puppet 3 release.

Long-term support, including security patches and bug fixes, is available for commercial customers. Please see the following page for more details:

Puppet Enterprise Support Lifecycle