The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

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

VERSION

version 0.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  = Base Nexus URL
      repository = Nexus repo ID

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

username

This is the Nexus user to log in with.

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

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 dist.ini.

nexus_URL

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

repository

Name of the repository to use for uploads. Defaults to 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) 2014 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.