cerc-io/laconicd-stack
13
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
cb1853f140
laconicd-stack/docs/update-deployments.md
shreerang de553ebcd3 Add instructions to update deployments (#18) 
Part of https://www.notion.so/Create-stacks-for-mainnet-1f2a6b22d4728034be4be2c51decf94e

Co-authored-by: Shreerang Kale <shreerangkale@gmail.com>
Co-authored-by: Prathamesh Musale <prathamesh.musale0@gmail.com>
Reviewed-on: #18
Co-authored-by: shreerang <shreerang@noreply.git.vdb.to>
Co-committed-by: shreerang <shreerang@noreply.git.vdb.to>
2025-06-13 14:10:07 +00:00

9.8 KiB
Raw Blame History

Update Deployments

Instructions to reset / update the deployments

Login

  • Log in as dev user on the deployments VM

  • All the deployments are placed in the /srv directory:

    cd /srv

laconic-wallet-web

  • Deployment dir: /srv/wallet/laconic-wallet-web-deployment

  • If code has changed, fetch and build with updated source code:

    # testnet-onboarding-app source
cd ~/cerc/laconic-wallet-web

# Pull latest changes
git pull

# Checkout to the latest tag (https://git.vdb.to/LaconicNetwork/laconic-wallet-web/tags)
git checkout <tag>

# Rebuild the containers
cd /srv/wallet

laconic-so --stack ~/cerc/laconic-wallet-web/stack/stack-orchestrator/stack/laconic-wallet-web build-containers --force-rebuild

  • Update the configuration laconic-wallet-web-deployment/config.env:

    # URL for the deploy app so that wallet can work with it
CERC_ALLOWED_URLS=https://deploy.laconic.com,https://store.laconic.com

# RPC URL for the mainnet node
CERC_LACONICD_RPC_URL="https://laconicd-mainnet.laconic.com"

  • Restart the deployment:

    laconic-so deployment --dir laconic-wallet-web-deployment stop

laconic-so deployment --dir laconic-wallet-web-deployment start

# Follow logs for laconic-wallet-web container, wait for the build to finish
laconic-so deployment --dir laconic-wallet-web-deployment logs laconic-wallet-web -f

  • The web wallet can now be viewed at https://wallet.laconic.com

  • Add laconic-mainnet network by clicking on Add Network and filling in required details

laconic-console

  • Deployment dir: /srv/console/laconic-console-deployment

  • If code has changed, fetch and build with updated source code:

    # testnet-onboarding-app source
cd ~/cerc/laconic-console

# Pull latest changes
git pull

# Checkout to the latest tag (https://git.vdb.to/cerc-io/laconic-console/tags)
git checkout <tag>

# Rebuild the containers
cd /srv/console

laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console build-containers --force-rebuild

  • Update the configuration, if required in laconic-console-deployment/config.env:

    # Laconicd (hosted) GQL endpoint
LACONIC_HOSTED_ENDPOINT=https://laconicd-mainnet.laconic.com/graphql

  • Restart the deployment:

    laconic-so deployment --dir laconic-console-deployment stop

laconic-so deployment --dir laconic-console-deployment start

# Follow logs for console container
laconic-so deployment --dir laconic-console-deployment logs console -f

  • The laconic console can now be viewed at https://console-mainnet.laconic.com

Laconic Shopify

  • Deployment dir: /srv/shopify/laconic-shopify-deployment

  • If code has changed, fetch and build with updated source code:

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

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

  • Update the configuration if required in laconic-shopify-deployment/config.env:

    # laconicd RPC endpoint
CERC_LACONICD_RPC_ENDPOINT=https://laconicd-mainnet.laconic.com

# laconicd chain id
CERC_LACONICD_CHAIN_ID=laconic-mainnet

  • Restart the deployment:

    cd /srv/shopify

laconic-so deployment --dir laconic-shopify-deployment stop

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

Webapp Deployer

  • Fetch latest stack repos:

    # In directory where webapp-deployer deployment was created
laconic-so --stack webapp-deployer-backend setup-repositories --pull

# Confirm latest commit hash in the ~/cerc/webapp-deployment-status-api repo

  • Rebuild container images if there are any changes:

    laconic-so --stack webapp-deployer-backend build-containers --force-rebuild

  • Push stack images to the container registry:

    • Login to the container registry:

      # Set required variables
CONTAINER_REGISTRY_URL=container-registry.apps.vaasl.io
# For credentials: "cat /srv/service-provider/webapp-deployer/config.env | grep IMAGE_REGISTRY"
CONTAINER_REGISTRY_USERNAME=
CONTAINER_REGISTRY_PASSWORD=

# login to container registry
docker login $CONTAINER_REGISTRY_URL --username $CONTAINER_REGISTRY_USERNAME --password $CONTAINER_REGISTRY_PASSWORD

# WARNING! Using --password via the CLI is insecure. Use --password-stdin.
# WARNING! Your password will be stored unencrypted in /home/dev2/.docker/config.json.
# Configure a credential helper to remove this warning. See
# https://docs.docker.com/engine/reference/commandline/login/#credential-stores

# Login Succeeded

    • Push images:

      laconic-so deployment --dir webapp-deployer push-images

  • Update deployer laconic registry config (webapp-deployer/data/config/laconic.yml) with new endpoints:

    services:
  registry:
    rpcEndpoint: "https://laconicd-mainnet.laconic.com"
    gqlEndpoint: "https://laconicd-mainnet.laconic.com/api"
    userKey: "<userKey>"
    bondId: "<bondId>"
    chainId: laconic-mainnet
    gasPrice: 0.001alnt

    Note: Existing userKey and bondId can be used since they are carried over from SAPO testnet to mainnet

  • Update any deployer config (webapp-deployer/config.env) if required

  • Start the webapp deployer:

    laconic-so deployment --dir webapp-deployer start

  • Get the webapp-deployer pod id:

    laconic-so deployment --dir webapp-deployer ps

# Expected output
# Running containers:
# id: default/laconic-096fed46af974a47-deployment-644db859c7-snbq6, name: laconic-096fed46af974a47-deployment-644db859c7-snbq6, ports: 10.42.2.11:9555->9555

# Set pod id
export POD_ID=

# Example:
# export POD_ID=laconic-096fed46af974a47-deployment-644db859c7-snbq6

  • Copy over GPG keys files to the webapp-deployer container:

    kubie ctx default

# Copy the GPG key files to the pod
kubectl cp <path-to-your-gpg-private-key> $POD_ID:/app
kubectl cp <path-to-your-gpg-public-key> $POD_ID:/app

# Required everytime you stop and start the deployer

  • Check logs:

    # Deployer
kubectl logs -f $POD_ID

# Deployer auction handler
kubectl logs -f $POD_ID -c cerc-webapp-auction-handler

  • Update deployer UI config (webapp-ui/config.env):

    # URL of the laconic console
LACONIC_HOSTED_CONFIG_app_console_link=https://console-mainnet.laconic.com

  • Start the webapp UI:

    laconic-so deployment --dir webapp-ui start

  • Check logs

    laconic-so deployment --dir webapp-ui logs webapp

Deploy Backend

  • Deployment dir: /srv/deploy-backend/laconic-backend-deployment

  • If code has changed, fetch and build with updated source code:

    laconic-so --stack ~/cerc/snowballtools-base-api-stack/stack-orchestrator/stacks/snowballtools-base-backend setup-repositories --git-ssh --pull

# rebuild containers
laconic-so --stack ~/cerc/snowballtools-base-api-stack/stack-orchestrator/stacks/snowballtools-base-backend build-containers --force-rebuild

  • Push updated images to the container registry:

    cd /srv/deploy-backend

# login to container registry
CONTAINER_REGISTRY_URL=container-registry.apps.vaasl.io
# For credentials: "cat /srv/service-provider/webapp-deployer/config.env | grep IMAGE_REGISTRY"
CONTAINER_REGISTRY_USERNAME=
CONTAINER_REGISTRY_PASSWORD=

docker login $CONTAINER_REGISTRY_URL --username $CONTAINER_REGISTRY_USERNAME --password $CONTAINER_REGISTRY_PASSWORD

# Push backend images
laconic-so deployment --dir laconic-backend-deployment push-images

  • Update the configuration if required in laconic-backend-deployment/configmaps/config/prod.toml:

    ...
[registryConfig]
  fetchDeploymentRecordDelay = 5000
  checkAuctionStatusDelay = 5000
  restEndpoint = "https://laconicd-mainnet.laconic.com"
  gqlEndpoint = "https://laconicd-mainnet.laconic.com/api"
  chainId = "laconic-mainnet"
  privateKey = "<private-key>"
  bondId = "<bond-id>"
  authority = "laconic-deploy"
  [registryConfig.fee]
    gasPrice = "0.001alnt"
...

  • Restart the deployment:

    laconic-so deployment --dir laconic-backend-deployment stop

laconic-so deployment --dir laconic-backend-deployment start

Deploy Frontend

Prerequisites

  • Node.js

  • Yarn

Setup

  • On your local machine, clone the snowballtools-base repo:

    git clone git@git.vdb.to:cerc-io/snowballtools-base.git

  • Install dependencies:

    cd snowballtools-base
yarn install

  • In the deployer package, create required env:

    cd packages/deployer
cp .env.example .env

    Set the required variables:

    REGISTRY_BOND_ID=<bond-id>
DEPLOYER_LRN=lrn://vaasl-provider/deployers/webapp-deployer-api.apps.vaasl.io
AUTHORITY=laconic-deploy

    Note: The bond id should be set to the laconic-deploy authority

  • Update required laconic config. You can use the same userKey and bondId used for deploying backend:

    # Replace <user-pk> and <bond-id>
cat <<EOF > config.yml
services:
  registry:
    rpcEndpoint: https://laconicd-mainnet.laconic.com
    gqlEndpoint: https://laconicd-mainnet.laconic.com/api
    userKey: <user-pk>
    bondId: <bond-id>
    chainId: laconic-mainnet
    gasPrice: 0.001alnt
EOF

    Note: The userKey account should own the authority laconic-deploy

Run

  • Run frontend deployment script:

    ./deploy-frontend.sh

    Follow deployment logs on the deployer UI

  • On a successful deployment, the frontend can be viewed at https://deploy.laconic.com