Skip to content
This repository has been archived by the owner on Jan 19, 2018. It is now read-only.

Update file handling doc. Fixes #285 #561

Merged
merged 1 commit into from
Feb 17, 2016
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 28 additions & 3 deletions docs/file_handling.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,43 @@
## Fetch

Fetching an Atomic App means to download the artifacts and sample answerfile.
Fetching an Atomic App means to download the metadata files: artifacts and
sample answerfile for an Atomic App. By default, it downloads the metadata
files for the atomicapp to a directory of the form
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Atomic App

``/var/lib/atomicapp/<atomic app name>-<uuid>``. If needed,
you can also specify a target directory to download the metadata for the
Atomic App using the ``--destination`` option.

## Developing and Debugging

Image developers may run the root container and point to a Nulecule directory on the local system.

## Directories

* `/tmp/<atomicapp_name>`: Host directory for temporary Nulecule files. May be overridden.
* `/tmp/<atomicapp_name>/.workdir`: Host directory for artifact template files with variable substitution.
* `/var/lib/atomicapp/<atomic app name>-<uuid>`: This is where an Atomic App
and it's dependencies are fetched when fetching or running the Atomic App,
unless, a specific destination is specified.
* `/var/lib/atomicapp/<atomic app name>-<uuid>/external`:
External Atomic Apps, if any, for the given Atomic App are
fetched into ``external`` directory inside the directory of
the Atomic App, during, fetching the Atomic App with
dependencies or running the Atomic App.

## Artifact path

Local path to an artifact file or a directory containing artifact files as its
immediate children.

## Runtime answers file

When running an Atomic App, it asks the users for missing values for
parameters defined in the Atomic App and it's child Atomic Apps. This
aggregated answers data is used to run the Atomic App, and is dumped
to a file: ``answers.conf.gen`` in the Atomic App's directory, to be
used later when stopping the Atomic App.

## Rendered artifact files

Artifact files are rendered with runtime answers data along side the original
artifact files, but with the filenames prefixed with a `.` (dot), to make
them hidden.