Dev Center CLI

Platform operations for managing services, deployments, rollouts, secrets, and resources from the command line.

Global Options

All riven dev-center subcommands accept these options:

Option	Default	Description
`--json`	—	Machine-readable JSON output
`--yes`	—	Skip interactive confirmations
`--namespace <ns>`	`dev-center`	Kubernetes namespace override

Service Management

Manage service definitions in the Dev Center catalog.

List services

bash

riven dev-center service list

Get service details

bash

riven dev-center service get <service>

Create a service

bash

riven dev-center service create <service> \
  --repository <ecr-url> \
  --repository-id <id>

Delete a service

bash

riven dev-center service delete <service>

Deploy a service

Deploy a service using Helm charts. The --tag option is required.

bash

riven dev-center service deploy <service> --tag v1.2.3
 
# With additional options
riven dev-center service deploy my-service \
  --tag v2.0.0 \
  --replicas 3 \
  --repo-type js

Always use the <semver>-<short-sha> tag format (e.g. 0.1.69-de54b1c). Read version from package.json and append the short git SHA.

Resources

View and update CPU, memory, and autoscaling configuration for a service.

Get resource config

bash

riven dev-center resource get <service>

Set resources

bash

riven dev-center resource set <service> \
  --cpu-request 500m \
  --cpu-limit 1 \
  --memory-request 512Mi \
  --memory-limit 1Gi
 
# Enable autoscaling
riven dev-center resource set <service> \
  --autoscale \
  --min-replicas 2 \
  --max-replicas 10
 
# Set manual instance count
riven dev-center resource set <service> --instances 3

Secrets

Manage environment secrets for a service. Values are stored encrypted and injected as environment variables at runtime.

List secrets

Lists secret keys with values redacted.

bash

riven dev-center secret list <service>

Set secrets

bash

# Merge with existing secrets
riven dev-center secret set <service> DB_URL=postgres://... API_KEY=sk-123
 
# Replace all secrets
riven dev-center secret set <service> DB_URL=postgres://... --replace

Delete secrets

bash

riven dev-center secret delete <service> DB_URL API_KEY

Rollouts

Manage canary and standard rollouts for safe deployments.

Start a rollout

bash

# Standard rollout
riven dev-center rollout start <service> <version>
 
# Canary rollout with metric analysis
riven dev-center rollout start <service> v2.0.0 --canary --analysis
 
# Quick canary strategy
riven dev-center rollout start <service> v2.0.0 --canary --strategy quick

Check rollout status

bash

riven dev-center rollout status <service>

Promote a canary

bash

# Promote to next step
riven dev-center rollout promote <service>
 
# Skip remaining steps, promote to 100%
riven dev-center rollout promote <service> --full

Abort a rollout

bash

riven dev-center rollout abort <service>
riven dev-center rollout abort <service> --reason "error rate spike"

Rollback

Rollback a service to a previous version. Defaults to the immediately previous version if no target is specified.

bash

# Rollback to previous version
riven dev-center rollback <service>
 
# Rollback to a specific version
riven dev-center rollback <service> v1.5.0

Inspection and Logs

Inspect deployments, pods, and logs directly from the CLI.

Deployment history

bash

riven dev-center history <service>
riven dev-center history <service> --limit 5

List image versions

bash

riven dev-center versions <service>

Kubernetes deployments

bash

# List all deployments
riven dev-center deployments
 
# Get deployment details
riven dev-center deployment <name>

Pods

bash

# List pods for a service
riven dev-center pods <service>
 
# Delete a specific pod (force restart)
riven dev-center pod-delete <pod-name>

Logs

bash

# Get pod logs
riven dev-center logs <pod-name>
 
# Tail last 100 lines
riven dev-center logs <pod-name> --tail 100
 
# Logs from previous container instance
riven dev-center logs <pod-name> --previous
 
# Logs from a specific container
riven dev-center logs <pod-name> --container sidecar

PreviousService Scaffolding NextPublish