Integrations

Cetacean recognizes a few Swarm ecosystem tools, such as Traefik and Shepherd, from a service’s own labels and renders each as a structured panel on the service detail page, above the labels section. Nothing is rendered when no matching labels are present.

Supported tools

A tool is detected when the service carries at least one label with its prefix.

A panel shows the tool as enabled unless a <prefix>enable label says otherwise.

Traefik’s TCP and UDP labels are left to the raw label view; only the HTTP routers, services, and middlewares are parsed into structure.

The Traefik panel adds a read-only Graph view, drawing each entrypoint through the routers listening on it and their middleware chains to the service they route to.

Editing

Each panel has a view toggle and a link to the tool’s own documentation. The structured and raw views are editable when the service allows PATCH, which requires operations level 2 and a write grant on the service. Saving writes the labels back through PATCH /services/{id}/labels; every field maps to one Docker service label.

The structured Traefik editor changes only the labels its fields show. Labels it doesn’t model, such as TCP routers or tls.options, are kept when you save it.

API

Detected integrations appear as an integrations array on GET /services/{id}, omitted when nothing was detected. See the API reference for the full schema.