Forge Home

yum

Ad-hoc tasks to interact with yum to install packages, apply security patches etc

5,035 downloads

1,725 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

  • 0.6.4 (deleted)
  • 0.6.3 (deleted)
  • 0.6.2 (deleted)
  • 0.5.4 (deleted)
  • 0.5.3 (latest)
  • 0.5.2 (deleted)
  • 0.5.1 (deleted)
  • 0.5.0 (deleted)
  • 0.4.9
  • 0.4.8
  • 0.4.7
  • 0.4.6
  • 0.4.5
  • 0.4.4
  • 0.4.3
  • 0.4.2
  • 0.4.1
  • 0.4.0
  • 0.3.0
  • 0.2.5
  • 0.2.4
  • 0.2.3
  • 0.2.2
  • 0.2.1
  • 0.2.0
  • 0.1.0
released May 19th 2020
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
  • Puppet >= 5.5.10 < 7.0.0
  • Oracle Enterprise Linux, RedHat, CentOS, Fedora
This module has been deprecated by its author since Jun 8th 2020.

The author has suggested kinners00-yum_tasks as its replacement.

Tasks:
  • advisory
  • cve
  • install
  • remove
  • security
  • update
  • update_all
  • and 1 more. See all tasks
Plans:
  • security_cache

Start using this module

Documentation

kinners00/yum — version 0.5.3 May 19th 2020

yum

Table of Contents

  1. Description
  2. New to bolt?
  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