# scloud deployment

https://docs.serverpod.dev/cloud/reference/cli/commands/deployment

`scloud deployment` inspects existing deploys: list history, show status, view build logs. Use it after a deploy to confirm what shipped, watch one in progress, or debug a failure.

For deploying new code, use [`scloud deploy`](https://docs.serverpod.dev/cloud/reference/cli/commands/deploy.md). For the deploy lifecycle and how to recover from a failed deploy, see [Deployments](https://docs.serverpod.dev/cloud/concepts/deployments.md) and [Recover from a failed deploy](https://docs.serverpod.dev/cloud/guides/recover-from-a-failed-deploy.md).

## Usage

```console
Manage deployments.

Usage: scloud deployment <subcommand> [arguments]
-h, --help    Print this usage information.

Available subcommands:
  build-log      View a deployment's build log.
  build-secret   Manage build secrets.
  list           List recent deployments.
  show           Show the status of a deployment.

Run "scloud help" to see global options.

See the full documentation at: https://docs.serverpod.dev/cloud/reference/cli/commands/deployment

```

### Sub commands

#### `show`

```console
Show the status of a deployment.

Usage: scloud deployment show [arguments]
-h, --help                       Print this usage information.
-p, --project (mandatory)        The ID of the project.
                                 Can be omitted for existing projects that are linked or if a global
                                 project context is set. See `scloud project link --help` and
                                 `scloud context set --help`.
-u, --[no-]utc                   Display timestamps in UTC timezone instead of local.
    --deploy=<<uuid|integer>>    View a specific deployment, with uuid or sequence number, 0 for
                                 latest. Can be passed as the first argument.
                                 (defaults to "0")
    --output-overall-status      View a deployment's overall status as a single word, one of:
                                 success, failure, awaiting, running, cancelled, unknown.
    --[no-]await                 Await the deployment to finish while showing status progression.
                                 (defaults to on)

Run "scloud help" to see global options.


Examples

  Show the status of the latest deployment and wait for it to finish.

    $ scloud deployment show


  Show the status of the latest deployment without waiting for it to finish.

    $ scloud deployment show --no-await


  Show the status of a specific deployment by sequence number.

    $ scloud deployment show 3


  Show the status of a specific deployment by UUID.

    $ scloud deployment show 550e8400-e29b-41d4-a716-446655440000


See the full documentation at: https://docs.serverpod.dev/cloud/reference/cli/commands/deployment

```

#### `list`

```console
List recent deployments.

Usage: scloud deployment list [arguments]
-h, --help                   Print this usage information.
-p, --project (mandatory)    The ID of the project.
                             Can be omitted for existing projects that are linked or if a global
                             project context is set. See `scloud project link --help` and `scloud
                             context set --help`.
    --limit=<integer>        The maximum number of records to fetch.
                             (defaults to "10")
-u, --[no-]utc               Display timestamps in UTC timezone instead of local.

Run "scloud help" to see global options.


Examples

  List the 10 most recent deployments.

    $ scloud deployment list


  List the 20 most recent deployments.

    $ scloud deployment list --limit 20


See the full documentation at: https://docs.serverpod.dev/cloud/reference/cli/commands/deployment

```

#### `build-log`

```console
View a deployment's build log.

Usage: scloud deployment build-log [arguments]
-h, --help                       Print this usage information.
-p, --project (mandatory)        The ID of the project.
                                 Can be omitted for existing projects that are linked or if a global
                                 project context is set. See `scloud project link --help` and
                                 `scloud context set --help`.
-u, --[no-]utc                   Display timestamps in UTC timezone instead of local.
    --deploy=<<uuid|integer>>    View a specific deployment, with uuid or sequence number, 0 for
                                 latest. Can be passed as the first argument.
                                 (defaults to "0")

Run "scloud help" to see global options.


Examples

  View the build log of the latest deployment.

    $ scloud deployment build-log


  View the build log of a specific deployment by sequence number.

    $ scloud deployment build-log 3


  View the build log of a specific deployment by UUID.

    $ scloud deployment build-log 550e8400-e29b-41d4-a716-446655440000


See the full documentation at: https://docs.serverpod.dev/cloud/reference/cli/commands/deployment

```

#### `build-secret`

```console
Manage build secrets.

Build secrets are used to securely store sensitive information that needs to be
available when building your server, for example SSH keys.

Build secrets are not available at runtime.
(See `scloud secret` for managing runtime secrets:
https://docs.serverpod.dev/cloud/reference/cli/commands/secret)

Usage: scloud deployment build-secret <subcommand> [arguments]
-h, --help    Print this usage information.

Available subcommands:
  list    List all build secrets.
  set     Set a build secret (create or update).
  unset   Remove a build secret.

Run "scloud help" to see global options.

Examples

  List the current build secrets.

    $ scloud deployment build-secret list

  Add or modify a build secret.

    $ scloud deployment build-secret set MY_SECRET_NAME "my-secret-value"

See the full documentation at: https://docs.serverpod.dev/cloud/reference/cli/commands/deployment

```