universal-helm

This repository contains the universal-helm Helm chart, which can generate Kubernetes manifests to deploy and expose a blockchain node using Ingress.

Motivation to Use a Common Helm Chart for All Blockchain Nodes

Pros:

• More DRY Infra as Code: All blockchain nodes share a significant amount of configuration, which is generalized in this Helm chart.
• Easier Infra as Code Development: Using the same Helm chart for all nodes allows changes to be made in one place to bring new features or fix bugs for all nodes.
• Unified Code and Naming Conventions: All nodes follow the same code and naming conventions specified in the Helm chart, resulting in a more uniform infrastructure that is easier to read and develop.

Cons:

• Increased Configuration Items: Due to generalization, nodes' configurations include more items, resulting in more lines of code.

Structure of the Repository

The Helm chart includes templates for the following objects:

• StatefulSets: Deploys blockchain node containers. Init containers can be used to download snapshots, initialize data, etc. It will also automatically add a sidecar container with health probes to check the node's status.
• Services: Generated for each container's port.
• Ingresses: Exposes ports to the outside world; see example.

Example node configurations can be found in the following files:

• example--upshot-index-provider.yaml

How to:

Generate Kubernetes Manifests of a Node with the Helm Chart

To generate manifests of a node described in example--upshot-index-provider.yaml, run the following command:

helm template \
  solana \
  helm/blockchain-node \
  -f example--upshot-index-provider.yaml

You will see the generated manifests in the output of the command.

Deploy a Node with the Helm Chart

To deploy a node, install the blockchain-node Helm chart and pass an additional value file for the required node.

For example, to deploy an Upshot Index provider configured in example--upshot-index-provider.yaml config file:

helm install \
  axelar \
  helm/blockchain-node \
  -f example--upshot-index-provider.yaml