Domínio e subdomínio: como usar

Publicado em 2 min de leitura

Como apontar um subdomínio da MyBotCloud (nome sorteado, nunca escolhido) ou o seu próprio domínio pro seu bot, com roteamento HTTP real — painel, CLI e VS Code.

Um domínio ou subdomínio apontado pro seu bot na MyBotCloud serve tráfego HTTP de verdade, não fica só registrado. Este post explica os dois tipos, pelo painel, pelo CLI e pela extensão do VS Code.

Os dois tipos

Toda app pode ter um ou mais domínios apontados pra ela (quantos depende do plano — Start: 1; Pulse: 5; Orbit: 10):

  • Subdomínio da plataforma: fica ativo na hora, com um nome sorteado por nós de um pool fixo de países, estados e territórios (argentina.mybotcloud.io, nebraska.mybotcloud.io, por aí). Você não digita o próprio nome aqui — de propósito: um subdomínio de texto livre sob o nosso domínio deixaria qualquer pessoa pegar um nome curto e atraente ou criar um endereço pra se passar por outra marca. Não gostou do que saiu? Na aba Domínio do painel, clique em Sortear outro (no CLI ou na extensão, remova e adicione de novo); o endereço antigo para de funcionar na hora.
  • Domínio próprio (bot.exemplo.com): nasce pendente. Para provar que é seu, crie no DNS um registro TXT em _mybotcloud-challenge.bot.exemplo.com com o valor que a plataforma mostra, e depois verifique. A propagação do DNS pode levar alguns minutos — se a verificação ainda não achar o registro, só tente de novo um pouco depois.

Agora serve HTTP de verdade

Onde o roteamento está ligado (está, em produção), um domínio ativo não é só registro: uma requisição pra ele é levada direto até o servidor HTTP do seu app, na porta que você configurou. Se o seu bot só fala com o Discord e faz conexões de saída, nada disso importa pra você — pode ignorar. Se ele também roda um servidor web pequeno (uma página de status, um webhook, um painel próprio), é isso que faz seubot.mybotcloud.io responder de verdade.

Uma limitação importante: adicionar um domínio ou mudar a porta vale a partir do próximo deploy da app, não na hora num simples restart. Depois de criar um domínio ou mudar a porta, reenvie o código pela aba Atualizar (ou mybotcloud deploy / um git push, se usar integração com GitHub) para o endereço passar a funcionar.

Onde gerenciar

  • Painel: abra uma app, vá na aba Domínio — sorteie um subdomínio, adicione um domínio próprio, veja o registro de DNS a verificar, edite a porta ou remova um domínio.
  • CLI:
    mybotcloud domains add --sub --port 3000
    mybotcloud domains add --host bot.exemplo.com --port 3000
    mybotcloud domains verify bot.exemplo.com
    mybotcloud domains port bot.exemplo.com 8080
    mybotcloud domains list
    mybotcloud domains remove bot.exemplo.com
    
  • Extensão do VS Code: clique com o botão direito numa app (ou pela paleta de comandos) → Adicionar domínio, Verificar domínio (DNS), Remover domínio.

Seu bot também precisa guardar dados? Veja Banco de dados PostgreSQL: como usar.

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

  • domínios
  • subdomínios
  • painel
  • cli
  • vscode

← Voltar ao blog