DeepStructure CLI

The ds CLI tool streamlines the development, deployment, and management of applications on the DeepStructure Cloud platform.

Installation

To start using ds, you must have node.js and npm installed. You can use npx to run the latest version without needing to install it globally on your system. This approach ensures you're always using the most up-to-date version of the tool.

npx @deepstructure/cli@latest <command>

We recommend installing ds locally in your DeepStructure projects, which is done for you automatically when you use create-deepstructure-app.

npm install --save-dev @deepstructure/cli

Doing so will mean that your npm scripts can use the ds command directly from node_modules/:

"scripts": {
    "deploy": "ds deploy"
    "build": "ds build"
}

Example Usage

The following shows a typical way to use the ds command to work with a DeepStructure app, including authentication, creating an application, and deploying.

$ ds login

Using DS Cluster: prod
Please use the following link to login:
https://auth-service.deepstructure.app/auth/verify?....

✔ Login success! The CLI has a JWT :)
Selected team deepstructure.io.

$ ds app add my-ds-app
Successfully created application
Created application:  {
  id: '8082c2ec-37f8-4165-80cc-a0ab6c2937dd',
  name: 'my-ds-app',
  repo: 'git@github.com:Example/Example.git',
  domain: '(not set)',
  teamId: 'f0e0d40f-0e69-4b8c-858f-7a9f511a01f2',
  createdAt: '2024-04-05T13:15:06.078',
  updatedAt: '2024-04-05T13:15:06.078'
}

$ ds deploy

Commands

Below is a summary of the available commands and their primary functions. For detailed usage of each command, including options and examples, you can run ds <command> --help.

Applications

Add Application: Adds a new application to your DeepStructure Cloud account.
```
ds app add [name]
```
Remove Application: Removes an existing application.
```
ds app rm [name]
```
List Applications: Lists all applications associated with your account.
```
ds app list
```

Deployment

Deploy Application: Deploys your application to DeepStructure Cloud.
```
ds deploy
```
List Deployments: Lists all deployments for a specific application.
```
ds list [app]
```
Tear Down Deployment: Removes a specific deployment.
```
ds down <id>
```

Development

Run Development Server: Starts a local version of your application (currently only works in dev container).
```
ds dev
```
Build Application: Builds your application for deployment to the .ds/ directory.
```
ds build
```

Environment and Secrets

Set Environment Variable: Sets an environment variable for your application.
```
ds env set <name> <value>
```
Unset Environment Variable: Removes an environment variable.
```
ds env unset <name>
```
List Environment Variables: Lists all environment variables.
```
ds env list
```
Set Secret: Sets a secret for your application.
```
ds secret set <name> <value>
```
Unset Secret: Removes a secret.
```
ds secret unset <name>
```
List Secrets: Lists all secrets.
```
ds secret list
```

Miscellaneous

Login: Logs in to DeepStructure Cloud.
```
ds login
```
Select Team: Selects the team to use for the logged-in user.
```
ds team
```
Stream Logs: Streams logs from the current environment.
```
ds logs
```
Open Shell: Opens a shell in a remote development environment.
```
ds shell
```