Files
Termix/plugins/docker/README.md
T

35 lines
1.2 KiB
Markdown

# Docker
Container management over SSH: list, inspect, start, stop and view logs for Docker or Podman containers, plus an interactive container console.
Bundled with Termix and enabled by default.
## Services
- `docker.containers` 1.0.0: `listContainers(hostId, { all? })` and
`action(hostId, container, "start" | "stop" | "restart" | "pause" |
"unpause" | "remove")`, run over a pooled SSH connection as the caller.
- `docker.events` 1.0.0: `subscribe(hostId, listener)` calls the listener
with `{ hostId, container, event }` when a container exits, starts,
restarts or turns unhealthy, polled about once a minute as the caller.
Subscribing the same listener again is a no-op.
Both need `docker.use`.
## Layout
manifest.json id, capabilities and what this plugin contributes
src/backend/ activate(ctx) / deactivate(), plus the routes
src/frontend/ the UI it registers
locales/en.json its strings (English only; the rest are translated)
tests/backend/ vitest, node
tests/frontend/ vitest, jsdom
## Commands
npm run build bundle into dist/
npm run test run this plugin's tests
npm run typecheck
See packages/plugin-sdk/ARCHITECTURE.md for the contract this follows.