Forge Home

simp_ipa

Puppet module for managing simp_ipa server and client

7,714 downloads

1,094 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.2.1 (latest)
  • 0.2.0
  • 0.1.1
  • 0.1.0
  • 0.0.2
  • 0.0.1
released Aug 3rd 2021
This version is compatible with:
  • Puppet Enterprise 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
  • Puppet >= 6.22.1 < 8.0.0
  • , ,
Tasks:
  • join
  • leave

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'simp-simp_ipa', '0.2.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add simp-simp_ipa
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install simp-simp_ipa --version 0.2.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download
Tags: simp

Documentation

simp/simp_ipa — version 0.2.1 Aug 3rd 2021

License CII Best Practices Puppet Forge Puppet Forge Downloads Build Status

Table of Contents

Description

This is a module for managing simp_ipa server and client installations.

Reference

See REFERENCE.md for the full module reference.

This is a SIMP module

This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.

If you find any issues, they may be submitted to our bug tracker.

Setup

What simp_ipa affects

The simp_ipa module is quite minimal at the moment, it can only join and remove hosts from an IPA domain.

Usage

The simp_ipa class is a just a placeholder for now.

simp_ipa::client::install and related parameters will run ipa-client-install on systems if it needs it. You can either use discovery (provided you have DNS set up correctly) or manually set all the parameters required. See the reference material for further documentation.

Tasks

Join a domain using ipa-client-install:

bolt task run simp_ipa::join --nodes <nodes> server=ipa.example.com options='--verbose --mkhomedir'

Other options can be added to the options parameter, like options='--mkhomedir --verbose'.

Leave a domain:

bolt task run simp_ipa::leave --nodes <nodes> domain=<domain> options='--verbose'

Tasks are also available from the Puppet Enterprise console.

Development

Please read our Contribution Guide.

Acceptance tests

This module includes Beaker acceptance tests using the SIMP Beaker Helpers. By default the tests use Vagrant with VirtualBox as a back-end; Vagrant and VirtualBox must both be installed to run these tests without modification. To execute the tests run the following:

bundle install
bundle exec rake beaker:suites

NOTE: When testing this module, you will probably want to run with BEAKER_destroy=no, install the simp_ipa client locally and connect to the running VM to ensure proper functionality.

Please refer to the SIMP Beaker Helpers documentation for more information.