Forge Home

resource_api

deploy the puppet-resource_api gem across your infrastructure

141,426 downloads

119,228 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.1.0 (latest)
  • 1.0.0
  • 0.3.0
  • 0.2.0
  • 0.1.0
released Jun 17th 2019
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 7.0.0
  • , , , , , , , , , ,
This module has been deprecated by its author since Mar 31st 2021.

Start using this module

Documentation

puppetlabs/resource_api — version 1.1.0 Jun 17th 2019

resource_api

Table of Contents

  1. Module Description - What the module does and why it is useful
  2. Setup - The basics of getting started with resource_api
  3. Reference - An under-the-hood peek at what the module is doing and how
  4. Development - Guide for contributing to the module

Module Description

This module installs the Puppet Resource API gem into a puppet agent and pe-pupetserver or puppetserver service. This is necessary to use any type or provider that is implemented using the Puppet Resource API.

Setup

What resource_api affects

The Puppet Resource API gem will be installed into a puppet agent using the puppet_gem provider, and into a puppetserver service using the puppetserver_gem provider. To activate the gem, a reload of the puppetserver service is necessary. In most cases, this should happen automatically and cause little to no interruption to service.

Setup Requirements

The Puppet Resource API is only compatible with Puppet 4.7 and later. There are no further specific requirements.

Beginning with resource_api

To install dependencies of the Puppet Resource API:

  1. Classify or apply the resource_api class on each master (master of masters, and if present, compile masters and replica master) that needs to process Puppet Resource API types and providers.
  2. Classify or apply the resource_api class on each puppet agent that needs to apply Puppet Resource API types and providers.

To specify the version of the Puppet Resource API gem you want to install, use the $api_version parameter with the resource_api::install::master and resource_api::install::agent classes instead of using the resource_api class.

To specify a non-default puppetserver service resource (if you're not using the standard service) use the $puppetserver_service parameter with the resource_api::install::master class instead of using the resource_api class.

Run puppet agent -t on the master(s) before using the Puppet Resource API on the agent(s).

Reference

See REFERENCE.md

Development

Execute the Puppet Strings task to generate the latest REFERENCE.md

bundle exec rake 'strings:generate[manifests/**/*.pp,,,,,REFERENCE.md,true]'

Please submit any issues, or contributions on https://github.com/puppetlabs/puppetlabs-resource_api