# Deployments

A D**eployment** is an instance of your project that is running on the RetroDeep platform. Each time you push updates or modifications to your project through the RetroDeep CLI or connected repositories, a new deployment is created. This allows you to maintain historical versions of your project, test new features in isolation, and roll back to previous versions if necessary.

The `retrodeep ls` command is utilized to list all deployments associated with a specific project. This allows you to quickly view the status of all deployments, aiding in management and oversight of your deployed applications.

## Usage

**List Deployments for a Project:**

```bash
retrodeep ls [project name]
```

Enter the name of the project to see all active and historical deployments. If no project name is provided, it will prompt you to specify a project.

#### Examples

**List All Deployments for a Project:**

To list all deployments for a specific project named `test-app`:

```bash
retrodeep ls test-app
```

This will display all deployments under the `test-app` project, including details such as deployment IDs, status, and creation dates.

### Deleting Deployments

The `retrodeep rm` command allows users to effectively manage their project's resources by removing unwanted or obsolete deployments. This command supports deleting individual deployments as well as all deployments associated with a specified project, providing flexibility in managing deployment lifecycles.

Remove a specific deployment using the command:

```bash
retrodeep rm [deployment-url]
```

Specify the URL or ID of the deployment you wish to remove. This action will delete the specified deployment, freeing up resources and cleaning up your project space.

**Remove All Deployments for a Specific Project:**

By specifying a project name, you can remove all deployments associated with that project. This is useful for project termination or major overhauls where starting fresh is necessary.

```bash
retrodeep rm [project-name]
```

### **Examples**

**Remove a Single Deployment:**

To remove a specific deployment with its URL:

```bash
retrodeep rm example_deployment_url
```

**Remove All Deployments for a Specific Project:**

To remove all deployments associated with the `test-app` project:

```bash
retrodeep rm test-app
```

To display help information about the retrodeep rm command:

```
retrodeep help rm
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.retrodeep.com/retrodeep-cli/deployments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.