testnet-laconicd-stack/stack-orchestrator/stacks/laconic-shopify

laconic-shopify

Instructions for running the laconic shopify

Setup

• Clone the stack repo:

  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
  

• Clone the laconic-shopify respository:

  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-shopify setup-repositories
  

• Build the container image:

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

  This should create the cerc/laconic-shopify-faucet image locally

Create a deployment

• Create a spec file for the deployment:

  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-shopify deploy init --output laconic-shopify-spec.yml
  

• Create a deployment from the spec file:

  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-shopify deploy create --spec-file laconic-shopify-spec.yml --deployment-dir laconic-shopify-deployment
  

Configuration

• Inside the laconic-shopify-deployment deployment directory, open config.env file and set following env variables:

  # Shopify GraphQL URL
  CERC_SHOPIFY_GRAPHQL_URL='https://6h071x-zw.myshopify.com/admin/api/2024-10/graphql.json'
  
  # Access token for Shopify API
  CERC_SHOPIFY_ACCESS_TOKEN=
  
  # Delay for fetching orders in milliseconds
  CERC_FETCH_ORDER_DELAY=10000
  
  # URL for the laconic faucet
  CERC_FAUCET_URL='http://host.docker.internal:3000/'
  
  # Number of line items per order in Get Orders GraphQL query
  CERC_ITEMS_PER_ORDER=10
  

Start the deployment

laconic-so deployment --dir laconic-shopify-deployment start

Check status

• To list down and monitor the running container:

  # With status
  docker ps
  
  # Check logs for a container
  docker logs -f <CONTAINER_ID>
  

Clean up

• Stop the laconic-shopify-faucet service running in the background:

  # Stop the docker container
  laconic-so deployment --dir laconic-shopify-deployment stop
  

• To stop the service and also delete data:

  # Stop the docker containers
  laconic-so deployment --dir laconic-shopify-deployment stop --delete-volumes
  
  # Remove deployment directory (deployment will have to be recreated for a re-run)
  rm -r laconic-shopify-deployment