stack-orchestrator/app/data/stacks/azimuth/README.md

# Azimuth Watcher

Instructions to setup and deploy Azimuth Watcher stack

## Setup

Prerequisite: `ipld-eth-server` RPC and GQL endpoints

Clone required repositories:

```bash
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

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

Build the container images:

```bash
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:

  ```bash
  # 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:

  ```bash
  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:

```bash
laconic-so --stack azimuth deploy-system down
```

Clear volumes created by this stack:

```bash
# 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")
```