stack-orchestrator/app/data/stacks/azimuth/README.md
Nabarun Gogoi 960a24c96b Add stack for azimuth watchers with gateway-server (#379)
* Setup gateway-server with watchers

* Add js script to merge toml config files

* Remove individual watcher configs

* Add all azimuth watchers in stack

* Fix toml-js install

* Use env variables for ipld-eth-server endpoints

* Checkout to version tag in azimuth-watcher-ts repo

Former-commit-id: 5a94aed7f7
2023-05-04 15:35:04 +05:30

1.6 KiB

Azimuth Watcher

Instructions to setup and deploy Azimuth Watcher stack

Setup

Prerequisite: ipld-eth-server RPC and GQL endpoints

Clone required repositories:

laconic-so --stack azimuth setup-repositories

NOTE: If the repository already exists and checked out to a different version, setup-repositories command will throw an error. For getting around this, the azimuth-watcher-ts repository can be removed and then run the command.

Checkout to the required versions and branches in repos

# azimuth-watcher-ts
cd ~/cerc/azimuth-watcher-ts
git checkout v0.1.0

Build the container images:

laconic-so --stack azimuth build-containers

This should create the required docker images in the local image registry.

Configuration

  • Create and update an env file to be used in the next step:

    # External ipld-eth-server endpoints
    CERC_IPLD_ETH_RPC=
    CERC_IPLD_ETH_GQL=
    
  • NOTE: If ipld-eth-server is running on the host machine, use host.docker.internal as the hostname to access host ports

Deploy the stack

  • Deploy the containers:

    laconic-so --stack azimuth deploy-system --env-file <PATH_TO_ENV_FILE> up
    
  • List and check the health status of all the containers using docker ps and wait for them to be healthy

Clean up

Stop all the services running in background run:

laconic-so --stack azimuth deploy-system down

Clear volumes created by this stack:

# List all relevant volumes
docker volume ls -q --filter "name=.*watcher_db_data"

# Remove all the listed volumes
docker volume rm $(docker volume ls -q --filter "name=.*watcher_db_data")