Skip to content

brianhks/nexus-puppet-forge-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nexus Puppet Forge Plugin

Summary

This plugin adds Puppet Forge API v3 rest api's to a Maven 2 Nexus repository.

Uploading Puppet Modules

The paths and naming conventions used must all match the maven 2 convention. The reason for this is that this plugin utilizes some of the features of the maven 2 repository.

Each module must have a metadata.json file and be compressed as a tar.gz file. Lets say I want to upload the mysql module from puppet labs (puppetlabs-mysql-3.6.1.tar.gz), In order to upload the module to nexus I must conform to the naming convention of maven 2. Here is a sample curl statement to upload the module

curl -v -u $NEXUS_USER:$NEXUS_PASSWORD --upload-file puppetlabs-mysql-3.6.1.tar.gz  $NEXUS_URL/nexus/content/repositories/$NEXUS_REPOSITORY/puppetlabs/mysql/3.6.1/mysql-3.6.1.tar.gz

The $NEXUS_REPOSITORY name must be listed in the puppet-forge.repository.list property. If the file ends with tar.gz and the repository is configured in the properties file this plugin will extract the metadata.json from the tar and saves it in the same folder as the module. The plugin will also parse the metadata.json file and generate a pom.xml file.

To control what repositories the plugin watches for modules you must configure the repositories in puppet-forge.properties file. The puppet-forge.properties file needs to be located in sonatype-work/nexus/conf

puppet-forge.repository.list=puppet,puppetModules

For reference look at this project I created: https://github.com/brianhks/puppet-module-publisher It is a set of scripts for downloading modules using librarian-puppet and then there is a script to upload them into Nexus.

Using Librarian Puppet to download from Nexus

At the top of your Puppetfile set this value

forge "http://nexus:8081/nexus/service/siesta/puppetforge/puppet"

Just replace /puppet on the end with the name of your repository. When you call librarian-puppet make sure to pass --no-use-v1-api so it won't try to use version 1 of the api which is not supported by this plugin.

Updates were made to the librarian-puppet code that breaks this plugin. Have a look at the wiki for updated information: https://github.com/brianhks/nexus-puppet-forge-plugin/wiki

About

Adds PuppetForge apis to Nexus repository

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages