Skip to content

Conversation

@deshmukhpranali
Copy link
Contributor

Add a comprehensive step-by-step deployment guide for the Hiero Block Node on Google Cloud Platform virtual machines using the Weaver tool.

The guide covers VM creation, Weaver binary upload, environment preparation, Weaver user setup, Block Node deployment, verification, deprovisioning, and troubleshooting essentials for node operators.

Related Issue(s)

Resolves: https://github.com/hashgraph/node-operator-docs/issues/43

Add a comprehensive step-by-step deployment guide for the Hiero Block Node on Google Cloud Platform virtual machines using the Weaver tool.

The guide covers VM creation, Weaver binary upload, environment preparation, Weaver user setup, Block Node deployment, verification, deprovisioning, and troubleshooting essentials for node operators.

Signed-off-by: Pranali Deshmukh <[email protected]>
Copy link
Contributor

@Nana-EC Nana-EC left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good, some suggestions

deshmukhpranali and others added 3 commits November 28, 2025 10:11
Co-authored-by: Nana Essilfie-Conduah <[email protected]>
Signed-off-by: Pranali Deshmukh <[email protected]>
Co-authored-by: Nana Essilfie-Conduah <[email protected]>
Signed-off-by: Pranali Deshmukh <[email protected]>
Co-authored-by: Nana Essilfie-Conduah <[email protected]>
Signed-off-by: Pranali Deshmukh <[email protected]>
@codecov
Copy link

codecov bot commented Nov 28, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

@@             Coverage Diff              @@
##               main    #1911      +/-   ##
============================================
- Coverage     79.48%   79.03%   -0.45%     
- Complexity     1193     1198       +5     
============================================
  Files           128      130       +2     
  Lines          5684     5768      +84     
  Branches        610      615       +5     
============================================
+ Hits           4518     4559      +41     
- Misses          887      926      +39     
- Partials        279      283       +4     

see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

… and add grpcurl verification step

- Move/rename file to docs/block-node/operations/solo-weaver-single-node-k8s-deployment.md.
- Add Step 7: Test Block Node accessibility via grpcurl serverStatus endpoint:
  - Install grpcurl using system package manager.
  - Download protobuf from latest release.
  - Verify node responds to gRPC serverStatus call.

Signed-off-by: Pranali Deshmukh <[email protected]>
@Nana-EC Nana-EC added this to the 0.25.0 milestone Nov 30, 2025
@Nana-EC Nana-EC added Block Node Issues/PR related to the Block Node. Documentation Issues/PR related to documentation labels Nov 30, 2025
@Nana-EC
Copy link
Contributor

Nana-EC commented Nov 30, 2025

@deshmukhpranali you should run ./gradlew spotlessApply and push

1. Run the Block Node setup command with **`sudo`** and the desired profile (choose one of: **`local`****`testnet`****`previewnet`****`mainnet`**):

```bash
sudo ./weaver-linux-amd64 blocknode setup -p <profile>
Copy link

@leninmehedy leninmehedy Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please note that the block node setup has been deprecated with block node install. Please update the doc as required

We should also describe few others command options as below for completeness that are supported in the latest v0.3.0 release:https://github.com/hashgraph/solo-weaver/releases/tag/v0.3.0

  1. There is a flag --values to provide custom Helm chart values.

weaver block node install --profile local --values <path to values file>

  1. There is also a config flag --config to provide some other configurations as below as the config file:
    weaver block node install --profile local --values <path to values file> --config <path to config.yaml
log:
  level: debug
  consoleLogging: true
  fileLogging: false
blockNode:
  namespace: "block-node"
  release: "block-node"
  chart: "oci://ghcr.io/hiero-ledger/hiero-block-node/block-node-server"
  version: "0.22.1"
  storage:
    basePath: "/mnt/fast-storage"

@@ -0,0 +1,209 @@
# Solo Weaver Single Node Kubernetes Deployment Guide

# Overview
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All of the headings (aside from line 1) probably need one more # (Codacy complains about this too).
That means these section headings become H2, and the steps below become H3 (which seems correct).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Block Node Issues/PR related to the Block Node. Documentation Issues/PR related to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants