storage/cmd/containers-storage
Nalin Dahyabhai d8c5c0a1f8 Make the CLI use either all defaults, or none
Make the CLI use all of the default settings if none of them are
overridden on the command line, or none of them, if any are overridden.
Any other behavior is hard to use in integration tests, and confusing.

Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2017-10-03 09:42:48 -04:00
..
README.md Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
container.go Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
containers.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
create.go Merge pull request #108 from nalind/layerless-images 2017-09-29 16:16:54 -04:00
delete.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
diff.go Make Diff() methods take an optional *DiffOptions 2017-06-16 10:50:08 -04:00
exists.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
image.go Wrap new data retrieval APIs in the CLI tool 2017-10-02 17:50:01 -04:00
images.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
layer.go Add a CLI "layer" command 2017-09-29 15:06:59 -04:00
layers.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
main.go Make the CLI use either all defaults, or none 2017-10-03 09:42:48 -04:00
metadata.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
mount.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
name.go Wrap the Store.Names() method in the CLI 2017-09-29 15:00:19 -04:00
shutdown.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
status.go Clean up CLI display of settings 2017-09-29 15:07:12 -04:00
tree.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
tree_test.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00
version.go Finish renaming oci-storage to containers-storage 2017-07-10 16:11:09 -04:00
wipe.go Rename CLI from oci-storage to containers-storage 2017-05-25 15:50:33 -04:00

README.md

This is containers-storage, a command line tool for manipulating local layer/image/container stores.

It depends on storage, which is a pretty barebones wrapping of the graph drivers that exposes the create/mount/unmount/delete operations and adds enough bookkeeping to know about the relationships between layers.

On top of that, storage provides a notion of a reference to a layer which is paired with arbitrary user data (i.e., an image, that data being history, configuration, and other metadata). It also provides a notion of a type of layer, which is typically the child of an image's topmost layer, to which arbitrary data is directly attached (i.e., a container, where the data is typically configuration).

Layers, images, and containers are each identified using IDs which can be set when they are created (if not set, random values are generated), and can optionally be assigned names which are resolved to IDs automatically by the various APIs.

The containers-storage tool is a CLI that wraps that as thinly as possible, so that other tooling can use it to import layers from images. Those other tools can then either manage the concept of images on their own, or let the API/CLI handle storing the image metadata and/or configuration. Likewise, other tools can create container layers and manage them on their own or use the API/CLI for storing what I assume will be container metadata and/or configurations.

Logic for importing images and creating and managing containers will most likely be implemented elsewhere, and if that implementation ends up not needing the API/CLI to provide a place to store data about images and containers, that functionality can be dropped.