geomind_research/hero_ledger

Fork 1

Docker Deployment Strategy #6

Merged

mik-tf merged 14 commits from master-deployment into master

2026-01-03 22:10:15 +00:00

mik-tf commented

2026-01-03 20:43:46 +00:00

Contributor

Docker Deployment Infrastructure

This PR implements Docker deployment infrastructure and binary release preparation for HERO Ledger.

🐋 Docker Infrastructure

Two-Image Architecture

hero_ledger_cli (~100 MB) - Lightweight CLI container

heronear CLI for account management
Rhai scripting support
Connects to public NEAR RPC
Perfect for users and CI/CD pipelines

hero_ledger_full (~500 MB) - Complete node with neard

Everything in CLI image
neard 2.10.3 (built from source)
NEAR CLI tools
Local blockchain for development

Key Features

✅ Separate images with independent :latest tags
✅ Optimized multi-stage builds
✅ Clear separation of concerns (CLI vs Full Node)
✅ Ready for registry publishing

Registry Paths

forge.ourworld.tf/geomind_research/hero_ledger_cli:latest
forge.ourworld.tf/geomind_research/hero_ledger_full:latest

📦 Release Artifacts

This PR prepares three types of release artifacts:

1. Standalone Binary (~15-20 MB)

Single executable for account management
Platforms: Linux (x64, ARM64), macOS (Intel, Apple Silicon)
No dependencies required
Rhai scripting support built-in

2. Docker CLI Image (~100 MB)

Containerized heronear CLI
For Docker users and CI/CD
Connects to public NEAR RPC

3. Docker Full Image (~500 MB)

Complete setup with neard
For local development and node operators
Includes local blockchain

📝 Files Changed

Docker Files

docker/Dockerfile.cli - Lightweight CLI-only image
docker/Dockerfile.full - Full image with neard (fixed build process)
docker/docker-compose.yml - Support for both deployment types
docker/README.md - Comprehensive Docker documentation

Documentation

README.md - Updated Quick Start with deployment options
docs/RELEASE.md - Three-artifact release strategy
All docs updated for hero_ledger rename

Build Configuration

setup/Cargo.toml - Feature flags for binary builds
setup/src/bin/heronear.rs - CLI entry point
setup/src/lib.rs - Module organization

🔧 Technical Improvements

Fixed neard Build: Updated Dockerfile.full to build neard v2.10.3 from source instead of trying to download non-existent binaries
Multi-stage Optimization: Reduced image sizes through efficient layer caching
Independent Versioning: Each image has its own :latest tag
Feature Flags: Clean separation of features (scripts support)

✅ Testing

Binary Build

cargo build --release -p setup --bin heronear --features scripts
# ✓ Builds successfully
# ✓ Binary size: ~15-20 MB
# ✓ All commands functional

# Docker Deployment Infrastructure This PR implements Docker deployment infrastructure and binary release preparation for HERO Ledger. ## 🐋 Docker Infrastructure ### Two-Image Architecture **hero_ledger_cli** (~100 MB) - Lightweight CLI container - heronear CLI for account management - Rhai scripting support - Connects to public NEAR RPC - Perfect for users and CI/CD pipelines **hero_ledger_full** (~500 MB) - Complete node with neard - Everything in CLI image - neard 2.10.3 (built from source) - NEAR CLI tools - Local blockchain for development ### Key Features ✅ Separate images with independent `:latest` tags ✅ Optimized multi-stage builds ✅ Clear separation of concerns (CLI vs Full Node) ✅ Ready for registry publishing ### Registry Paths - `forge.ourworld.tf/geomind_research/hero_ledger_cli:latest` - `forge.ourworld.tf/geomind_research/hero_ledger_full:latest` ## 📦 Release Artifacts This PR prepares three types of release artifacts: ### 1. Standalone Binary (~15-20 MB) - Single executable for account management - Platforms: Linux (x64, ARM64), macOS (Intel, Apple Silicon) - No dependencies required - Rhai scripting support built-in ### 2. Docker CLI Image (~100 MB) - Containerized heronear CLI - For Docker users and CI/CD - Connects to public NEAR RPC ### 3. Docker Full Image (~500 MB) - Complete setup with neard - For local development and node operators - Includes local blockchain ## 📝 Files Changed ### Docker Files - `docker/Dockerfile.cli` - Lightweight CLI-only image - `docker/Dockerfile.full` - Full image with neard (fixed build process) - `docker/docker-compose.yml` - Support for both deployment types - `docker/README.md` - Comprehensive Docker documentation ### Documentation - `README.md` - Updated Quick Start with deployment options - `docs/RELEASE.md` - Three-artifact release strategy - All docs updated for hero_ledger rename ### Build Configuration - `setup/Cargo.toml` - Feature flags for binary builds - `setup/src/bin/heronear.rs` - CLI entry point - `setup/src/lib.rs` - Module organization ## 🔧 Technical Improvements 1. **Fixed neard Build**: Updated Dockerfile.full to build neard v2.10.3 from source instead of trying to download non-existent binaries 2. **Multi-stage Optimization**: Reduced image sizes through efficient layer caching 3. **Independent Versioning**: Each image has its own `:latest` tag 4. **Feature Flags**: Clean separation of features (scripts support) ## ✅ Testing ### Binary Build ```bash cargo build --release -p setup --bin heronear --features scripts # ✓ Builds successfully # ✓ Binary size: ~15-20 MB # ✓ All commands functional ```

mik-tf added 9 commits

2026-01-03 20:43:46 +00:00

docs: Update README with simplified quick start and script-focused workflow 95a92268f2

docs: Update README with binary download instructions and separate developer guide 6ef6138105

feat: Add release workflow, Docker setup, and embedded contracts deployment 326fe9fcbb

docs: Add comprehensive release guide with automated and manual processes 9e2d493847

docs: Add comprehensive testing guide with pre-release checklist f78adba28d

feat: Simplify contract build process with cargo near build --release 9304a21d57

docs: Update testing guide with reset flag usage and error handling e83cb159e2

feat: Split Docker setup into CLI-only and full node images cb7169f9b4

Merge master into master-deployment: resolve SETUP.md conflict 9692eee800

mik-tf added 1 commit

2026-01-03 20:49:11 +00:00

docs: Update RELEASE.md with three-artifact strategy (binary + CLI + full Docker images) ede77a9488

mik-tf added 1 commit

2026-01-03 21:07:47 +00:00

refactor: Remove embedded contracts deployment feature 4bac30cd45

Focus this PR on Docker infrastructure and binary releases only.
Embedded contract deployment removed to avoid confusion about
canonical tokens (SPORE, GLD, USDH) being redeployed by anyone.

Changes:
- Removed setup/src/contracts.rs module
- Removed embedded-contracts feature from Cargo.toml
- Removed heronear deploy/contracts/version commands
- Updated Dockerfiles to remove embedded-contracts feature flag
- Updated all documentation to remove embedded contracts references
- Binary now focuses on account management and Rhai scripting

This keeps the PR focused on deployment infrastructure while
embedded contract strategy can be designed separately.

mik-tf added 1 commit

2026-01-03 21:24:48 +00:00

docs: Update TESTING.md to reflect current features e00ebeb9f4

Remove references to embedded contracts deployment.
Focus on testing:
- Binary builds and CLI commands
- Docker CLI and Full images
- Rhai scripts execution
- All feature areas (SPOREX, KVS, DNS, Groups, Credit)
- Local setup end-to-end testing

Added comprehensive test checklist and troubleshooting guide.

mik-tf added 1 commit

2026-01-03 21:42:02 +00:00

feat: Add Docker build and test targets to Makefile 862a90a72a

mik-tf added 1 commit

2026-01-03 21:59:31 +00:00

refactor: Simplify Docker CLI image and add entrypoint for full image 6058842423