Namespace, Primitive, Method
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    grunt-nexus-artifactpublic

    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

    Keywords

    install

    npm i grunt-nexus-artifact

    Downloadslast 7 days

    147

    version

    1.1.0

    license

    MIT

    last publish

    collaborators

    • avatar
    • avatar