/ 
Mojo-Darkpan-0.09
River stage zero No dependents
⭐ Starred 3 GitHub stars
/ README.md

NAME

Mojo::Darkpan - A Mojolicious web service frontend leveraging OrePAN2

DESCRIPTION

Mojo::Darkpan is a webservice build on Mojolicious to frontend OrePAN2. This module was inspired by OrePAN2::Server but built on Mojolicious to take advantage of it's robust framework of tools. A good bit of the documentation was also taken from OrePAN2::Server as the functionality is similar if not identical.

SYNOPSIS

Running the server

# start a server with default configurations on port 8080
darkpan --port 8080

# start a server with AD backed basic auth
# config.json
{
  "basic_auth": {
    "Realm Name": {
      "host": "ldaps://my.ldap.server.org",
      "port": 636,
      "basedn": "DC=my,DC=compoany,DC=org",
      "binddn": "bind_name",
      "bindpw": "bond_pw",
      "filter": "(&(objectCategory=*)(sAMAccountName=%s)(|(objectClass=user)(objectClass=group)))"
    }
  }
}

darkpan --config ./config.json

Options:

Paths:

Configuring the server

Configurations can be done using environment variables or by creating a json config file.

environment variables

Environment variables are at a higher order than values set in the json configuration file and will take precedence if set. The DARKPAN_CONFIG_FILE env variable can be set instead of using the command line option to denote the path of the config file.

config.json

The config.json file contains customizations for the darkpan web application. It can be referenced by absolute path or relative to where the application is run from.

{
  "directory": "darkpan",
  "compress_index": true,
  "path": "darkpan",
  "basic_auth": {
    "Realm Name": {
      "host": "ldaps://my.ldap.server.org",
      "port": 636,
      "basedn": "DC=my,DC=compoany,DC=org",
      "binddn": "bind_name",
      "bindpw": "bond_pw",
      "filter": "(&(objectCategory=*)(sAMAccountName=%s)(|(objectClass=user)(objectClass=group)))"
    }
  }
}

config.json options

Authentication

Authentication is handled by Mojolicious::Plugin::BasicAuthPlus. To configure basic auth, see the configuration options for Mojolicious::Plugin::BasicAuthPlus and add your settings to the basic auth section of the config.json file.

How to Publish

Publishing with POST

Publishing to darkpan can be done using a post request and a URL to git or bitbucket repo.

#upload git managed module to my darkpan by curl 
curl --data-urlencode 'module=git+ssh://git@mygit/home/git/repos/MyModule.git' --data-urlencode 'author=reshingleton' http://localhost:3000/publish
curl --data-urlencode 'module=git+file:///home/rshingleton/project/MyModule.git' --data-urlencode 'author=reshingleton' http://localhost:3000/publish
curl --data-urlencode 'module=git@github.com:rshingleton/perl-module-test.git' --data-urlencode 'author=reshingleton' http://localhost:3000/publish

Publishing with a local file

#upload file from disk via curl
curl -F 'pause99_add_uri_httpupload=@filename.tar.gz' http://localhost:3000/publish

The module parameter can also be an HTTP url. see OrePAN2::Injector for additional details.

curl --data-urlencode 'module=https://cpan.metacpan.org/authors/id/O/OA/OALDERS/OrePAN2-0.48.tar.gz' --data-urlencode 'author=OALDERS' http://localhost:3000/publish

Publishing with Minilla

Minilla is a cpan authoring tool, see Minilla for more details.

minil.toml

Add a reference to a pause configruation file in your minil.toml that points to your darkpan instance. The configuration can reference a relative path as follows:

[release]
pause_config=".pause"

.pause file

The .pause file is a configuration file for uploading modules to CPAN or your own Darkpan Repository. See CPAN::Uploader for more detail.

upload_uri http://my-darkpan.server/publish
user myUsername
password myPassword

** if you don't set the upload_uri, you will upload to CPAN

If basic auth is enabled, the username and password set in the .pause file will be used as basic auth credentials.

How to install from your Darkpan

cpanm

See cpanm for additional details.

 # check CPAN and your Darkpan server
 cpanm --mirror http://my-darkpan.server/darkpan
 
 # check for packages from only your Darkpan server
 cpanm --mirror-only http://my-darkpan.server/darkpan
 cpanm --from http://my-darkpan.server/darkpan

cpm

See cpm for additional details.

# resolve distribution names from DARKPAN/modules/02packages.details.txt.gz
# and fetch distibutions from DARKPAN/authors/id/...
> cpm install --resolver 02packages,http://example.com/darkpan Your::Module

# use darkpan first, and if it fails, use metadb and normal CPAN
> cpm install --resolver 02packages,http://my-darkpan.server/darkpan --resolver metadb Your::Module

carton

See carton for additional details.

# in the cpanfile
# local mirror (darkpan)

requires 'Plack', '== 0.9981',
  dist => 'MYCOMPANY/Plack-0.9981-p1.tar.gz',
  mirror => 'http://my-darkpan.server/darkpan';

Carton also uses an (undocumented) environment variable PERL_CARTON_MIRROR that will enable you to add your Darkpan server to its list of resolvers. Carton will install from your Darkpan and from the default CPAN mirror.

PERL_CARTON_MIRROR=http://my-darkpan.server/darkpan carton install

SEE ALSO

OrePAN2

OrePAN2::Server

LICENSE

Copyright (C) rshingleton.

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

AUTHOR

rshingleton reshingleton@gmail.com