discloud.config
Aprenda tudo sobre o arquivo de configuração para hospedar aplicações na Discloud.
📄 O que é discloud.config e para que serve?
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
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=MyApp
AVATAR=https://i.imgur.com/bWhx7OT.png
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=bot
MAIN=index.js
RAM=100
VERSION=latestTYPE- 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.
TYPE=site
ID=your-subdomain
MAIN=index.js
RAM=100
VERSION=latest
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=npm run build
START=npm run start
AUTORESTART=true
APT=toolsBUILD- 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
discloud.configApenas um campo é obrigatório:
MAIN=index.jsTodos os outros campos são opcionais e usarão padrões inteligentes se omitidos:
TYPEpadrão ébotRAMpadrão é100(MB)VERSIONpadrão élatest
🪅 Exemplos de arquivos discloud.config
discloud.configVeja 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.
NAME=Lorito
TYPE=bot
MAIN=index.js
RAM=100
VERSION=latestBot 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.
NAME=Mee8
TYPE=bot
MAIN=build/index.js
START=npm run start
RAM=200
VERSION=latestBot Discord feito em Python onde o ponto de entrada é o arquivo main.py na raiz do projeto.
NAME=Dyna
TYPE=bot
MAIN=main.py
RAM=300
VERSION=latestSite simples com HTML puro, usando o subdomínio "friendbook" da conta do usuário.
NAME=Friendbook
TYPE=site
MAIN=index.html
RAM=512
VERSION=latest
ID=friendbookAPI 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.
NAME=Crud cinema
TYPE=site
MAIN=server/index.js
START=npm run start
RAM=512
VERSION=latest
ID=moviemark⚙️ 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.
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.
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.
Last updated