Skip to main content

run

mz_deploy::cli::commands::list

Function run 

Source 
pub async fn run(
    settings: &Settings,
    allowed_lag_secs: i64,
) -> Result<(), CliError>
Expand description

List all active staging deployments.

This command:

  • Queries all deployments where promoted_at IS NULL (staging only)
  • Groups results by environment name
  • Displays schemas in each staging environment with deployment metadata

Similar to git branch - shows active development branches.

§Arguments

  • settings - Resolved CLI settings (profile, project directory, etc.)
  • allowed_lag_secs - Maximum allowed lag in seconds before marking as “lagging”

§Returns

Ok(()) if listing succeeds

§Errors

Returns CliError::Connection for database errors