simple_object_storage Template Registry

Introduction

Simple Object Storage is a very simple C++ webserver which provides a store of tagged binary objects (the objects can be large), which are available over http.

Read access is public. Write access is controlled by tokens.

Public read actions:

• Objects are access via a label and tag, or via their hash. For example:

  • wget http://localhost:8123/object/squashkiwi:latest

  • wget http://localhost:8123/object/4528400792837739857

  • curl http://loclahost:8123/exists/squashkiwi:latest

  • curl http://localhost:8123/exists/4528400792837739857

• You can retrieve the hash for a given label and tag with, e.g.:

  • curl http://localhost:8123/hash/squashkiwi:latest

• you can get a full list of {label:tag,hash} entries (one tag per entry) with:

  • curl http://localhost:8123/dir

• get all metadata for a tag:

  • curl http://localhost:8123/meta/squashkiwi:latest

Write actions:

• to upload a file (via http put)

  • curl -T object_file http://localhost:8123/upload?token="WRITE_TOKEN"\&labeltag="LABEL:TAG"\&filename="FILENAME"
  • the object_file is uploaded, hashed, added to the registry (if that hash doesn't already exist), and {label:tag,hash} is added to the directory index.

• to delete a label/tag (object remains):

  • curl http://localhost:8123/deletetag?token="WRITE_TOKEN"\&labeltag="LABEL:TAG"

• to delete an object (and all tags on that object):

  • curl http://localhost:8123/deleteobject?token="WRITE_TOKEN"\&hash="HASH"

• add a tag to an existing object:

  • curl http://localhost:8123/appendtag?token="WRITE_TOKEN"\&hash="HASH"\&labeltag="LABEL:TAG"

• the server is configured via ~/.config/simple_object_storage/config.json which allows setting:

  • the list of write access tokens
  • the location for the object store (path on disk)

Dockcross is used to cross-build for both 64-bit x86 and arm64 (combining both into one docker container image).