simple_object_storage Template Registry

Introduction

The simple_object_storage template registry is a very simple C++ webserver which provide a store of binary objects (the objects can be large), which are available over http.

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

• 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
• The hash is calculated using uint64_t hash_file(const std::string &path); in hash.hpp.
• You can retrieve the hash for a given labvel 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
• a simple welcome page is served at /index.html for those browsing to the site.
• to upload a file (via http put)
  • curl -T object_file http://localhost:8123/WRITE_TOKEN/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.
• the server is configured via a configuration file which allows setting:
  • the list of write access tokens
  • the location for the object store (path on disk)

The C++ program is written so that it only uses standard libraries, and is built as a static executable with musl not glibc.

The C++ program is built with cmake.

A Dockerfile is included for conveniently running the C++ program inside docker.