# deployment

The describe deployment command retrieves detailed information about a specific Deployment in the Kubernetes cluster. This includes metadata, replica status, rollout history, update strategy, and associated pods.

## Usage

```
cldkctl describe deployment [name] [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
./cldkctl describe deployment [name] 
```

2. Replace \[name] with the Deployment name you want to inspect.
3. To view the resource name, refer to the corresponding get deployment section.
4. If the resource is located in a non-default namespace, include the `-n` or `--namespace` flag followed by the namespace name.

```
./cldkctl describe [resource] [name] -n [namespace]
```

5. Once completed successfully, the detailed information about the specified Deployment will appear in your terminal. The output includes metadata, specifications, container configurations, update strategy, and rollout status.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FJ14U2bLqAw0UW36HEOQC%2Funknown.png?alt=media&#x26;token=c9666bb4-2495-4e05-8ac4-3a0101b07380" alt=""><figcaption></figcaption></figure>

The following table describes the additional fields specific to the Deployment resource.

| Column                              | Description                                                                     |
| ----------------------------------- | ------------------------------------------------------------------------------- |
| spec.replicas                       | The desired number of pod replicas for the Deployment.                          |
| spec.selector                       | Defines the label selector used to identify the pods managed by the Deployment. |
| spec.template                       | Describes the pod template used to create pods for this Deployment.             |
| spec.template.spec.containers       | Lists the containers that will be deployed as part of this Deployment.          |
| spec.template.spec.containers.name  | The name of the container.                                                      |
| spec.template.spec.containers.image | The container image used by the Deployment.                                     |
| spec.strategy                       | Defines the strategy used to replace old pods with new ones during updates.     |
| spec.strategy.type                  | The type of deployment strategy.                                                |
| spec.strategy.rollingUpdate         | Contains parameters controlling the rolling update process.                     |
| status.replicas                     | The total number of pods created by the Deployment.                             |
| status.updatedReplicas              | The number of pods updated to the latest version of the Deployment.             |
| status.unavailableReplicas          | The number of pods that are not yet available.                                  |
| status.conditions                   | Indicates the current conditions of the Deployment.                             |
| status.conditions.message           | Provides additional information about the current Deployment state or issues.   |

## Flags

{% hint style="info" %}

1. This command supports [global flags.](https://docs.cloudeka.ai/cloudeka-api-list/global-flags) Refer to the Global Flags section for details.
2. For common metadata fields, refer to the Common Output Fields table at the beginning of this section.
   {% endhint %}

| Flag       | Description                           |
| ---------- | ------------------------------------- |
| -h, --help | Help for describe deployment command. |