411 lines
12 KiB
Markdown
411 lines
12 KiB
Markdown
## 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
|
|
|
|
```bash
|
|
cd <path-to-deployments>
|
|
laconic-so deployment --dir webapp-deployer stop
|
|
laconic-so deployment --dir webapp-ui stop
|
|
```
|
|
|
|
* Fetch and build webapp deployer backend
|
|
|
|
```bash
|
|
# 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
|
|
|
|
* Login to the container registry
|
|
|
|
```bash
|
|
# Set required variables
|
|
# eg: container-registry.pwa.laconic.com
|
|
CONTAINER_REGISTRY_URL=
|
|
# eg: dev
|
|
CONTAINER_REGISTRY_USERNAME=
|
|
# eg: password
|
|
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
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-deployer push-images
|
|
```
|
|
|
|
* Update `webapp-deployer/data/config/laconic.yml` with the new endpoints
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# Path to the webapp-deployer directory
|
|
# eg: /home/dev/webapp-deployer
|
|
DEPLOYER_DIR=
|
|
# API URL of the webapp-deployer
|
|
# eg: "https://webapp-deployer-api.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.
|
|
|
|
```bash
|
|
cp $GPG_PUB_KEY_FILE_PATH webapp-deployer/data/config
|
|
```
|
|
|
|
* Publish the deployer record
|
|
|
|
```bash
|
|
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 9500
|
|
```
|
|
|
|
* Update `webapp-deployer/config.env`
|
|
|
|
```bash
|
|
# 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=9500
|
|
```
|
|
|
|
* Start the webapp deployer
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-deployer start
|
|
```
|
|
|
|
* Get the webapp-deployer pod id
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-deployer logs cerc-webapp-deployer
|
|
```
|
|
|
|
* Update `webapp-ui/config.env`
|
|
|
|
```bash
|
|
# URL of the webapp deployer backend
|
|
# eg: https://webapp-deployer-api.pwa.laconic.com
|
|
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
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-ui start
|
|
```
|
|
|
|
* Check logs
|
|
|
|
```bash
|
|
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
|
|
|
|
<details open>
|
|
<summary>Update laconic console config</summary>
|
|
|
|
### Update laconic console config
|
|
|
|
* Stop webapp deployer
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-deployer stop
|
|
laconic-so deployment --dir webapp-ui stop
|
|
```
|
|
|
|
* Stop laconic-console and fixturenet-laconicd deployment
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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: https://laconicd-sapo.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](./testnet-onboarding-validator.md#join-as-a-validator-on-stage1) to setup your validator node
|
|
|
|
* Start the `laconic-console-deployment`
|
|
|
|
```bash
|
|
laconic-so deployment --dir laconic-console-deployment start
|
|
```
|
|
</details>
|
|
|
|
<details open>
|
|
<summary>Register an authority</summary>
|
|
|
|
### Register an authority
|
|
|
|
* Create a bond
|
|
|
|
```bash
|
|
laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry bond create --type alnt --quantity 100000000000"
|
|
# {"bondId":"a742489e5817ef274187611dadb0e4284a49c087608b545ab6bd990905fb61f3"}
|
|
```
|
|
|
|
* Register an authority
|
|
|
|
```bash
|
|
laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry authority reserve <authority_name>"
|
|
```
|
|
|
|
* Obtain the auction ID
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry authority whois <authority_name>"
|
|
```
|
|
|
|
* Stop the laconic-console-deployment
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
...
|
|
CERC_LACONICD_BOND_ID=a742489e5817ef274187611dadb0e4284a49c087608b545ab6bd990905fb61f3
|
|
...
|
|
```
|
|
|
|
* Start the `laconic-console-deployment`
|
|
|
|
```bash
|
|
laconic-so deployment --dir laconic-console-deployment start
|
|
```
|
|
|
|
</details>
|
|
|
|
<details open>
|
|
<summary>Publish record for webapp-deployer</summary>
|
|
|
|
### Publish record for webapp-deployer
|
|
|
|
Follow steps from [Update webapp deployer](#update-webapp-deployer) to publish the deployer record to the chain
|
|
|
|
<details open>
|
|
<summary>Update config for webapp deployer</summary>
|
|
|
|
### Update config for webapp deployer
|
|
|
|
* Update `webapp-deployer/config.env` with the authority that you reserved
|
|
|
|
```bash
|
|
# Name of reserved authority
|
|
DEPLOYMENT_RECORD_NAMESPACE="<authority_name>"
|
|
```
|
|
|
|
* Update `webapp-ui/config.env` with the updated endpoints
|
|
|
|
```bash
|
|
# api url of webapp deployer
|
|
# eg: https://webapp-deployer-api.pwa.laconic.com
|
|
LACONIC_HOSTED_CONFIG_app_api_url=
|
|
# url of laconic console
|
|
LACONIC_HOSTED_CONFIG_app_console_link=https://console-sapo.laconic.com
|
|
```
|
|
</details>
|
|
|
|
<details open>
|
|
<summary>Start the deployer</summary>
|
|
|
|
### Start the deployer
|
|
|
|
* Start the webapp deployer backend
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-deployer start
|
|
```
|
|
|
|
* Get the webapp-deployer pod id
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-deployer logs cerc-webapp-deployer
|
|
```
|
|
|
|
* Start the webapp deployer ui
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-ui start
|
|
```
|
|
|
|
* Check logs
|
|
|
|
```bash
|
|
laconic-so deployment --dir webapp-ui logs webapp
|
|
```
|
|
|
|
</details>
|