mirror of
https://github.com/coder/coder.git
synced 2026-09-22 05:05:20 +08:00
Sas SwartandCian Johnston
7d95153bf4
Add a new subcommand to list all registered sync units and their current
statuses. This provides a quick overview of the dependency coordination
state in a workspace without needing to query each unit individually.
The command supports both table (default) and JSON output formats.
```
$ coder exp sync list
UNIT STATUS READY
unit-a started true
unit-b completed true
unit-c pending false
$ coder exp sync list --output json
[
{
"unit_name": "my-unit",
"status": "started",
"is_ready": true
}
]
```
When no units are registered, the command prints `No units registered`.
<details><summary>Changes across layers</summary>
- `agent/unit`: add `Manager.ListUnits()` method
- `agent/agentsocket/proto`: add `SyncList` RPC, bump API to v1.2
- `agent/agentsocket`: add service and client implementations
- `cli`: add `sync_list.go` command, register in `sync.go`
- Tests: three golden-file test cases (empty list, multiple units, JSON)
</details>
> Generated by Coder Agents on behalf of @SasSwart
---------
Co-authored-by: Cian Johnston <cian@coder.com>
29 lines
997 B
Plaintext
29 lines
997 B
Plaintext
coder v0.0.0-devel
|
|
|
|
USAGE:
|
|
coder exp sync [flags]
|
|
|
|
Manage unit dependencies for coordinated startup
|
|
|
|
Commands for orchestrating unit startup order in workspaces. Units are most
|
|
commonly coder scripts. Use these commands to declare dependencies between
|
|
units, coordinate their startup sequence, and ensure units start only after
|
|
their dependencies are ready. This helps prevent race conditions and startup
|
|
failures.
|
|
|
|
SUBCOMMANDS:
|
|
complete Mark a unit as complete
|
|
list List all registered units and their statuses
|
|
ping Test agent socket connectivity and health
|
|
start Wait until all unit dependencies are satisfied
|
|
status Show unit status and dependency state
|
|
want Declare that a unit depends on other units completing before it
|
|
can start
|
|
|
|
OPTIONS:
|
|
--socket-path string, $CODER_AGENT_SOCKET_PATH
|
|
Specify the path for the agent socket.
|
|
|
|
———
|
|
Run `coder --help` for a list of global options.
|