Equipe, domínios, backup e RAM: como funciona na MyBotCloud

Publicado em 5 min de leitura

Moderadores com permissões, subdomínios e domínio próprio, backup e importação do código, RAM, nome e avatar: como cada recurso funciona, no terminal e no VS Code.

Além de publicar o bot, as ferramentas do desenvolvedor da MyBotCloud (o CLI mybotcloud e a extensão do VS Code) deixam você ajustar a RAM, renomear, trocar o avatar, baixar o código, convidar moderadores e apontar domínios. Este guia explica o que cada recurso faz, como usá-lo e onde estão os limites, para você não ter surpresas.

Se você ainda não configurou as ferramentas, comece por Publique seu bot pelo terminal, VS Code ou IA (MCP). Tudo abaixo vale para o CLI e para a extensão; na extensão, clique com o botão direito numa app na barra lateral ou use a paleta de comandos (Ctrl+Shift+P, digite mybotcloud).

O que você vê na barra lateral

A barra lateral do VS Code mostra:

  • Conta: plano, a RAM do plano (dividida entre os seus bots) e quantas aplicações você usa.
  • Meus aplicativos: nuvem verde (no ar), cinza (pausada) ou vermelha (com falha). Ao expandir: estado, memória, CPU, disco e rede, tempo ativo, reinícios, linguagem e avatar.
  • Apps de equipe: aparecem só se alguém convidou você como moderador. Mostram o dono e as suas permissões.
  • Domínios: seus subdomínios e domínios próprios, com o estado de cada um.

No CLI, mybotcloud status mostra os mesmos números: estado, memória, CPU, disco e rede.

RAM

mybotcloud ram 80

A RAM do plano é um pool dividido entre os seus bots (Start: 100 MB, Pulse: 1 GB, Orbit: 2 GB). Você escolhe a RAM de cada bot entre 64 MB e o que sobra do pool (o que os outros bots já usam não entra). O servidor confere de novo: um valor fora disso é recusado e nada muda. A mudança vale na hora para o container e permanece nos próximos deploys.

Duas observações honestas:

  • Baixar a RAM de um bot libera RAM do pool para os outros bots; o preço do plano não muda.
  • Abaixo do que o seu bot precisa, o sistema o encerra por falta de memória. Se o bot cair, aumente de novo.

O mybotcloud.config também é atualizado (ram), e o deploy deixa de avisar que o valor foi ignorado.

Nome e avatar

mybotcloud rename "Meu Bot Novo"
mybotcloud avatar https://exemplo.com/logo.png
mybotcloud avatar --clear

O nome tem de 2 a 40 caracteres (letras, números, espaço, _ e -). Como a pasta fica ligada à app pelo id gravado no mybotcloud.config, renomear não cria outra app.

O avatar é uma URL https de até 300 caracteres. A plataforma só guarda o endereço: ela nunca baixa a imagem.

Backup e importar

mybotcloud backup meu-backup.zip          # baixa o código agora
mybotcloud backup create                  # guarda um instantâneo na plataforma
mybotcloud backup list
mybotcloud backup get 12 meu-backup.zip   # baixa o instantâneo #12 (sem número, o mais novo)
mybotcloud import minha-pasta --app meu-bot

O backup é o código da app em um ZIP. Não entram as dependências (node_modules, venv; o deploy as reinstala) nem as variáveis de ambiente: elas ficam fora da pasta do código e os valores nunca saem do container.

A plataforma guarda os 3 backups mais recentes de cada app; ao criar o quarto, o mais antigo é apagado. Apagar a app apaga os backups dela.

O importar baixa esse ZIP para uma pasta e cria um mybotcloud.config já ligado à app (sem chave dentro). Serve para continuar o trabalho em outra máquina: numa pasta vazia, basta ter a chave em MYBOTCLOUD_KEY e o nome da app.

Por segurança:

  • o importar nunca escreve fora da pasta de destino;
  • não sobrescreve arquivos que já existem (use --force se quiser);
  • o conteúdo do backup é tratado como não confiável: só arquivos comuns, sem links, sem caminhos absolutos ou com .., com limite de tamanho (20 MB).

Se a app estiver pausada, inicie-a antes: o código é lido de dentro do container.

Equipe (moderadores)

mybotcloud team add [email protected] --perms control,env
mybotcloud team list
mybotcloud team set [email protected] --perms deploy
mybotcloud team remove [email protected]

O dono convida uma pessoa pelo e-mail da conta dela (ela precisa já ter entrado no mybotcloud ao menos uma vez). Cada app aceita até 5 moderadores. As permissões:

PermissãoO que libera
viewVer status e logs (sempre incluída)
controlIniciar, parar e reiniciar
deployAtualizar o código e baixar o backup
envVer os nomes e alterar as variáveis

Só o dono pode apagar a app, renomear, mudar RAM e avatar, gerenciar a equipe e os domínios. Se o moderador tentar, recebe uma mensagem de que não tem permissão. Quem não tem acesso nenhum recebe "não encontrada", como se a app não existisse.

O moderador vê a app em Apps de equipe (na extensão) ou na lista de apps da API, com o e-mail do dono e as suas permissões, e pode sair da equipe quando quiser. A app de equipe não consome a cota de apps dele. Se o dono apagar a app, os acessos acabam junto.

Domínios

mybotcloud domains add --sub meubot --port 3000
mybotcloud domains add --host bot.exemplo.com --port 3000
mybotcloud domains verify bot.exemplo.com
mybotcloud domains list

Há dois tipos:

  • Subdomínio da plataforma (meubot.<domínio da plataforma>): fica ativo na hora. Vale o primeiro que pedir. Use de 3 a 30 letras, números e hífen; nomes como admin, api e www são reservados.
  • Domínio próprio (bot.exemplo.com): nasce pendente. Para provar que o domínio é seu, crie no DNS um registro TXT em _mybotcloud-challenge.bot.exemplo.com com o valor mbc-verify=... (o comando mostra o valor exato) e rode domains verify. A propagação do DNS pode levar alguns minutos; se ainda não achou, tente de novo.

A porta é a que o seu app escuta, entre 1024 e 65535. O número de domínios depende do plano (Start: 1; Pulse: 5; Orbit: 10).

Importante: o roteamento HTTP ainda não está ativo. Hoje a plataforma registra e verifica os domínios, mas ainda não serve tráfego HTTP/HTTPS para eles. A lista mostra esse aviso. Esse passo depende de infraestrutura (um proxy reverso com HTTPS e DNS curinga) que será ativada separadamente. Para bots de Discord, que só fazem conexões de saída, isso não muda nada.

Na extensão do VS Code

O que fazerComando
Mudar RAMAlterar a RAM
Renomear / avatarRenomear a app / Definir o avatar
Guardar um backup na plataformaBackup Application (os 3 mais recentes ficam guardados)
Baixar um backupDownload Backup
Trazer para uma pastaImportar o código da app para uma pasta
ModeradoresGerenciar equipe (moderadores): adicionar, mudar permissões, remover
DomíniosAdicionar domínio, Verificar domínio (DNS), Remover domínio

Ao adicionar um domínio próprio, a extensão mostra o registro TXT que você precisa criar. O menu de contexto de cada app mostra só o que o seu papel permite: as apps de equipe não mostram as ações exclusivas do dono.

O que não existe (ainda)

  • Terminal remoto: não há. Abrir um shell dentro dos containers é uma decisão de segurança que o projeto adiou. Nem o servidor MCP, que serve assistentes de IA, tem uma ferramenta de execução de comandos.
  • Servir HTTP nos domínios: veja o aviso acima.
  • Telas de equipe e domínios no painel web: por enquanto são só CLI, extensão e API.

Ficou com dúvida? Abra um ticket em Suporte no painel.

  • equipe
  • domínios
  • backup
  • vscode
  • cli

← Voltar ao blog