Monitor Deployment Status

List your deployments using the CLI and monitor detailed status through the Bluebricks web interface.

Prerequisites

• Bluebricks CLI installed

• Authenticated with Bluebricks (bricks login)

• Existing deployments

Quick Start

1. List deployments:

   bricks deploy list

2. List with custom limit:

   bricks deploy list --limit 50

3. View deployment details: Open https://app.bluebricks.co/deployments to see detailed deployment status, logs, and resource information

Listing Deployments

Basic List

# List recent deployments (default: 100)
bricks deploy list

Output shows:

• SLUG: Deployment identifier

• BLUEPRINT: Blueprint name and version

• TARGET ENVIRONMENT: Target collection (environment) name

Example output:

SLUG                                          BLUEPRINT                       TARGET ENVIRONMENT
my-postgres-db                                @myorg/postgres                 production
api-service-v2                                @myorg/api-service              staging
vpc-networking                                @myorg/vpc-module               production

List with Custom Limit

# List first 20 deployments
bricks deploy list --limit 20

# List first 200 deployments
bricks deploy list --limit 200

The CLI will paginate results and prompt to fetch more if available.

Deployment Monitoring via Web UI

Detailed deployment monitoring is available through the Bluebricks web interface:

Accessing Deployment Details

1. Open Bluebricks Dashboard: https://app.bluebricks.co/deployments

2. Navigate to Plans: View all deployments and execution plans

3. Select Deployment: Click on a deployment to see detailed information

Deployment Information

Each deployment shows:

Status Information:

• Current Status: PENDING, PLANNING, PLANNED, PLAN_APPROVED, INSTALLING, COMPLETED, ERROR, CANCELED

• Progress: Real-time progress of deployment execution

• Duration: Time elapsed since deployment started

• Last Updated: Timestamp of last status change

Resource Information:

• Resource List: All resources managed by this deployment

• Resource Status: Individual resource state (creating, created, updating, etc.)

• Resource Details: Configuration and outputs for each resource

• Dependency Graph: Visual representation of resource dependencies

Execution Logs:

• Real-time Logs: Live streaming logs during execution

• Historical Logs: Complete log history for completed deployments

• Filtered Logs: Filter by log level (INFO, WARNING, ERROR)

• Download Logs: Export logs for debugging

Plan Details:

• Changes Summary: Resources to create, update, or destroy

• Plan Approval: Approve or reject planned changes

• Plan History: Previous plans for this deployment

Deployment Lifecycle Stages

1. Pending

Deployment is queued and waiting to start.

# Deployment just created
bricks install @myorg/app --collection prod
# Status: PENDING

2. Planning

Creating execution plan and analyzing required changes.

# Creating plan
bricks install @myorg/app --collection prod --plan-only
# Status: PLANNING → PLANNED

3. Planned

Plan created and waiting for approval.

Action Required: Review and approve in web UI

4. Plan Approved

Plan approved and ready for installation.

5. Installing

Actively creating/updating infrastructure resources.

Monitor: Watch real-time logs in web UI

6. Completed

Deployment successfully finished.

# Check final status
bricks deploy list
# Status: COMPLETED

7. Error

Deployment failed due to an error.

Action Required: Review logs, fix issues, retry deployment

8. Canceled

Deployment was canceled before completion.

Deployment Management

Install/Deploy Packages

# Install a package to a collection
bricks install @myorg/postgres --collection production

# Monitor installation
bricks deploy list

Uninstall Deployments

# Uninstall by deployment slug
bricks uninstall --deployment my-postgres-db --collection production

# Monitor uninstall
bricks deploy list

Update Existing Deployment

# Update deployment with new properties
bricks install --deployment my-app --props-file updated-props.json

# Monitor update
bricks deploy list

API Integration

For programmatic access to deployment status, use the Bluebricks API:

# Example: Get deployment status via API
curl -H "Authorization: Bearer $BRICKS_API_KEY" \
  https://api.bluebricks.co/api/v1/deployments

# Example: Get specific deployment
curl -H "Authorization: Bearer $BRICKS_API_KEY" \
  https://api.bluebricks.co/api/v1/deployments/my-deployment-slug

See also

• Creating Environments -- environment lifecycle and run stages

• How to Plan Deployments -- preview infrastructure changes

• How to Destroy Deployments -- safely tear down resources