fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd/README.md
Isha Venikar 9499bb6b1d
Create external stack for laconicd fixturenet (#1)
* Add compose file for laconicd fixturenet

* Add build script for laconicd container

* Add fixturenet laconicd script

* Add stack instructions for fixturenet stack

* Update README instructions

* Update build and config scripts

* Update compose file

* Update root README

---------

Co-authored-by: Prathamesh Musale <prathamesh.musale0@gmail.com>
2024-06-24 13:00:16 +05:30

88 lines
2.0 KiB
Markdown

# fixturenet-laconicd-stack
## Setup
* Clone the stack repo
```bash
laconic-so fetch-stack git.vdb.to/cerc-io/fixturenet-laconicd-stack
```
* Clone required repositories:
```bash
laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd setup-repositories
```
* Build the container images:
```bash
laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd build-containers
```
## Create a deployment
* Create a spec file for the deployment:
```bash
laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd deploy init --output fixturenet-laconicd-spec.yml
```
* Edit `network` in the spec file to map container ports to host ports as required:
```bash
...
network:
ports:
laconicd:
- '6060:6060'
- '26657:26657'
- '26656:26656'
- '9473:9473'
- '9090:9090'
- '1317:1317'
```
* Create a deployment from the spec file:
```bash
laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd deploy create --spec-file fixturenet-laconicd-spec.yml --deployment-dir fixturenet-laconicd-deployment
```
## Start the deployment
```bash
laconic-so deployment --dir fixturenet-laconicd-deployment start
```
## Check status
* To list down and monitor the running containers:
```bash
# With status
docker ps -a
# Follow logs for laconicd container
laconic-so deployment --dir fixturenet-laconicd-deployment logs laconicd -f
```
## Clean up
* Stop all services running in the background:
```bash
# Stop the docker containers
laconic-so deployment --dir fixturenet-laconicd-deployment stop
```
* To stop all services and also delete data:
```bash
# Stop the docker containers
laconic-so deployment --dir fixturenet-laconicd-deployment stop --delete-volumes
# Remove deployment directory (deployment will have to be recreated for a re-run)
rm -r fixturenet-laconicd-deployment
```