testnet-laconicd-stack/service-provider.md at d84e4089f70d96bd153e410aa5b9a3acb1428f35

Adw8 d84e4089f7 Remove redundant steps

2024-10-30 12:35:47 +05:30

11 KiB

Raw Blame History

Set up a new service provider

Follow steps from https://git.vdb.to/cerc-io/testnet-ops/src/branch/main/service-provider-setup#service-provider-setup to setup a service provider. After setup, the following services will be running (your configuration will look similar to the examples listed below):

laconicd chain RPC endpoint: http://lcn-daemon.laconic.com:26657
laconicd GQL endpoint: http://lcn-daemon.laconic.com:9473/api
laconic console: http://lcn-console.laconic.com:8080/registry
webapp deployer API: https://webapp-deployer-api.pwa.laconic.com
webapp deployer UI: https://webapp-deployer-ui.pwa.laconic.com

Update webapp deployer

Stop the deployer

cd <path-to-deployments>
laconic-so deployment --dir webapp-deployer stop
laconic-so deployment --dir webapp-ui stop

Fetch and build webapp deployer backend

# Update code for webapp-deployer backend
cd ~/cerc/webapp-deployment-status-api

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

# Confirm the latest commit hash
git log

# Rebuild the containers
laconic-so --stack webapp-deployer-backend build-containers --force-rebuild

Push images to the container registry

# Set required variables
CONTAINER_REGISTRY_URL=
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 to container registry

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

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

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

Note: Same userKey and bondId can be used since they are carried over from laconicd stage1 to testnet2

Publish the webapp deployer record on the chain if it doesn't already exist

Set the following variables

# Path to the webapp-deployer directory
# eg: /home/dev/webapp-deployer
DEPLOYER_DIR=
# API URL of the webapp-deployer
# eg: "https://webapp-deployer-ui.pwa.laconic.com"
API_URL=
# LRN (logical resource name) of the webapp-deployer
# eg: "lrn://laconic/deployers/webapp-deployer-api.laconic.com"
DEPLOYER_LRN=
# Name of the GPG public key file
# eg: "webapp-deployer-api.laconic.com.pgp.pub"
GPG_PUB_KEY_FILE=
# Path of the GPG public key file
# eg: "/home/dev/webapp-deployer-api.laconic.com.pgp.pub"
GPG_PUB_KEY_FILE_PATH=

Copy the GPG pub key file used while setting up the webapp-deployer to the webapp-deployer/data/config directory. This ensures the Docker container has access to the key during the publish process.
```
cp $GPG_PUB_KEY_FILE_PATH webapp-deployer/data/config
```

Publish the deployer record

docker run -i -t \
-v $DEPLOYER_DIR/data/config:/home/root/config \
cerc/webapp-deployer-backend:local laconic-so publish-deployer-to-registry \
  --laconic-config /home/root/config/laconic.yml \
  --api-url $API_URL \
  --public-key-file /home/root/config/$GPG_PUB_KEY_FILE \
  --lrn $DEPLOYER_LRN \
  --min-required-payment 0

Update webapp-deployer/config.env

# Update the webapp deployer lrn if it has changed
LRN=
# Add the following so the webapp deployer will support auction requests
export HANDLE_AUCTION_REQUESTS=true
# Amount that the webapp deployer will bid on auctions
export AUCTION_BID_AMOUNT=50000

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 the GPG key file to the webapp-deployer container

# 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

Check logs

laconic-so deployment --dir webapp-deployer logs cerc-webapp-deployer

Update webapp-ui/config.env

# URL of the webapp deployer backend
LACONIC_HOSTED_CONFIG_app_api_url=
# URL of the laconic console
LACONIC_HOSTED_CONFIG_app_console_link=https://console-sapo.laconic.com

Start the webapp ui

laconic-so deployment --dir webapp-ui start

Check logs

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

Connect webapp-deployer to testnet2

Follow the steps given below to connect the webapp-deployer to testnet2

Update laconic console config

Stop webapp deployer

laconic-so deployment --dir webapp-deployer stop
laconic-so deployment --dir webapp-ui 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, can be pointed to your validator node
# eg: http://console-testnet2.laconic.com
CERC_LACONICD_RPC_ENDPOINT=

# GQL endpoint of the chain, can be pointed to your validator node
# eg: https://laconicd-sapo.laconic.com/api
CERC_LACONICD_GQL_ENDPOINT=

# laconicd chain id
CERC_LACONICD_CHAIN_ID=laconic-testnet-2

# Endpoint for the console
# eg: https://laconic-console.example.com
LACONIC_HOSTED_ENDPOINT=

Note: Follow steps from Join as a validator on stage1 to setup your validator node

Start the laconic-console-deployment

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

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"}

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-testnet-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-testnet-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

Follow steps from Update webapp deployer to publish the deployer record to the chain

Update config for webapp deployer

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

# Name of reserved authority
DEPLOYMENT_RECORD_NAMESPACE="<authority_name>"

Update webapp-ui/config.env with the updated endpoints

# api url of webapp deployer
LACONIC_HOSTED_CONFIG_app_api_url=
# url of laconic console
LACONIC_HOSTED_CONFIG_app_console_link=https://console-sapo.laconic.com

Start the deployer

Start the webapp deployer backend

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 the GPG key file to the webapp-deployer container

# 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

Check logs

laconic-so deployment --dir webapp-deployer logs cerc-webapp-deployer

Start the webapp deployer ui

laconic-so deployment --dir webapp-ui start

Check logs

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

11 KiB Raw Blame History

Set up a new service provider

Update webapp deployer

Connect webapp-deployer to testnet2

Update laconic console config

Register an authority

Publish record for webapp-deployer

Update config for webapp deployer

Start the deployer

11 KiB

Raw Blame History