README.rst 937 Bytes
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
Developer Workspace Migrations
==============================

This directory contains executable files which run once prior to
installation of pre-requisites to bring a developers workspace
into line.

Specifications
--------------

Each file in this directory should meet the following criteria

* Executable (`chmod +x ws_migrations/foo.sh`)
* Idempotent (ideally, each script is run only once, but no
  guarantees are made by the caller, so the script must do
  the right thing)
* Either fast or verbose (if the script is going to take
  a long time, it should notify the user of that)
* A comment at the top of the file explaining the migration

Execution
---------

The scripts are run by the rake task `ws:migrate`. That task
only runs a given script if a corresponding marker file
in .completed-ws-migrations doesn't already exist.

If the SKIP_WS_MIGRATIONS environment variable is set, then
no workspace migrations will be run.