Exporting and Running Locally¶
- Tales can be exported in the following formats
- ZIP (Best for quick browsing)
- BagIt (For archiving and running locally)
To export a Tale, navigate to the Run page, select the
... dropdown menu, and then select an appropriate format.
Zipped Tales have a basic structure that includes a minimal amount of metadata and data.
The data that was saved in the Tale’s Workspace is saved in the data/ folder. Information about external data can
be found in
Tales exported under BagIt have additional metadata and an additional
fetch.txt file that lists where external data resides.
Tales that are exported in this format also have the ability to be run locally.
External datasets can be found in
fetch.txt. Data that was in the Tale workspace can be found in
Running Tales Locally¶
Exported Tales under the BagIt format have a
run-local.sh file that can be run to re-create the Tale.
run-local.sh, ensure that you have Docker running in the background.
When you’re ready to run the Tale, open up the terminal and navigate to the top level of the bag.
sh run-local.sh and wait for the setup to complete. If this is your first running a Tale locally, it may take
some time to download the docker image.