fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd
2024-06-20 10:15:43 +05:30
..
README.md Add stack instructions for fixturenet stack 2024-06-20 10:15:43 +05:30
stack.yml Add stack instructions for fixturenet stack 2024-06-20 10:15:43 +05:30

fixturenet-laconicd-stack

Setup

  • Clone the stack repo

    laconic-so fetch-stack git.vdb.to/cerc-io/fixturenet-laconicd-stack
    
  • Clone required repositories:

    laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd setup-repositories
    
  • Build the container images:

    laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd build-containers
    

Create a deployment

  • Create a spec file for the deployment:

    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:

    ...
    network:
      ports:
        laconicd:
          - '6060:6060'
          - '26657:26657'
          - '26656:26656'
          - '9473:9473'
          - '9090:9090'
          - '1317:1317'
    
  • Create a deployment from the spec file:

    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
    
  • Copy over the published testnet genesis file (.json) to data directory in deployment (fixturenet-laconicd-deployment/data/laconicd-data/tmp):

    # Example
    mkdir -p fixturenet-laconicd-deployment/data/laconicd-data/tmp
    cp genesis.json fixturenet-laconicd-deployment/data/laconicd-data/tmp/genesis.json
    

Start the deployment

laconic-so deployment --dir fixturenet-laconicd-deployment start

Check status

  • To list down and monitor the running containers:

    # With status
    docker ps -a
    
    # Follow logs for laconicd container
    laconic-so deployment --dir fixturenet-laconicd-deployment logs laconicd -f
    
  • Check the sync status of your node:

    laconic-so deployment --dir fixturenet-laconicd-deployment exec laconicd "laconicd status | jq .sync_info"
    
    # `catching_up: false` indicates that node is completely synced
    

Clean up

  • Stop all services running in the background:

    # Stop the docker containers
    laconic-so deployment --dir fixturenet-laconicd-deployment stop
    
  • To stop all services and also delete data:

    # 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