> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dscloud.pt/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy pela CLI

> Instale a CLI da DS Cloud a partir do código-fonte e publique aplicações com o comando dscloud.

Você precisa de **Node.js 18+**, npm, uma [chave de API](https://docs.dscloud.pt/api-reference/authentication.md) e o `dscloud.config` na raiz do projeto.

> [!NOTE]
>
> O pacote público `dscloud-cli` no npm pertence ao DroidScript Cloud e instala o comando `cloud`. A CLI da DS Cloud usa `dscloud`. Use uma cópia do código ou um pacote fornecido pela equipe da DS Cloud. Para publicar sem a CLI, siga o [guia do painel](https://docs.dscloud.pt/getstarted/deploy-panel.md).

### 1. Instale e confira a CLI

Com uma cópia autorizada do código, substitua `/caminho/para/DsCloudCLI` pela pasta que contém o `package.json` da CLI.

```bash Terminal theme={null}
npm install -g "/caminho/para/DsCloudCLI"
dscloud --version
dscloud --help
```

### 2. Autentique o terminal

Defina `DSCLOUD_API_KEY` na sessão usando seu gerenciador de segredos. A CLI lê a variável antes do arquivo de configuração. Consulte a [disponibilidade e a URL da API](https://docs.dscloud.pt/api-reference/introduction.md) antes de enviar a chave.

```bash Terminal theme={null}
dscloud whoami
```

O comando `dscloud login` salva a chave em `~/.dscloud/config.json`. Use a variável de ambiente em CI ou em máquinas compartilhadas.

### 3. Crie a aplicação

Execute na pasta que contém `dscloud.config`.

```bash Terminal theme={null}
dscloud deploy .
dscloud apps list
```

### 4. Confira o estado e envie atualizações

Defina `DSCLOUD_APP_ID` com o identificador exibido na listagem.

```bash Terminal theme={null}
dscloud apps status "$DSCLOUD_APP_ID"
dscloud apps logs "$DSCLOUD_APP_ID"
dscloud commit "$DSCLOUD_APP_ID" .
```

`commit` compacta o projeto, envia o ZIP e solicita o reinício da aplicação. A CLI também oferece `apps start`, `apps stop` e `apps restart`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.