Deploying

Search…
Deploying
Deploying a THORNode and its associated services.
Deploy THORNode services
Now you have a Kubernetes cluster ready to use, you can install the THORNode services.
Helm charts are the defacto and currently easiest and simple way to package and deploy Kubernetes application. The team created different Helm charts to help to deploy all the necessary services. Please retrieve the source files from the Git repository here to follow the instructions below:
**** https://gitlab.com/thorchain/devops/node-launcher****
Requirements
Running Kubernetes cluster
Kubectl configured, ready and connected to running cluster
If you came here from the Setup page, you are already good to go.
Steps
Clone the node-launcher repo. All commands in this section are to be run inside of this repo.
1
git clone https://gitlab.com/thorchain/devops/node-launcher
2
cd node-launcher
3
git checkout master
Copied!
Install Helm 3
Install Helm 3 if not already available on your current machine:
1
make helm
2
make helm-plugins
Copied!
Tools
Deploy
Destroy
To deploy all tools, metrics, logs management, Kubernetes Dashboard, run the command below.
1
make tools
Copied!
To destroy all those resources run the command below.
1
make destroy-tools
Copied!
If you are successful, you will see the following message:
If there are any errors, they are typically fixed by running the command again.
Deploy THORNode
It is important to deploy the tools first before deploying the THORNode services as some services will have metrics configuration that would fail and stop the THORNode deployment.
You have multiple commands available to deploy different configurations of THORNode. You can deploy testnet or chaosnet/mainnet. The commands deploy the umbrella chart thornode-stack in the background in the Kubernetes namespace thornode (or thornode-testnet for testnet) by default.
1
make install
Copied!
If you are intending to run all chain clients, bond in & earn rewards, you want to choose "Validator".
Deploying a THORNode will take 1 day for every 3 months of ledger history, since it will validate every block. THORNodes are "full nodes", not light clients.
If successful, you will see the following:
You are now ready to join the network:
Joining
Debugging
Set thornode to be your default namespace so you don't need to type -n thornode each time:
kubectl config set-context --current --namespace=thornode
Use the following useful commands to view and debug accordingly. You should see everything running and active. Logs can be retrieved to find errors:
1
kubectl get pods -n thornode
2
kubectl get pods --all-namespaces
3
kubectl logs -f <pod> -n thornode
Copied!
Kubernetes should automatically restart any service, but you can force a restart by running:
1
kubectl delete pod <pod> -n thornode
Copied!
Note, to expedite syncing external chains, it is feasible to continually delete the pod that has the slow-syncing chain daemon (eg, binance-daemon-xxx).
Killing it will automatically restart it with free resources and syncing is notably faster. You can check sync status by viewing logs for the client to find the synced chain tip and comparing it with the real-world blockheight, ("xxx" is your unique ID):
1
kubectl logs -f binance-daemon-xxx -n thornode
Copied!
Get real-world blockheights on the external blockchain explorers, eg:
https://testnet-explorer.binance.org/​
​https://explorer.binance.org/​
CHART SUMMARY
THORNode full stack umbrella chart
thornode: Umbrella chart packaging all services needed to run a fullnode or validator THORNode.
This should be the only chart used to run THORNode stack unless you know what you are doing and want to run each chart separately (not recommended).
THORNode services:
thor-daemon: THORNode daemon
thor-api: THORNode API
thor-gateway: THORNode gateway proxy to get a single IP address for multiple deployments
bifrost: Bifrost service
midgard: Midgard API service
External services:
binance-daemon: Binance fullnode daemon
bitcoin-daemon: Bitcoin fullnode daemon
ethereum-daemon: Ethereum fullnode daemon
chain-daemon: as required for supported chains
Tools
elastic: ELK stack, deperecated. Use elastic-operator chart
elastic-operator: ELK stack using operator for logs management
prometheus: Prometheus stack for metrics
loki: Loki stack for logs
kubernetes-dashboard: Kubernetes dashboard
Setup - AWS
Next - THORNodes
Joining
Last modified 4mo ago
Export as PDF
Copy link
Edit on GitHub
Contents
Deploy THORNode services