CLI Commands

Complete reference for all Onvera CLI commands.

Deployment Commands

deploy

Deploy an application (Airflow or Superset).

Usage:

onvera deploy <app_type> [--name <name>]

Arguments:

• <app_type> - Application type: airflow or superset

Flags:

• --name, -n - Deployment name (optional)

Examples:

# Deploy Superset
onvera deploy superset
 
# Deploy Airflow with custom name
onvera deploy airflow --name "Production Airflow"

See also: deploy command reference

inspect

Inspect a deployment or operation by ID.

Usage:

onvera inspect <id>
onvera inspect <type> <id>

Arguments:

• <id> - Deployment or operation ID
• <type> - Resource type: deployment or operation (optional, auto-detected)

Examples:

# Auto-detect type
onvera inspect dep_550e8400-e29b-41d4-a716-446655440000
 
# Explicit type
onvera inspect deployment dep_550e8400-e29b-41d4-a716-446655440000
onvera inspect operation op_660e8400-e29b-41d4-a716-446655440001

See also: inspect command reference

destroy

Destroy a deployment and remove all associated resources.

Usage:

onvera destroy <deployment_id> [--force]

Arguments:

• <deployment_id> - Deployment ID to destroy

Flags:

• --force - Skip confirmation prompt

Examples:

# Destroy with confirmation
onvera destroy dep_550e8400-e29b-41d4-a716-446655440000
 
# Destroy without confirmation
onvera destroy dep_550e8400-e29b-41d4-a716-446655440000 --force

See also: destroy command reference

ls

List all deployments for your organization.

Usage:

onvera ls

Examples:

# List deployments
onvera ls
 
# JSON output
onvera ls --json

See also: ls command reference

Operation Commands

ops

Manage operations (list and inspect).

Subcommands:

• ops ls - List operations
• ops get - Get operation details

Examples:

# List all operations
onvera ops ls
 
# List with filters
onvera ops ls --status running --type deployment.create
 
# Get operation details
onvera ops get op_660e8400-e29b-41d4-a716-446655440001

See also: ops command reference

Authentication Commands

auth

Manage authentication.

Subcommands:

• auth login - Authenticate with Onvera
• auth logout - Clear stored credentials

Examples:

# Browser login
onvera auth login
 
# API key login
onvera auth login --token onv_sk_live_...
 
# Logout
onvera auth logout

See also: auth command reference

Configuration Commands

config

Manage CLI configuration.

Subcommands:

• config set base-url <url> - Set API base URL

Examples:

# Set base URL
onvera config set base-url https://api.staging.onvera.io

See also: config command reference

Global Flags

All commands support these global flags:

• --base-url <url> - Override API base URL
• --api-key <key> - Provide API key directly
• --debug - Enable debug logging
• --json - Output in JSON format

Getting Help

Get help for any command:

onvera <command> --help

Example:

onvera deploy --help