Skip to content

docs: propose datumctl compute developer experience#111

Open
scotwells wants to merge 1 commit into
mainfrom
docs/datumctl-compute-dx
Open

docs: propose datumctl compute developer experience#111
scotwells wants to merge 1 commit into
mainfrom
docs/datumctl-compute-dx

Conversation

@scotwells
Copy link
Copy Markdown
Contributor

@scotwells scotwells commented May 21, 2026

Summary

As we approach the launch of Datum Cloud compute, we want to make sure the CLI experience feels polished and developer-friendly from day one — not something bolted on after the fact.

This document proposes a datumctl compute command group designed around what developers actually do: deploy a workload, watch it roll out, check its health, get logs, and inspect instances when something breaks. The goal is to close the gap between "I have a container image" and "my workload is healthy across multiple cities" without requiring developers to understand the platform's internal resource model.

The proposal covers six workflows with example output for each:

  • Deploy — flags, interactive, or manifest; saves a workload.yaml on first create; -y for CI pipelines
  • Health — plain-English status with suggested next steps on failure
  • Rollout — city-by-city progress with history and undo (20-revision default)
  • Logs — workload-scoped by default, filtered by city/instance/container via the telemetry label system
  • Instances — full project list with per-workload filtering
  • Quota — project-level usage with city breakdown

Looking for feedback on the overall shape — whether the workflows match how the team expects developers to use the platform, and whether anything important is missing before this moves to implementation planning.

Test plan

  • Review workflow examples for accuracy against the current platform model
  • Confirm the quota scope (project-level, not per-city) matches the quota API
  • Confirm log filtering via telemetry labels is achievable with the current telemetry stack

Outlines the proposed `datumctl compute` command group — covering
deploy, status, rollout, logs, instance inspection, and quota — with
example output for each workflow.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@scotwells scotwells force-pushed the docs/datumctl-compute-dx branch from 2cbe48b to a775ae6 Compare May 21, 2026 15:33
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.

1 participant