deep-stack/testnet-laconicd-stack
3
0
Fork 0
forked from cerc-io/testnet-laconicd-stack
Code Pull Requests Activity
feb7e04f28
testnet-laconicd-stack/ops/update-deployments.md

12 KiB
Raw Blame History

Update deployments after code changes

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

stage0 laconicd

  • Deployment dir: /srv/laconicd/stage0-deployment

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

    # laconicd source
cd ~/cerc/laconicd

# Pull latest changes, or checkout to the required branch
git pull

# Confirm the latest commit hash
git log

# Rebuild the containers
cd /srv/laconicd

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

  • Optionally, reset the data directory (this will remove all stage0 data!):

    # Stop the deployment
laconic-so deployment --dir stage0-deployment stop --delete-volumes

# Remove and recreate the required data dir
sudo rm -rf stage0-deployment/data/laconicd-data
mkdir stage0-deployment/data/laconicd-data

  • Start the deployment:

    laconic-so deployment --dir stage0-deployment start

# Follow logs for laconicd container, check that new blocks are getting created
laconic-so deployment --dir stage0-deployment logs laconicd -f

  • If the stage0 laconicd chain has been reset, reset the faucet deployment too with new faucet key:

    cd /srv/faucet

export FAUCET_ACCOUNT_PK=$(laconic-so deployment --dir /srv/laconicd/stage0-deployment exec laconicd "echo y | laconicd keys export alice --keyring-backend test --unarmored-hex --unsafe")

cat <<EOF > laconic-faucet-deployment/config.env
CERC_FAUCET_KEY=$FAUCET_ACCOUNT_PK
EOF

# Stop the deployment
laconic-so deployment --dir laconic-faucet-deployment stop --delete-volumes

# Remove and recreate the required data dir
sudo rm -rf laconic-faucet-deployment/data/faucet-data
mkdir laconic-faucet-deployment/data/faucet-data

# Start the deployment
laconic-so deployment --dir laconic-faucet-deployment start

testnet-onboarding-app

  • Deployment dir: /srv/app/onboarding-app-deployment

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

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

# Pull latest changes, or checkout to the required branch
git pull

# Confirm the latest commit hash
git log

# Rebuild the containers
cd /srv/app

laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app build-containers --force-rebuild

  • Update the configuration, if required in onboarding-app-deployment/config.env:

    WALLET_CONNECT_ID=63...

CERC_REGISTRY_GQL_ENDPOINT="https://laconicd.laconic.com/api"
CERC_LACONICD_RPC_ENDPOINT="https://laconicd.laconic.com"

CERC_FAUCET_ENDPOINT="https://faucet.laconic.com"

CERC_WALLET_META_URL="https://loro-signup.laconic.com"

CERC_STAKING_AMOUNT=1000000000000000

  • Restart the deployment:

    laconic-so deployment --dir onboarding-app-deployment stop

laconic-so deployment --dir onboarding-app-deployment start

# Follow logs for testnet-onboarding-app container, wait for the build to finish
laconic-so deployment --dir onboarding-app-deployment logs testnet-onboarding-app -f

  • The updated onboarding app can now be viewed at https://loro-signup.laconic.com

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, or checkout to the required branch
git pull

# Confirm the latest commit hash
git log

# 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, if required in laconic-wallet-web-deployment/config.env:

    WALLET_CONNECT_ID=63...

  • 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

stage1 laconicd

  • Deployment dir: /srv/laconicd/stage1-deployment

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

    # laconicd source
cd ~/cerc/laconicd

# Pull latest changes, or checkout to the required branch
git pull

# Confirm the latest commit hash
git log

# Rebuild the containers
cd /srv/laconicd

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

  • Optionally, reset the data directory:

    # Stop the deployment
laconic-so deployment --dir stage1-deployment stop --delete-volumes

# Remove and recreate the required data dirs
sudo rm -rf stage1-deployment/data/laconicd-data stage1-deployment/data/genesis-config

mkdir stage1-deployment/data/laconicd-data
mkdir stage1-deployment/data/genesis-config

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

    AUTHORITY_AUCTION_ENABLED=true
AUTHORITY_AUCTION_COMMITS_DURATION=3600
AUTHORITY_AUCTION_REVEALS_DURATION=3600
AUTHORITY_GRACE_PERIOD=7200

  • Follow stage0-to-stage1.md to generate the genesis file for stage1 and start the deployment

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, or checkout to the required branch
git pull

# Confirm the latest commit hash
git log

# 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.laconic.com

  • 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://loro-console.laconic.com

Connect webapp-deployer with stage2 laconicd chain

Follow the steps given below to connect the webapp-deployer to stage2 laconicd

Update laconic console config

Update laconic console config

  • Stop webapp deployer backend

    laconic-so deployment --dir webapp-deployer stop

  • Stop laconic-console and fixturenet-laconicd deployment

    laconic-so deployment --dir fixturenet-laconicd-deployment stop
laconic-so deployment --dir laconic-console-deployment stop

  • Update laconic-console-deployment/config.env with the following config

    # private key to your funded account
CERC_LACONICD_USER_KEY=

# This will be updated later
CERC_LACONICD_BOND_ID=

# RPC endpoint of the chain
CERC_LACONICD_RPC_ENDPOINT=https://laconicd.laconic.com

# GQL endpoint of the chain
CERC_LACONICD_GQL_ENDPOINT=https://laconicd.laconic.com/api

# laconicd chain id
CERC_LACONICD_CHAIN_ID=laconic_9000-2

# Endpoint for the console
LACONIC_HOSTED_ENDPOINT=https://laconicd.laconic.com

  • Start the laconic-console-deployment:

    laconic-so deployment --dir laconic-console-deployment start
Register an authority

Register an authority

  • Create a bond

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry bond create --type alnt --quantity 100000000000"
# {"bondId":"a742489e5817ef274187611dadb0e4284a49c087608b545ab6bd990905fb61f3"}

  • Register an authority

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry authority reserve <authority_name>"

  • Obtain the auction ID

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry authority whois <authority_name>"
# "auction": {
#   "id": "73e0b082a198c396009ce748804a9060c674a10045365d262c1584f99d2771c1"

  • Commit a bid using the auction ID. A reveal file will be generated

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry auction bid commit 73e0b082a198c396009ce748804a9060c674a10045365d262c1584f99d2771c1 5000000 alnt --chain-id laconic_9000-2"

# {"reveal_file":"/app/out/bafyreiewi4osqyvrnljwwcb36fn6sr5iidfpuznqkz52gxc5ztt3jt4zmy.json"}

  • Reveal a bid using the auction ID and the reveal file generated from the bid commit

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry auction bid reveal 73e0b082a198c396009ce748804a9060c674a10045365d262c1584f99d2771c1 /app/out/bafyreiewi4osqyvrnljwwcb36fn6sr5iidfpuznqkz52gxc5ztt3jt4zmy.json --chain-id laconic_9000-2"
# {"success": true}

  • Verify status after the auction ends. It should list a completed status and a winner

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry auction get 73e0b082a198c396009ce748804a9060c674a10045365d262c1584f99d2771c1"

  • Set the authority using a bond ID.

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry authority bond set <authority_name> a742489e5817ef274187611dadb0e4284a49c087608b545ab6bd990905fb61f3"
# {"success": true}

  • Verify the authority has been registered.

    laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry authority whois <authority_name>"

  • Stop the laconic-console-deployment

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

  • Update CERC_LACONICD_BOND_ID in laconic-console-deployment/config.env with the bond that was created

    ...
CERC_LACONICD_BOND_ID=a742489e5817ef274187611dadb0e4284a49c087608b545ab6bd990905fb61f3
...

  • Start the laconic-console-deployment:

    laconic-so deployment --dir laconic-console-deployment start
Publish record for webapp-deployer

Publish record for webapp-deployer

  • Update webapp-deployer/data/config/laconic.yml with the

    services:
registry:
  # laconicd RPC endpoint
  rpcEndpoint: 'https://laconicd.laconic.com'

  # laconicd GQL endpoint
  gqlEndpoint: 'https://laconicd.laconic.com/api'

  # Key to your funded account
  userKey:

  # bondId that you just created
  bondId: a742489e5817ef274187611dadb0e4284a49c087608b545ab6bd990905fb61f3

  # laconicd chain id
  chainId: laconic_9000-2
  gas: 200000
  fees: 500000alnt

  • Publish the webapp deployer record using the publish-deployer-to-registry command

    laconic-so publish-deployer-to-registry \
--laconic-config webapp-deployer/data/config/laconic.yml \
--api-url <api-url-for-your-deployer>
--public-key-file <path-to-your-gpg-pub-key> \
--lrn <lrn-for-your-deployer>  \
--min-required-payment 0

  • Update webapp-deployer/config.env with the authority that you reserved

    # Name of reserved authority
DEPLOYMENT_RECORD_NAMESPACE="<authority_name>"
Start the deployer

Start the deployer

  • Start the webapp deployer

    laconic-so deployment --dir webapp-deployer start

  • Get the most recent pod id:

    kubie ctx default
kubectl get pods

  • Copy the GPG key file to the webapp-deployer container:

    # Get the webapp-deployer pod id
kubectl get pods --sort-by=.metadata.creationTimestamp -o jsonpath='{.items[-1].metadata.name}'
# laconic-ac473c31db9ac9fd-deployment-674bf7bf9f-529bs

# Copy the GPG key files to the pod
kubectl cp <path-to-your-gpg-private-key> laconic-ac473c31db9ac9fd-deployment-674bf7bf9f-529bs:/app
kubectl cp <path-to-your-gpg-public-key> laconic-ac473c31db9ac9fd-deployment-674bf7bf9f-529bs:/app