Register Your First Service

This tutorial creates a tiny provider module that exposes a long-running Python process.

Create the Provider Module

import sys

from conda_broker.hookspec import hookimpl
from conda_broker.models import CondaService, ProcessSpec


@hookimpl
def conda_broker_services():
    yield CondaService(
        name="hello",
        summary="Example service that prints a heartbeat",
        source="example-provider",
        process=ProcessSpec(
            argv=(
                sys.executable,
                "-c",
                "import time; print('ready', flush=True); time.sleep(3600)",
            ),
        ),
    )

The hook belongs to conda-broker, not conda. It is loaded by the broker’s own ServiceRegistry, which is also the pluggy manager.

Register the Entry Point

[project.entry-points.conda_broker]
"example-provider" = "example_provider.broker"

After installation, the service appears in cb list.

Start It

cb enable hello --start
cb status hello
cb logs hello

The process runs in its own session or process group where the operating system supports it. cb stop hello sends the configured graceful stop signal, waits for the grace period, and kills the process if needed.