NAME

narada-install - migrate project to given version

VERSION

This document describes narada-install version v2.3.8

USAGE

    narada-install [--allow-downgrade|-D] [--allow-restore|-R] [-f <file>] <ver>
    narada-install [-f <file>] --path|-p <ver1> <ver2> <ver3> ...
    narada-install --check|-c <file>
    narada-install --help|-h

DESCRIPTION

Should be executed in project deploy directory.

Upgrade/downgrade your project in safe way:

• It use Narada's exclusive lock to make sure no other code will run while migrating project's files or databases (to make this works as expected you must use Narada's shared lock around all your code which read or write any project's files or databases).

• Before every migration it will automatically create new backup .backup/full-<current_version>.tar.

• If migration fail it will automatically restore previous version from backup.

• Use App::migrate file format to describe project migrations, which let you downgrade fast and without losing any data whenever possible.

When called with option --check|-c will check syntax of given migrate file and exit.

It will try to load several migrate files, in this order:

• file given using -f option (if any)

• .release/<next_ver>.migrate where <next_ver> is last parameter (if this file exists)

• .release/<prev_ver>.migrate where <prev_ver> is current project version if called without --path option and file VERSION exists or first parameter after --path option (if this file exists)

Then it will try to find migration path from current version to given and execute it (or just execute given migration path if called with --path option).

CONFIGURATION AND ENVIRONMENT

    .lock
    .lock.new
    .lock.bg
    $NARADA_SKIP_LOCK
    .backup/full.tar
    .backup/full-*.tar
    .release/*.migrate

SUPPORT

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/powerman/Narada/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license. Feel free to fork the repository and submit pull requests.

https://github.com/powerman/Narada

    git clone https://github.com/powerman/Narada.git

Resources

• MetaCPAN Search

  https://metacpan.org/search?q=Narada

• CPAN Ratings

  http://cpanratings.perl.org/dist/Narada

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Narada

• CPAN Testers Matrix

  http://matrix.cpantesters.org/?dist=Narada

• CPANTS: A CPAN Testing Service (Kwalitee)

  http://cpants.cpanauthors.org/dist/Narada

AUTHOR

Alex Efros <powerman@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2008- by Alex Efros <powerman@cpan.org>.

This is free software, licensed under:

  The MIT (X11) License

cpanm Narada

perl -MCPAN -e shell
install Narada