Skip to content

Add Docker support with agent and capture tooling#782

Merged
thinkingfish merged 2 commits intomainfrom
claude/docker-rezolus-metrics-Gsj6Z
Apr 13, 2026
Merged

Add Docker support with agent and capture tooling#782
thinkingfish merged 2 commits intomainfrom
claude/docker-rezolus-metrics-Gsj6Z

Conversation

@thinkingfish
Copy link
Copy Markdown
Member

Problem

Rezolus currently lacks containerized deployment support, making it difficult for users to run the agent and capture metrics in Docker environments. There's no standardized way to package Rezolus, start the agent, and provide convenient metric capture tooling within a container.

Solution

Added comprehensive Docker support including:

  1. Dockerfile - Multi-stage build that:

    • Builds Rezolus from source in a builder stage
    • Creates a minimal runtime image based on Debian bookworm-slim
    • Includes necessary runtime dependencies (libelf1, curl)
    • Exposes ports 4241 (agent) and 8080 (viewer)
  2. entrypoint.sh - Container entrypoint script that:

    • Starts the Rezolus agent in the background
    • Waits for the agent to be ready (with 30-second timeout)
    • Allows users to run custom commands or keep the container alive
    • Supports custom agent config via REZOLUS_AGENT_CONFIG environment variable
  3. rezolus-capture - Utility script for recording metrics that:

    • Captures system metrics from the local agent
    • Optionally captures service metrics from Prometheus-compatible endpoints
    • Combines multiple metric sources into a single parquet file
    • Launches the Rezolus viewer for interactive analysis
    • Provides comprehensive CLI with help text and validation
    • Supports customizable sampling intervals and output directories
  4. .dockerignore - Excludes unnecessary files from the build context

Result

Users can now:

  • Build a Docker image containing Rezolus with docker build
  • Run the agent in a container with automatic startup and health checking
  • Use the rezolus-capture command to record system and service metrics
  • View captured metrics using the built-in viewer
  • Integrate Rezolus into containerized monitoring and profiling workflows

The Docker image provides a complete, self-contained solution for metric collection and analysis in container environments.

https://claude.ai/code/session_012nFNtySN5Hbm9XHXz72qLU

claude added 2 commits April 13, 2026 07:27
Adds a multi-stage Dockerfile and supporting scripts that make it easy
to try out Rezolus in a container. The image runs the Rezolus agent
automatically for system metrics collection and provides a
rezolus-capture script that records system and/or service metrics for a
given duration, combines them, and launches the viewer.
Adds docker/README.md with usage examples for system-only and combined
service metrics capture (Redis, Valkey). Adds a GitHub Actions workflow
that builds multi-arch (x86_64 + arm64) Docker images on release tags
and pushes them to GitHub Container Registry (ghcr.io).
@thinkingfish thinkingfish merged commit cc7a9f7 into main Apr 13, 2026
25 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants