> ## 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 com GitHub Actions

> Atualize uma aplicação DSCloud existente com um workflow que envia seu ZIP à API v3.

Crie a aplicação pelo [painel](https://docs.dscloud.pt/getstarted/deploy-panel.md) e guarde seu ID. O workflow envia um ZIP para a [rota de commit](https://docs.dscloud.pt/api-reference/endpoint/apps/commit.md) e solicita o reinício após o envio.

### 1. Configure os secrets

No GitHub, abra **Settings → Secrets and variables → Actions**. Crie os secrets `DSCLOUD_API_KEY` com a [chave da sua conta](https://docs.dscloud.pt/api-reference/authentication.md) e `DSCLOUD_APP_ID` com o ID da aplicação. Se o suporte informar outro endereço HTTPS, configure a variável de repositório `DSCLOUD_API_BASE_URL` com o sufixo `/v3`.

### 2. Crie o workflow

Salve como `.github/workflows/deploy.yml`. O exemplo empacota os arquivos versionados da raiz a cada push para `main`. Use um repositório em que `dscloud.config` e os arquivos necessários estejam na raiz e retire credenciais dos arquivos versionados.

```yaml .github/workflows/deploy.yml theme={null}
name: Deploy na DSCloud
on:
  push:
    branches: [main]
  workflow_dispatch:
permissions:
  contents: read
concurrency:
  group: dscloud-deploy
  cancel-in-progress: false
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Enviar ZIP e reiniciar
        env:
          DSCLOUD_API_KEY: ${{ secrets.DSCLOUD_API_KEY }}
          DSCLOUD_APP_ID: ${{ secrets.DSCLOUD_APP_ID }}
          DSCLOUD_API_BASE_URL: ${{ vars.DSCLOUD_API_BASE_URL || 'https://api.dscloud.pt/v3' }}
        run: |
          git archive --format=zip --output="$RUNNER_TEMP/projeto.zip" HEAD
          base="${DSCLOUD_API_BASE_URL%/}"
          curl --proto '=https' --fail-with-body --request POST \
            --header "Authorization: ${DSCLOUD_API_KEY:?Configure DSCLOUD_API_KEY}" \
            --form "file=@$RUNNER_TEMP/projeto.zip;type=application/zip" \
            "$base/apps/${DSCLOUD_APP_ID:?Configure DSCLOUD_APP_ID}/commit"
          curl --proto '=https' --fail-with-body --request POST \
            --header "Authorization: $DSCLOUD_API_KEY" \
            "$base/apps/$DSCLOUD_APP_ID/restart"
```

### 3. Confira a execução e os logs

Abra o workflow na aba **Actions** e confirme que os dois pedidos foram aceitos. Em seguida, confira o estado e os logs da aplicação no [painel](https://dscloud.pt/dashboard).

> [!NOTE]
>
> Este workflow usa a API REST e precisa de um endpoint HTTPS operacional. Ele funciona com `actions/checkout`, Git e cURL. Veja a [disponibilidade da API](https://docs.dscloud.pt/api-reference/introduction.md) antes de ativar o workflow.


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