Ctrlk
Sair da Documentação
For the complete documentation index, see llms.txt. This page is also available as Markdown.

discloud.config

Aprenda tudo sobre o arquivo de configuração para hospedar aplicações na Discloud.

📄 O que é discloud.config e para que serve?

É um arquivo de configuração que simplifica o processo de upload das suas aplicações na Discloud. Com este arquivo, você pode configurar facilmente as informações para cada aplicação que você faz upload no serviço de hospedagem.

📂 Localização do Arquivo discloud.config

✅ Localização Correta

O arquivo discloud.config deve estar na raiz do seu projeto.

your-project/           # ← DIRETÓRIO RAIZ
├── discloud.config     # ✅ OBRIGATÓRIO AQUI
├── package.json        # Arquivo raiz de exemplo
├── src/                # Pasta do código fonte
│   └── index.js        # Arquivo principal da aplicação
├── .gitignore          # Arquivos de configuração
└── README.md           # Documentação

❌ Localizações Inválidas

Essas localizações causarão falhas no upload:

your-project/
├── src/
│   └── discloud.config   # ❌ ERRO DE SUBPASTA
├── config/
│   └── discloud.config   # ❌ ERRO DE SUBPASTA
└── .github/
    └── discloud.config   # ❌ ERRO DE PASTA OCULTA

🛠️ Opções de configuração

Veja abaixo todas as opções de configuração para o arquivo discloud.config. Clique aqui para ver alguns exemplos de diferentes aplicações.

Defina informações para sua aplicação na plataforma de hospedagem, como NAME e AVATAR. Isso permite que você identifique facilmente sua aplicação no painel ou na extensão do Visual Studio Code. Veja:

  • NAME - determina o nome da sua aplicação na plataforma de hospedagem.

  • AVATAR - usa a URL da imagem como avatar para sua aplicação na plataforma de hospedagem.

Para que sua aplicação inicie corretamente na hospedagem, você precisa definir seu tipo usando a opção TYPE, definir o ponto de entrada com a opção MAIN, especificar a RAM máxima que pode usar com a opção RAM, e indicar a versão da linguagem com a opção VERSION. Veja abaixo:

  • TYPE - pode ter dois valores: bot ou site.

  • MAIN - deve conter o caminho para o arquivo principal da sua aplicação.

  • RAM - determina a quantidade máxima de RAM disponível para a aplicação.

  • VERSION - especifica a versão da linguagem do seu projeto.

Se o TYPE estiver definido como site, você também deve definir a opção ID com seu subdomínio. Veja mais aqui.

Para hospedar um site, é necessário um mínimo de 512MB de RAM, junto com um Plano Platinum.

Dependendo da linguagem de programação do seu projeto, você pode definir quais comandos serão executados para o processo de build e o comando para iniciar a aplicação usando as propriedades BUILD e START.

Para habilitar o reinício automático em caso de falhas, defina a opção AUTORESTART como true (disponível apenas para Plano Platinum ou superior).

Você pode instalar pacotes usando a opção APT.

  • BUILD - define o comando ou script para compilar o projeto.

  • START - define o comando ou script para iniciar o projeto.

  • AUTORESTART - garante que a aplicação reinicie automaticamente em caso de falha.

  • APT - permite especificar uma lista de pacotes a serem instalados.

Opções obrigatórias no seu discloud.config

Apenas um campo é obrigatório:

Todos os outros campos são opcionais e usarão padrões inteligentes se omitidos:

  • TYPE padrão é bot

  • RAM padrão é 100 (MB)

  • VERSION padrão é latest

🪅 Exemplos de arquivos discloud.config

Veja abaixo exemplos de arquivos discloud.config para 🤖 Bots Discord e 🌐 Sites e APIs.

Bot Discord feito em JavaScript onde o ponto de entrada é o arquivo index.js na raiz do projeto.

Bot feito em TypeScript onde o ponto de entrada é o arquivo index dentro da pasta build. A aplicação iniciará executando o script start do arquivo package.json.

Bot Discord feito em Python onde o ponto de entrada é o arquivo main.py na raiz do projeto.

Site simples com HTML puro, usando o subdomínio "friendbook" da conta do usuário.

API Web construída com Express.js, onde o arquivo de entrada é index.js dentro da pasta server. A aplicação iniciará executando o script start do arquivo package.json.

⚙️ Opções de configuração

O arquivo discloud.config contém configurações essenciais para sua aplicação Discloud. Abaixo estão as opções de configuração disponíveis junto com seus respectivos limites e descrições.

Opção
Limite / Valores
Descrição

NAME

1 - 30 caracteres

O nome da sua aplicação (usado para fins de exibição).

AVATAR

URL da imagem (.gif, .jpeg, .jpg, .png)

Uma URL para o avatar da aplicação. Formatos suportados: GIF, JPEG, JPG, PNG.

TYPE

bot / site

Define se a aplicação é um bot ou um site.

MAIN

Caminho relativo do arquivo

Especifica o arquivo principal que deve ser executado na pasta do projeto.

RAM

100 - 32000 MB

A quantidade de RAM alocada para a aplicação (varia por plano).

VERSION

latest / current / suja / specific

Define as opções de versionamento para o ambiente e dependências.

ID

Subdomínios definidos pelo usuário

Subdomínio personalizado para sua aplicação (apenas para sites).

BUILD

(Comandos de build personalizados)

Se especificado, define comandos para executar antes do início da aplicação (ex.: instalar dependências).

START

(Comando de início personalizado)

Substitui o comando de início padrão para lançar a aplicação.

AUTORESTART

true / false

Determina se o app deve reiniciar automaticamente se travar.

VLAN

true / false

Habilita Virtual LAN (VLAN) para rede interna entre aplicações.

HOSTNAME

(Hostname personalizado)

Especifica um hostname personalizado para a aplicação.

APT

(Lista de pacotes)

Instala dependências Linux adicionais necessárias pelo seu app. Veja pacotes disponíveis.

AnteriorCLISeguinteAPT

Última atualização