# kindgi deployments

> See what's deployed: list, get

## `kindgi deployments`

**Synopsis**

```sh signature
kindgi deployments <command>
```

See what's deployed: list, get. `get` shows a deployment's pack service now, and what to do when it runs on the values it was last given.

**Commands**

| Command                                                                                                          | Description                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| [`kindgi deployments list`](https://docs.kindgi.com/v0.1.9/reference/cli/deployments.md#kindgi-deployments-list) | List the deployments, the latest activated first.                                                                                     |
| [`kindgi deployments get`](https://docs.kindgi.com/v0.1.9/reference/cli/deployments.md#kindgi-deployments-get)   | Show a deployment and its pack service now: whether it's ready, and when it runs on the values it was last given, why and what to do. |

**See also**

- [Deploy your agent to Kindgi Cloud](https://docs.kindgi.com/v0.1.9/hosted/deploy-your-agent.md)
- [Declare the environment your code reads](https://docs.kindgi.com/v0.1.9/guides/secrets/pack-env.md)

### `kindgi deployments list`

**Synopsis**

```sh signature
kindgi deployments list [--project=<id-or-slug>] [--pack=<pack-id>] [--image-ref-prefix=<ref>] [--signer-key-id=<id>] [--limit=<n>] [--cursor=<c>]
```

List the deployments, the latest activated first. `--table` shows each one's pack service: ready (or held on the values it was last given, with the code), pending or cleared.

**Options**

| Option                       | Default              | Description                                                                                                                                                                                                         |
| ---------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cursor <value>`           | none                 | Resume after this cursor, from the previous page's `nextCursor`.                                                                                                                                                    |
| `--image-ref-prefix <value>` | none                 | Only deployments whose image reference starts with this.                                                                                                                                                            |
| `--limit <value>`            | `25` (at most `100`) | The most to return (default 25, at most 100).                                                                                                                                                                       |
| `--pack <value>`             | none: every pack     | Only one pack's deployments, by its pack id (the image index's `packId`). Needs a runtime on Kindgi 0.1.9 or later.                                                                                                 |
| `--project <value>`          | none: every project  | Only one project's deployments, by its id or its slug. The Default project's include the deployments that name no project. A slug two orgs share is refused: pass the id. Needs a runtime on Kindgi 0.1.9 or later. |
| `--signer-key-id <value>`    | none                 | Only deployments signed with this key.                                                                                                                                                                              |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

Find a deployment's id, with each one's pack service: ready, held on its last values (with the code), pending or cleared.

```sh
kindgi deployments list --table
```

One environment's deployments, by its project's slug or id. The Default project's include the deployments that name no project.

```sh
kindgi deployments list --project=staging --table
```

**See also**

- [Deploy your agent to Kindgi Cloud](https://docs.kindgi.com/v0.1.9/hosted/deploy-your-agent.md)
- [Declare the environment your code reads](https://docs.kindgi.com/v0.1.9/guides/secrets/pack-env.md)
- [`kindgi deployments`](https://docs.kindgi.com/v0.1.9/reference/cli/deployments.md#kindgi-deployments)

### `kindgi deployments get`

**Synopsis**

```sh signature
kindgi deployments get <deployment-id> [--json]
```

Show a deployment and its pack service now: whether it's ready, and when it runs on the values it was last given, why and what to do. --json prints the deployment as the API answers it.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

See a deployment's pack service now: when it runs on the values it was last given, why, and the command that sets what's missing.

```sh
kindgi deployments get <deployment-id>
```

The deployment as the API answers it, with its pack service in `endpoint`.

```sh
kindgi deployments get <deployment-id> --json
```

**See also**

- [Deploy your agent to Kindgi Cloud](https://docs.kindgi.com/v0.1.9/hosted/deploy-your-agent.md)
- [Declare the environment your code reads](https://docs.kindgi.com/v0.1.9/guides/secrets/pack-env.md)
- [`kindgi deployments`](https://docs.kindgi.com/v0.1.9/reference/cli/deployments.md#kindgi-deployments)