package_task

Table of Contents

1. Description
2. Setup - The basics of getting started with package task
   • Setup requirements
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Description

This module provides the package task. This allows you to execute various actions against packages. For example installing vim via the apt package provider. It requires Puppet 5 or bolt installed

Setup

Setup Requirements

This module requires either Puppet enterprise or Bolt to function.

Usage

There are a number of ways to execute the package task. The examples below check the status of the vim package.

VIA PE-console see link_here

Via BOLT more information here LINK

bolt task package status vim

Via the PE CLI, more information here LINK

puppet task package status vim

Reference

To get the availible actions and parameters run

puppet task show package

puppet task show package

or go to https://forge.puppet.com/puppetlabs/package/tasks

For a complete list of optional package providers that are supported please go here https://docs.puppet.com/puppet/latest/types/package.html

Development

Here is a quick how to get up and running

git clone git@github.com:puppetlabs/package.git

bundle install --path .bundle/gems/

BEAKER_destroy=no PUPPET_INSTALL_TYPE=pe BEAKER_PE_DIR=http://enterprise.delivery.puppetlabs.net/2017.3/ci-ready  BEAKER_PE_VER=2017.3.0-rc8-41-g4981bd3 BEAKER_set=centos7-pooler  bundle exec rspec spec/acceptance

This will spit out a vmpooler machine name you can ssh to

ssh -i ~/.ssh/id_rsa-acceptance root@<VMPOOLER HOSTNAME FROM ABOVE> 

show the status of the openssl package (use the actual name of your node)

puppet task run package --nodes cgx1boldbmbi3vn.delivery.puppetlabs.net action=status package=openssl

display help for package

puppet task show package

show help for the task cli

puppet task run --help