App-Difio-dotCloud

Difio registration agent for dotCloud / Perl applications


License
Artistic-1.0-Perl

Documentation

Difio registration agent for dotCloud / Perl applications

This module compiles a list of locally installed Perl distributions and sends it to
http://www.dif.io where you check your application statistics and available updates.


INSTALLATION

To register your dotCloud Perl application to Difio do the following:

1) Create a Perl application on dotCloud

2) Configure your Difio userID. You can get it from https://difio-otb.rhcloud.com/profiles/mine/

    dotcloud var set <app name> DIFIO_USER_ID=UserID

3) Generate a unique identifier for this application and save the value as environmental variable.

    dotcloud var set <app name> DIFIO_UUID=`uuidgen`

4) Add a dependency in your Makefile.PL file

    PREREQ_PM => {
        'App::Difio::dotCloud' => 0,
        ...
    },

5) Enable the registration script in your postinstall hook. **Note:**
If you are using an "approot" your `postinstall` script should be in the 
directory pointed by the "approot" directive of your `dotcloud.yml`.
For more information about `postinstall` turn to 
http://docs.dotcloud.com/guides/postinstall/.

If a file named `postinstall` doesn't already exist, create it and add the following:

        #!/bin/sh
        /home/dotcloud/perl5/lib/perl5/App/Difio/dotCloud.pm

6) Make `postinstall` executable

        chmod a+x postinstall

7) Then push your application to dotCloud

    dotcloud push <app name>

8) If everything goes well you should see something like:

        19:55:10 [www.0] Running postinstall script...
        19:55:13 [www.0] Difio: Success, registered/updated application with uuid ac5a3741-a564-4e59-aad2-3f51ea860521

That's it, you can now check your application statistics at
http://www.dif.io


COPYRIGHT AND LICENCE

 Copyright (C) 2012 by Alexander Todorov <atodorov@nospam.dif.io>

 This module is free software and is published under the same terms as Perl itself.