Skip to content

Latest commit

 

History

History
78 lines (53 loc) · 2.04 KB

README.md

File metadata and controls

78 lines (53 loc) · 2.04 KB
Raw

Storage

Multy-tenant RESTful HTTP API server for encrypted data storing and retrieval in IPFS and web3 storages with per-user workload accounting.

There are two layers of storage here: one with an instant access and an archive storages. Instant access storage backend is IPFS caching node. Archive storage is an external service that can replicate and restore content from the IPFS caching node.

Launch

Run locally for development

Assuming we are in the repository root directory.

  1. Load environment variables

    ...
export $(cat .env.local | xargs)

  2. Run local database and IPFS node

    docker compose up postgres kubo

  3. Launch service instance

    ./start.sh

  4. Create a tenant and an API key

    $ python -m storage --tenant-create dev && python -m storage --create-api-key-for-tenant dev
2022-11-28 17:47:08.555 | INFO     | __main__:<module>:75 - tenant created, tenant.name='dev', tenant.schema='dev', tenant.host='dev'
0dOzYgisKiKBJFM5Y60J7p96U48IdmsuV_GOan0c15fTNQuxee6sPSgMMNGDDeCwtKK6BzScI7ORJ9dqfQOThw

Deploy to cluster

Assuming we are in the repository root directory and cluster leader Docker context is available locally by merklebot name.

  1. Load environment variables

    ...
export $(cat .env.prod | xargs)

  2. Connect to swam leader

    docker context use merklebot

  3. Remove an old version

    docker stack rm $DOCKER_SWARM_STACK_NAME

  4. Run a new version

    docker stack deploy -c docker-compose.yml -c docker-compose.prod.yml $DOCKER_SWARM_STACK_NAME

  5. Check services are ok (at least 1 replica is running)

    $ docker service ls
ID             NAME              MODE         REPLICAS   IMAGE                            PORTS
6zw0odgoqjuf   storage_postgres  replicated   1/1        postgres:15
met55xby5gmf   storage_storage   replicated   1/1        ghcr.io/merklebot/storage:main