Network with an External PostgreSQL Database Example

External Database Test Example

This example demonstrates how to deploy a Hiero Hashgraph Solo network with an external PostgreSQL database using Kubernetes, Helm, and Taskfile automation.

What It Does

• Creates a Kind Kubernetes cluster for local testing
• Installs the Solo CLI and initializes a Solo network
• Deploys a PostgreSQL database using Helm
• Seeds the database and configures Solo to use it as an external database for the mirror node
• Deploys mirror node, explorer, relay, and runs a smoke test
• All steps are named for clear logging and troubleshooting

Usage

1. Install dependencies:

   • Task
   • Node.js
   • npm
   • kubectl
   • kind
   • Helm

2. Customize your deployment:

   • Edit Taskfile.yml to set database credentials, network size, and other parameters as needed.

3. Start the network:

   task
   

   This will:

   • Create the Kind cluster
   • Install and initialize Solo
   • Deploy and configure PostgreSQL
   • Seed the database
   • Deploy all Solo components (mirror node, explorer, relay)
   • Run a smoke test

4. Destroy the network:

   task destroy
   

   This will delete the Kind cluster and all resources.

Files

• Taskfile.yml — Automation tasks and configuration
• scripts/init.sh — Script to initialize the database
• Other config files as needed for your deployment

Notes

• All commands in the Taskfile are named for clarity in logs and troubleshooting.
• This example is self-contained and does not require files from outside this directory except for the Solo CLI npm package.
• You can extend the Taskfile to add more custom resources or steps as needed.