yum

Table of Contents

1. Description
2. New to bolt?
   • Newcomers quickstart
3. Gotchas/Limitations
4. Usage - Examples and general tips on how to use the content in this module
5. # Contributions - Guide for contributing to the module

Description

These tasks help interact with yum at various levels via Puppet Bolt or Puppet Enterprise tasks.

New to bolt?

Check these out:

Installing Bolt

Running Bolt commands

Inventory File Examples

Bolt Command reference

Newcomers quickstart

Create a Bolt project + Boltdir > Create Puppetfile + Add this module > Install module > Run tasks! :)

mkdir -p bolt/Boltdir/
cd bolt/Boltdir/

cat << EOF >> Puppetfile
# Modules from the Puppet Forge.
mod 'kinners00-yum',        '0.5.3'
EOF

bolt puppetfile install

Gotchas

Bolt tasks are copied and executed under /tmp

If you can't execute scripts under that directory, you can pass --tmpdir flag on your bolt command followed by your chosen directory for example --tmpdir /var/tmp

You must pass 'run as root' parameter in order for tasks to successfully complete

You can do this by specifying --run-as root on your bolt command or by adding run-as: root to your config in your inventory.yaml file.

Security related tasks only work on RHEL + OEL

yum::security, yum::cve and yum::advisory tasks will only work if you have the relevant security metadata repos enabled.

To the best of my knowledge, this effectively limits this task to RHEL and OEL boxes. It will look like it works on centos etc (i.e. executes successfully) but it will never "find" any security updates if the corresponding repo isn't there.

Usage

Show all available yum tasks

Will show all tasks that match the module name yum.

bolt task show --filter yum

Show task info/metadata

This will show a brief description of the tasks function as well the parameters that the task can consume.

bolt task show yum::security

Running a task

Pass in the relevant parameters and run the task.

bolt task run --targets rhelboxes yum::security security=minimal

Plan example

If you a bolt aficionado, you can ignore this section.

I've included a sample plan to demonstrate how you can chain together tasks to achieve an overall workflow. In this plan we are running the cache task followed by the security task. Plans can be made up of tasks from other modules too.

plan yum::security_cache(
  TargetSpec $targets,
  String $cache,
  String $securitymarcmupdate 
  run_task('yum::update_cache', $targets, cache => $cache)
  run_task('yum::security', $targets, security => $security)

  }

Running a plan

(Optional) Add --verbose to the end of your bolt command to get output from each task in the plan.

bolt plan run yum::security_cache targets=rhelboxes cache=update security=minimal --verbose

Contributions

This module contains a simple set of tasks (written in bash). The logic on some tasks could be smarter/cleaner but they should all work. I will get round to improving them at some point in the near future.

If anyone would like to contribute to the module, that would be awesome and very much welcomed.

If you're experiencing any bugs, please raise an issue below:

Repo: https://github.com/kinners00/yum/issues

Issues link: https://github.com/kinners00/yum/issues

Changelog

All notable changes to this project will be documented in this file.

Release 0.5.3

Features

Bugfixes Updated readme with more bolt gotchas/formatting changes. Added PE metadata.

Known Issues