Skip to content

Latest commit

 

History

History
45 lines (24 loc) · 1.31 KB

concepts.md

File metadata and controls

45 lines (24 loc) · 1.31 KB

Concepts

Repo

A datamon repository is analogous to a git repo. A repo is a dataset that has a unified lifecycle. A particular version of the files in a repo is called a bundle.

See usage

Bundle

A bundle is a point in time read-only view of a repo, composed of individual files. This is analogous to a commit in git.

See usage

Bundle metadata can be downloaded (e.g. to see contributors), bundle blob content can be mounted on a host mount path.

A simple read-only mount provide a file system view of the bundle content.

A new mount will mount a mutable view of the bundle.

Eventually, any set of files from the local filesystem (for instance, a modified version of a mutable mount), may be uploaded to an archived state.

Label

A name given to a bundle, analogous to tags in git. Examples: Latest, production.

NOTE: at this moment, tags a simple strings and cannot be annotated or signed like git tags.

See usage

Context

A context provides a way to define multiple instances of datamon.

See usage

Write Ahead Log

The WAL tracks data updates and their ordering.

Read Log

The Read Log logs all read operations, with their originator.