Docker file setup for build and test

Author: Samuel1-ona

.cargo/config.toml

@@ -0,0 +1,11 @@
+# Cargo configuration for Docker builds
+# Limits parallel jobs to reduce memory usage
+
+[build]
+# Limit parallel compilation jobs to reduce memory pressure
+jobs = 2
+
+[target.wasm32-unknown-unknown]
+# Optimize WASM builds
+rustflags = ["-C", "opt-level=z"]
+

.dockerignore

@@ -0,0 +1,33 @@
+# Git
+.git
+.gitignore
+.github
+
+# Rust
+target/
+# Cargo.lock - needed for reproducible builds
+# Cargo.lock
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Documentation
+*.md
+!README.md
+
+# Tests - keep for build (needed for cargo build)
+# Commented out so tests are included in build context
+# tests/
+
+# Temporary files
+*.tmp
+*.log
+

Dockerfile

@@ -0,0 +1,57 @@
+# Multi-stage Dockerfile for Roxy Price (Linera Application)
+# Build stage
+FROM rust:1.86.0-slim as builder
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y \
+    pkg-config \
+    libssl-dev \
+    protobuf-compiler \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy manifest files
+COPY Cargo.toml Cargo.lock ./
+COPY rust-toolchain.toml ./
+
+# Copy source code
+COPY src ./src
+
+# Copy tests directory (needed for cargo build)
+COPY tests ./tests
+
+# Install wasm32 target
+RUN rustup target add wasm32-unknown-unknown
+
+# Build the project
+RUN cargo build --release --target wasm32-unknown-unknown
+
+# Build native binaries for testing
+RUN cargo build --release
+
+# Runtime stage - minimal image for running the application
+FROM debian:bookworm-slim
+
+# Install runtime dependencies
+RUN apt-get update && apt-get install -y \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create app directory
+WORKDIR /app
+
+# Copy built artifacts from builder
+COPY --from=builder /app/target/wasm32-unknown-unknown/release/*.wasm ./
+COPY --from=builder /app/target/release/predictive_manager_contract ./
+COPY --from=builder /app/target/release/predictive_manager_service ./
+COPY --from=builder /app/config.json ./
+
+# Set environment variables
+ENV RUST_LOG=info
+ENV RUST_BACKTRACE=1
+
+# Default command (can be overridden)
+CMD ["./predictive_manager_service"]
+

Dockerfile.dev

@@ -0,0 +1,32 @@
+# Development Dockerfile for Roxy Price
+# This image includes all tools needed for development and testing
+
+FROM rust:1.86.0-slim
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y \
+    pkg-config \
+    libssl-dev \
+    protobuf-compiler \
+    git \
+    curl \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install wasm32 target
+RUN rustup target add wasm32-unknown-unknown
+
+# Install additional Rust tools
+RUN rustup component add clippy rustfmt rust-src
+
+# Set working directory
+WORKDIR /app
+
+# Set environment variables
+ENV RUST_LOG=debug
+ENV RUST_BACKTRACE=1
+ENV CARGO_TERM_COLOR=always
+
+# Default command (keep container running)
+CMD ["tail", "-f", "/dev/null"]
+

Makefile

@@ -0,0 +1,74 @@
+# Makefile for Roxy Price Project
+.PHONY: help build test clean docker-build docker-up docker-down docker-dev docker-test
+
+# Default target
+help:
+	@echo "Roxy Price - Available commands:"
+	@echo ""
+	@echo "Local Development:"
+	@echo "  make build          - Build the project (release mode)"
+	@echo "  make build-wasm     - Build WASM binaries"
+	@echo "  make test           - Run all tests"
+	@echo "  make clippy         - Run clippy linter"
+	@echo "  make fmt            - Format code"
+	@echo "  make clean          - Clean build artifacts"
+	@echo ""
+	@echo "Docker:"
+	@echo "  make docker-build   - Build Docker images"
+	@echo "  make docker-up      - Start Docker containers"
+	@echo "  make docker-down    - Stop Docker containers"
+	@echo "  make docker-dev     - Start development container"
+	@echo "  make docker-test    - Run tests in Docker"
+	@echo "  make docker-shell   - Access development container shell"
+
+# Local development
+build:
+	cargo build --release
+
+build-wasm:
+	cargo build --release --target wasm32-unknown-unknown
+
+test:
+	cargo test --verbose
+
+clippy:
+	cargo clippy -- -D warnings
+
+fmt:
+	cargo fmt --all
+
+fmt-check:
+	cargo fmt --all -- --check
+
+clean:
+	cargo clean
+
+# Docker commands
+docker-build:
+	docker-compose build
+
+docker-up:
+	docker-compose up -d
+
+docker-down:
+	docker-compose down
+
+docker-dev:
+	docker-compose up -d roxy-dev
+	@echo "Development container started. Use 'make docker-shell' to access it."
+
+docker-shell:
+	docker-compose exec roxy-dev bash
+
+docker-test:
+	docker-compose exec roxy-dev cargo test --verbose
+
+docker-build-prod:
+	docker build -t roxy:latest .
+
+docker-run-prod:
+	docker run -p 8080:8080 roxy:latest
+
+# CI/CD helpers
+ci-build: fmt-check clippy build build-wasm test
+

QUICK_START.md

@@ -0,0 +1,74 @@
+# Quick Start Guide - Docker Setup
+
+
+
+```bash
+# Build dev image (faster - just installs tools)
+docker build -f Dockerfile.dev -t roxy-dev .
+
+# Run with volume mounting (instant rebuilds)
+docker run -it --rm \
+  -v $(pwd):/app \
+  -v cargo-cache:/usr/local/cargo/registry \
+  -v target-cache:/app/target \
+  roxy-dev bash
+
+# Inside container, build and test
+cargo build
+cargo test
+```
+
+## Using Docker Compose (Easiest)
+
+```bash
+# Start development container (uses volumes - no rebuild needed)
+docker-compose up -d roxy-dev
+
+# Access container shell
+docker-compose exec roxy-dev bash
+
+# Build inside container (uses cached volumes)
+cargo build --release
+```
+# Access the container shell
+```bash
+docker-compose exec roxy-dev bash
+```
+
+# Or run commands directly
+```bash
+docker-compose exec roxy-dev cargo build
+docker-compose exec roxy-dev cargo test
+docker-compose exec roxy-dev cargo check
+```
+
+# Stop containers
+```bash
+docker-compose down
+```
+
+# Start again
+```bash
+docker-compose up -d roxy-dev
+```
+
+## Memory Issues? (Linker Killed)
+
+If you see `ld terminated with signal 9 [Killed]`, it's an out-of-memory issue.
+
+**Quick Fix:**
+```bash
+# Run tests with single job (uses less memory)
+docker-compose exec roxy-dev cargo test --jobs 1
+
+# Or build in release mode (uses less memory)
+docker-compose exec roxy-dev cargo test --release --jobs 1
+```
+
+**Better Solution:** Increase Docker Desktop memory limit:
+1. Docker Desktop → Settings → Resources → Advanced
+2. Increase Memory to 4GB+ (recommended: 6-8GB)
+3. Apply & Restart
+
+See `DOCKER_TROUBLESHOOTING.md` for more solutions.
+

docker-compose.yml

@@ -0,0 +1,42 @@
+services:
+  # Development service - for building and testing
+  roxy-dev:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: builder
+    volumes:
+      - .:/app
+      - cargo-cache:/usr/local/cargo/registry
+      - target-cache:/app/target
+    working_dir: /app
+    command: tail -f /dev/null  # Keep container running for development
+    environment:
+      - RUST_LOG=debug
+      - RUST_BACKTRACE=1
+      # Limit parallel compilation to reduce memory usage
+      - CARGO_BUILD_JOBS=2
+      # Use incremental compilation
+      - CARGO_INCREMENTAL=1
+    stdin_open: true
+    tty: true
+
+
+  # Production service - runs the built application
+  roxy:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "8080:8080"  # Adjust port as needed for your service
+    environment:
+      - RUST_LOG=info
+      - RUST_BACKTRACE=1
+    volumes:
+      - ./config.json:/app/config.json:ro
+    restart: unless-stopped
+
+volumes:
+  cargo-cache:
+  target-cache:
+