> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/faq/general-questions/how-to-commit.md).

# Como fazer commit?

Atualize os arquivos de uma aplicação que já está na Discloud, sem enviar o projeto inteiro de novo.

O **commit** atualiza os arquivos de uma aplicação que já está hospedada na Discloud. Em vez de enviar o projeto inteiro de novo, você envia só o que mudou.

***

## 🧩 Como o commit funciona

A Discloud usa o **caminho de cada arquivo dentro do `.zip`** para saber onde colocá-lo no projeto, contando a partir da [raiz do projeto](https://docs.discloud.com/faq/general-questions/what-is-the-root-of-the-project.md):

* Se já existe um arquivo nesse caminho, ele é **substituído**.
* Se não existe, um arquivo **novo** é criado.
* Os arquivos que você não enviou **continuam como estão**.

<figure><img src="https://696530983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvUqkKIFudeQ2TQOirm35%2Fuploads%2F9qjOXqrDTLtDOGojAprW%2Fcommit-flow.png?alt=media&amp;token=3bb94a88-76f3-4b22-8e79-7cd24930fe3d" alt="Um .zip com src/comandos/ping.js atualiza apenas esse arquivo na aplicação"><figcaption><p>Só o <code>ping.js</code> é enviado. O resto do projeto não muda.</p></figcaption></figure>

{% hint style="warning" %}
**Maiúsculas e minúsculas fazem diferença.** A Discloud roda em Linux, onde `comandos` e `Comandos` são pastas diferentes. O mesmo vale para arquivos: `config.json` e `Config.json` não são o mesmo arquivo.
{% endhint %}

***

## 📦 Preparando o `.zip`

{% stepper %}
{% step %}
**Encontre o caminho do arquivo.**

Veja onde o arquivo está no seu projeto, a partir da raiz. Por exemplo: `src/comandos/ping.js`.
{% endstep %}

{% step %}
**Recrie as mesmas pastas.**

Coloque o arquivo dentro das mesmas pastas, com os mesmos nomes e a mesma extensão:

```
atualizacao.zip
└── src/
    └── comandos/
        └── ping.js
```

{% endstep %}

{% step %}
**Comprima o conteúdo, não a pasta do projeto.**

Selecione as pastas e arquivos que mudaram e comprima. Se você comprimir a pasta do projeto inteira (por exemplo, `meu-bot/`), ela entra no caminho e os arquivos vão para o lugar errado.
{% endstep %}

{% step %}
**Confira antes de enviar.**

Abra o `.zip`: a primeira coisa dentro dele deve ser `src/`, e não `meu-bot/`.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Use o [`.discloudignore`](https://docs.discloud.com/configurations/.discloudignore.md) para deixar arquivos desnecessários de fora dos seus commits.
{% endhint %}

***

## ⚠️ Erros comuns

Imagine que o arquivo original está em `src/comandos/ping.js`:

<table><thead><tr><th width="260">Você enviou</th><th>O que acontece</th></tr></thead><tbody><tr><td>✅ <code>src/comandos/ping.js</code></td><td>O arquivo original é atualizado.</td></tr><tr><td>❌ <code>src/Comandos/ping.js</code></td><td>É criada uma pasta nova <code>Comandos/</code> ao lado de <code>comandos/</code>. O bot continua usando o arquivo antigo.</td></tr><tr><td>❌ <code>meu-bot/src/comandos/ping.js</code></td><td>A pasta <code>meu-bot/</code> é criada dentro do projeto, com uma cópia do arquivo. O original não muda.</td></tr><tr><td>❌ <code>ping.js</code></td><td>É criado um <code>ping.js</code> na raiz do projeto. O <code>src/comandos/ping.js</code> não muda.</td></tr></tbody></table>

{% hint style="info" %}
Se o commit não teve efeito, procure no projeto uma pasta duplicada como as da tabela. Normalmente o arquivo foi para o caminho errado.
{% endhint %}

***

## 🚀 Enviando o commit

{% tabs %}
{% tab title="🤖 Bot do Discord" %}
{% stepper %}
{% step %}
Vá ao canal [**`#🔌・commands`**](https://discord.com/channels/584490943034425391/1051126795883261962) no **Servidor Discord da Discloud**.
{% endstep %}

{% step %}
Execute o comando:

```
/commit
```

{% endstep %}

{% step %}
Envie o seu `.zip` quando o bot solicitar.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="⌨️ CLI" %}
Na raiz do projeto, execute:

```bash
discloud app commit <ID_DA_APLICACAO>
```

A [CLI](https://docs.discloud.com/deployment-methods/cli.md) monta o `.zip` por você a partir da pasta atual, por isso execute o comando na raiz do projeto. Também funciona a forma curta `discloud app c`.
{% endtab %}

{% tab title="🟦 VS Code" %}
{% stepper %}
{% step %}
No explorador de arquivos do VS Code, selecione os arquivos e pastas que mudaram.
{% endstep %}

{% step %}
Clique com o botão direito e escolha **Discloud > Commit**.
{% endstep %}

{% step %}
Escolha a aplicação que vai receber o commit.
{% endstep %}
{% endstepper %}

Veja como instalar e entrar na [extensão do VS Code](https://docs.discloud.com/deployment-methods/visual-studio-code.md).
{% endtab %}

{% tab title="🐙 GitHub" %}
Com a [Integração com GitHub](https://docs.discloud.com/deployment-methods/github-integration.md), a aplicação é atualizada a partir do seu repositório, sem precisar montar `.zip`.
{% endtab %}
{% endtabs %}

***

## ✅ Antes de enviar, confira

* O caminho é o mesmo do projeto, a partir da raiz.
* Os nomes de pastas e arquivos são iguais, com as mesmas maiúsculas e minúsculas.
* A extensão está certa (`ping.js`, não `ping.js.txt`).
* O `.zip` começa direto nas pastas do projeto, sem a pasta do projeto por fora.

***

## ❓ Ainda precisa de ajuda?

Veja [**Soluções de Problemas**](https://docs.discloud.com/faq/troubleshooting-solutions.md) ou junte-se ao nosso [**Servidor Discord**](https://discord.discloudbot.com/) para suporte.
