Forge Home

nexus_artifact

Download nexus artifact

9,445 downloads

9,445 latest version

4.1 quality score

Version information

  • 0.1.0 (latest)
released May 4th 2016

Start using this module

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

Add this module to your Puppetfile:

mod 'af6140-nexus_artifact', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add af6140-nexus_artifact
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install af6140-nexus_artifact --version 0.1.0

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

Documentation

af6140/nexus_artifact — version 0.1.0 May 4th 2016

nexus_artifact

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with nexus_artifact
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

Overview

This moudle defines a single puppet custom type/provider for downloading nexus artifact.

It was originally based on https://forge.puppetlabs.com/ceh/nexus to avoid potential namesapce confliction, and was quickly realized it does not work well with changing artifact of same version number, like snapshots. Patching the code is problematic, since if nexus is need to be queried, it is better to be done with ruby code, which we cannot be embedded in puppet module. At the same time, functions are pure ruby code and were executed on puppet master. This custom type allows to download artifact from nexus maven repository including snapshots repoistory, since it compares the checksum of artifacts of the same base version. Maven artifacts in snapshots repository can take the form of artifactid-version-SNAPSHOT-timestamp.suffix, though they are the same base versions, but timestamp varies.

Module Description

A custom type/provider ent_nexus_getartifact is implemented to download artifact from nexus.

Setup

include nexus_artifact

What nexus_artifact affects

  • Tt requires a tmp_dir available to store the artifact.
  • It fetches artifact from nexus to local file system.

Setup Requirements OPTIONAL

If requires a posix system with common os commands like wget, chmod, chown. It also requires pluginsync=true enabled for puppet.

Beginning with nexus_artifact

See source code at ssh://git@stash.entertainment.com:7999/pm/entertainment-nexus_artifact.git.

Usage

ent_nexus_getartifact{'/tmp/coupon_app-static.tar':
        nexus_url => 'https://nexus.mycompany.com/nexus',
        group => 'webapps',
        artifact => 'app-static',
        version => '1.0.3',
        repo => 'entertainment',
        extension => 'tar',
        owner => 'root',
        filegroup => 'root',
        mode => '0755',
        ensure => 'present',
}

Reference

A custom type and provider are available.

Type

  • ent_nexus_getartifact

Provider

  • nexus_fetch

Limitations

Only tested on Centos/Redhat, against nexus.

Development

Since your module is awesome, other users will want to play with it. Let them know what the ground rules for contributing are.

Release Notes/Contributors/Etc Optional

If you aren't using changelog, put your release notes here (though you should consider using changelog). You may also add any additional sections you feel are necessary or important to include here. Please use the ## header.