deploy
Deploy an application (Apache Airflow or Apache Superset) to Onvera.
Usage
onvera deploy <app_type> [--name <name>]Arguments
<app_type>- Application type. Must be one of:airflow- Deploy Apache Airflowsuperset- Deploy Apache Superset
Flags
--name, -n <name>- Deployment name (optional). If omitted, Onvera generates a name automatically.
Description
The deploy command creates a new deployment and processes it asynchronously. The command:
- Creates a Deployment resource
- Returns a Deployment ID and Operation ID
- Polls for completion, showing progress updates
- Exits when deployment succeeds or fails
Deployment typically takes 5-10 minutes.
Examples
Deploy Superset:
onvera deploy supersetDeploy Airflow with custom name:
onvera deploy airflow --name "Production Airflow"Deploy with JSON output:
onvera deploy superset --jsonOutput
Success output:
Creating superset deployment...
Deployment created: dep_550e8400-e29b-41d4-a716-446655440000
Operation ID: op_660e8400-e29b-41d4-a716-446655440001
Polling for completion...
Press Ctrl+C to stop polling (deployment will continue)
Status: provisioning_db - Provisioning database (45s elapsed)
Status: provisioning_infrastructure - Creating infrastructure (2m 14s elapsed)
Status: waiting_for_subdomain - Configuring subdomain (4m 32s elapsed)
Status: ready - Deployment ready (6m 15s elapsed)
Deployment succeeded!Interrupting Polling
💡
You can press Ctrl+C to stop polling. The deployment continues in the background. Use the Operation ID to check status later:
onvera ops get op_660e8400-e29b-41d4-a716-446655440001Common Failure Modes
Not authenticated
Error:
not authenticated. Run 'onvera auth login' firstSolution: Run onvera auth login to authenticate.
Invalid app type
Error:
invalid app_type: invalid (must be 'airflow' or 'superset')Solution: Use airflow or superset as the app type.
Deployment fails
If deployment fails, check the operation status:
onvera ops get <operation_id>The operation will include error details in the progress message.