grunt-nexus-artifact

Download artifacts from a Nexus artifact repository. Publish artifacts to a Nexus artifact repository. Only works with Mac and Linux

Why?

Nexus does really well with binary files. The idea is a repository can build and publish artifacts and other repositories can pull down those artifacts and extract them. Built files don't need to be committed to git, which take up most of the space in git repositories.

Getting Started

This plugin requires Grunt >=0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-nexus-artifact --save-dev

or add the following to your package.json file:

{
  "devDependencies": {
    "grunt-nexus-artifact": "0.3.5"
  }
}

Once the plugin has been installed, enabled it inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-nexus-artifact');

Nexus Fetch Task

Run this task with the grunt nexus:target:fetch command.

Examples

nexus: {
  client: {
    url: 'http://nexus.google.com:8080',
    repository: 'jslibraries',
    fetch: [
      { id: 'com.google.js:jquery:tgz:1.8.0', path: 'public/lib/jquery' }
    ]
  }
}

In grunt, options cascade. If all of your artifacts come from the same nexus server, you can do the following:

nexus: {
  options: {
    url: 'http://nexus.google.com:8080'
  },
  client: {
    options: {
      repository: 'jslibraries'
    },
    fetch: [
      { id: 'com.google.js:jquery:tgz:1.8.0', path: 'public/lib/jquery' }
    ]
  },
  build: {
    options: {
      repository: 'jstools'
    },
    fetch: [
      { id: 'com.google.js:closure:tgz:0.1.0', path: 'tools/closure' }
    ]
  }
}

Options

There are a number of options available.

url

Type: String

This defines the url of your nexus repository. This should be the base URL plus port. Ex: http://your-nexus-repository:8080

repository

Type: String

This defines the name of the repository. Since this task uses the REST API, the repository is not inferred

username

Type: String

This is an optional parameter that will be the nexus username - may not be needed for fetches

password

Type: String

This is an optional parameter that will be the nexus password - may not be needed for fetches

fetch

Type: Array{Object}

This defines an array of nexus artifacts to be retrieved from nexus. Each artifact has config options:

group_id

Type: String

This defines the group_id of the artifact. Ex: com.google.js

name

Type: String

This defines the name of the artifact. Ex: jquery

ext

Type: String

Available extentions are tgz, zip and jar This defines the extension of the artifact. Ex: tgz

version

Type: String

This defines the version of the artifact. Ex: 1.8.0

id

Type: String

This is a shorthand for group_id, name, ext and version. This defines the id string of the artifact in the following format: {group_id}:{name}:{ext}:{version}

Ex:

com.google.js:jquery:tgz:1.8.0

path

Type: String

This defines the path where the artifact will be extracted to. Ex: public/lib/jquery

Nexus publish task

The publish flag will run the publish config to push artifacts up to nexus. It uses grunt-contrib-compress so the file configuration will be the same. Run this task with the grunt nexus:target:publish command.

Examples

nexus: {
  options: {
    url: 'http://nexus.google.com:8080',
    repository: 'jslibraries'
  },
  client: {
    files: [
      { src: ['builds/**/*'] }
    ],
    options: {
      curl: false,
      publish: [{
          id: 'com.mycompany.js:built-artifact:tgz',
          version: 'my-version',
          path: 'dist/',
          username: 'admin',
          password: 'admin123'
      }]
    }
  }
}

In this example the id config is used, but the version is dropped. It can be specified in the id config or specified in the version config. This makes it easier to set the version dynamically.

Options

The options listed here are new or repurposed for publish

path

Type String

This defines the temporary path for the compressed artifact.

files

Type Array

This parameter comes from grunt-contrib-compress. You can read about it at github.com/gruntjs/grunt-contrib-compress. There are some differences from the config on grunt-contrib-compress. First of all, ext is used from the artifact, so it doesn't need to be specified. mode is currently not supported. It will auto-configure based on the extension.

curl

Type Boolean Default false

This parameter gives the option to use curl to upload - some people have issues with uploading using Node streams (not sure why)

Nexus verify task

Run this task with the grunt nexus:target:verify command. This will pull down the last built artifact published to the nexus server.

Examples

You can specify the version in the configuration. This is the preferred approach when the version is dynamic.

nexus: {
  client: {
    url: 'http://nexus.google.com:8080',
    repository: 'jslibraries',
    verify: [
      {
        id: 'com.google.js:jquery:tgz:',
        version: '<%= buildVersion %>',
        path: 'public/lib/jquery'
      }
    ]
  }
}

You can also optionally append the version to the 'id' string.

nexus: {
  client: {
    url: 'http://nexus.google.com:8080',
    repository: 'jslibraries',
    verify: [
      {
        id: 'com.google.js:jquery:tgz:1.8.0',
        path: 'public/lib/jquery'
      }
    ]
  }
}

Options

url

Type: String

This defines the url of your nexus repository. This should be the base URL plus port. Ex: http://your-nexus-repository:8080

repository

Type: String

This defines the name of the repository. Since this task uses the REST API, the repository is not inferred

username

Type: String

This is an optional parameter that will be the nexus username - may not be needed for fetches

password

Type: String

This is an optional parameter that will be the nexus password - may not be needed for fetches

fetch

Type: Array{Object}

This defines an array of nexus artifacts to be retrieved from nexus. Each artifact has config options:

group_id

Type: String

This defines the group_id of the artifact. Ex: com.google.js

name

Type: String

This defines the name of the artifact. Ex: jquery

ext

Type: String

Available extentions are tgz, zip and jar This defines the extension of the artifact. Ex: tgz

version

Type: String

This defines the version of the artifact. Ex: 1.8.0

id

Type: String

This is a shorthand for group_id, name, ext and version. This defines the id string of the artifact in the following format: {group_id}:{name}:{ext}:{version}

Ex:

com.google.js:jquery:tgz:1.8.0

path

Type: String

This defines the path where the artifact will be extracted to. Ex: public/lib/jquery

Release History

• 2013-08-08 v0.2.0 Added support for publishing artifacts

---

Contributed by Nicholas Boll of Rally Software