NAME

Dist::Zilla::Plugin::NexusRelease - Release a Dist::Zilla build to a Sonatype Nexus instance.

VERSION

version 1.0.1

SYNOPSIS

If loaded, this plugin will allow the release command to upload a distribution to a Sonatype Nexus instance.

DESCRIPTION

This plugin looks for configuration in your dist.ini or (more likely) ~/.dzil/config.ini:

[NexusRelease]
    username   = Nexus tokenised username
    password   = Nexus tokenised password
    group      = Nexus group ID to use for the upload

The following are optional but very likely to be used:

nexus_URL  = Nexus repository URL

The Nexus Artefact is set to the Perl distribution name (name in dist.ini, and the version is set to the Perl distribution version.

ATTRIBUTES

credentials_stash

This attribute holds the name of a Nexus stash that will contain the credentials to be used for the upload. By default, NexusRelease will look for a %Nexus stash.

username

This is the Nexus user to log in with.

User will be prompted if this is not set in the %Nexus stash.

password

The Nexus password. It is *strongly* advised that you take advantage of the Nexus user tokens feature!

User will be prompted if this is not set in the %Nexus stash.

nexus_URL

The Nexus URL (base URL) to use. Defaults to http://localhost:8081/nexus/repository/maven-releases.

group

The group to use when uploading. There is no default although a reasonable value would be your CPAN ID.

User will be prompted if this is not set in dist.ini.

artefact

The artefact name to use when uploading - defaults to the distribution name.

version

The version of the distribution - defaults to the $VERSION set in the distribution.

METHODS

release

The release method required by Dist::Zilla::Role::Releaser.

SEE ALSO

- Nexus::Uploader - Dist::Zilla::Plusin::UploadToCPAN

AUTHOR

Brad Macpherson <brad@teched-creations.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Brad Macpherson.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.