doctl Verified current stable Not installed? Cloud Infrastructure

Doctl / List Deployments For App Doctl

List Deployments For App Doctl

List deployments for a specific application using `doctl` CLI.

$
Terminal
doctl a lsd <app_id>

When To Use

For monitoring deployment history or troubleshooting app issues.

Pro Tip

Use `--no-header` to suppress output headers for streamlined scripts.

Command Builder

Tune the command before you copy it

Back to syntax
$
Generated Command
doctl a lsd <app_id>

Anatomy of Output

Understanding the result

Deployment ID: deployment-001, Status: success, Created At: 2023-09-30T14:00:00Z Deployment Details

Information about individual deployments.

Deployment ID: deployment-002, Status: failed, Created At: 2023-09-29T10:00:00Z Failed Deployment

Record of a deployment attempt that failed.

Total Deployments: 2 Summary Count

Total number of deployments listed for the app.

Power User Variants

Optimized versions

doctl apps list-deployments app_id --status success

Filter by deployment status for active investigations.

doctl apps list-deployments app_id --limit 10

Limit the number of returned deployments for clarity.

Troubleshooting

Common pitfalls

Error: app not found

Solution: Confirm the application ID is valid and exists.

Error: no deployments found

Solution: Check if any deployments were created for the application.

Error: unauthorized access

Solution: Review permissions associated with your API token.

Command Breakdown

What each part is doing

doctl
Base Command
The executable that performs this operation. Here it runs Doctl before the shell applies any redirect operators.
a
a|apps
The value supplied for a|apps.
lsd
lsd|list deployments
The value supplied for lsd|list deployments.
<app_id>
app id
The value supplied for app id.

Alternative Approaches

Comparable commands in other tools

Alternative cloud infrastructure tools for the same job.