Skip to main content

Module to manage Puppet control repository hosted on Github

Project description

https://travis-ci.org/othalla/py-control-repository.svg?branch=master https://badge.fury.io/py/py-control-repository.svg https://codecov.io/gh/othalla/py-control-repository/branch/master/graph/badge.svg https://api.codacy.com/project/badge/Grade/f631643ebb164aa697cb40c63f6d8375

Py Control Repository is SDK for Pyththon which allows developpers to manage a Puppet Control Repository based on GitHub.

Install

$ pip install py-control-repository

Usage

Get Puppet Environment

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

puppet_environment = control_repository.get_environment('production')

Get all Puppet Environment

Returns the list of all Puppet Environment.

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

puppet_environments = control_repository.get_environments()

Get all Puppet Environment names

Returns the list of all Puppet Environment names.

control_repository = ControlRepository('myorga', 'my_control_repository', 'token')

puppet_environment_names = control_repository.get_environment_names()

Get Puppetfile

puppetfile = puppet_environment.get_puppetfile()

List Puppet modules in Puppetfile

module_list = puppetfile.list_modules()

Add a forge module

puppetfile.add_forge_module('puppetlabs/apache', version='0.10.1')

Update a forge module

puppetfile.update_forge_module('puppetlabs/apache', '0.11.0')

Remove a forge module

puppetfile.remove_forge_module('puppetlabs/apache')

Add a git module

With no version spicified, it will install the current master branch.

puppetfile.add_git_module('custom_module', 'https://url.my.git/orga/custom_module')

You can specify a specific git reference. Supported are :

  • branch
  • ref
  • tag
  • commit
puppetfile.add_git_module('custom_module',
                          'https://url.my.git/orga/custom_module',
                          reference_type='commit',
                          reference='ae1fe')

Update a git module

Bump module version

puppetfile.update_git_module('mymodule', '12.0.2')

You can also change a module reference type and its value.

For example you have a module deployed by its master branch and want to track it by a specific tag.

puppetfile.update_git_module('mymodule', '1.0.0', reference_type='tag')

Remove a git module

puppetfile.remove_git_module('apache')

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
py_control_repository-0.9.0-py3-none-any.whl (11.8 kB) Copy SHA256 hash SHA256 Wheel py3

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page