Pular para o conteúdo
diegohacksInteligência Artificial
IA-OS // subir-na-web
Curso de Introdução · Guia 3 de 3Colocar seu sistema na internet

ETAPA 10 DE 12 25 MIN

Publicar no Coolify

Conectar o repositório, construir pelo Dockerfile e publicar no seu domínio.

Seu computadorMeu computador é

Agora o Coolify pega o seu código do GitHub, monta o sistema e coloca no ar em https://seudominio.com.br. Daqui em diante, cada git push publica sozinho.

Como o Coolify vai ler o seu repositório

O repositório é privado, então o Coolify precisa de permissão para ler.

Aplicativo do GitHub (GitHub App)RECOMENDADO

PONTOS FORTES

  • Você escolhe no GitHub quais repositórios ele vê: só o deste sistema.
  • Publica sozinho a cada git push, sem configuração extra.

PONTOS FRACOS

  • Tem alguns cliques a mais na primeira vez (criar o aplicativo e instalar).

Chave de deploy (deploy key)

PONTOS FORTES

  • Uma chave que abre só um repositório, e só para ler.

PONTOS FRACOS

  • Para publicar sozinho a cada push, você configura um aviso (webhook) à mão no GitHub.
  • Um sistema novo pede uma chave nova, repetindo tudo.

Ligar o GitHub ao Coolify

  1. No Coolify, abra Sources no menu e clique em + Add (ou New source), GitHub App.
  2. Dê um nome, como meu-github. Deixe o campo de organização vazio (o repositório é da sua conta pessoal) e clique em Continue.
  3. Escolha Use an instance endpoint (o endereço https://painel.seudominio.com.br) e clique em Register with GitHub.
  4. O GitHub abre: clique em Create GitHub App.
  5. De volta ao Coolify, clique em Install repositories. No GitHub, escolha Only select repositories, selecione meu-primeiro-sistema e clique em Install.

Criar o sistema no Coolify

  1. Abra Projects, clique em + Add, dê o nome meu-primeiro-sistema e entre no projeto (ambiente production).
  2. Clique em + New e escolha Private Repository (with GitHub App).
  3. Escolha o servidor localhost e o aplicativo meu-github.
  4. Escolha o repositório meu-primeiro-sistema, a branch main e clique em Load Repository.

Montar pelo Dockerfile

O Coolify pergunta como montar o sistema (o Build Pack).

DockerfileRECOMENDADO

PONTOS FORTES

  • A receita está escrita no repositório: o Coolify monta exatamente o que a demo testa.
  • Já vem com usuário sem poder de administrador e com a conferência de saúde.

PONTOS FRACOS

  • Se um dia o sistema mudar muito, a receita também precisa mudar (o Claude ajuda).

Nixpacks (o Coolify adivinha)

PONTOS FORTES

  • Funciona sem receita nenhuma em muitos projetos.

PONTOS FRACOS

  • O Coolify decide como montar, e uma atualização dele pode mudar o resultado sem você mexer em nada.
  • Ignora as proteções que o Dockerfile da demo já traz.

Escolha Dockerfile e continue. Na tela do sistema, confira e preencha:

  • Ports Exposes: 3000 (a porta em que a demo responde dentro do servidor).
  • Domains: o seu domínio com https://, e o www separado por vírgula:
https://seudominio.com.br,https://www.seudominio.com.br

Clique em Save.

Dizer à demo qual é o endereço dela

A demo recusa qualquer endereço que não esteja na lista dela. Abra a aba Environment Variables do sistema, clique em + Add e crie:

  • Nome: HOSTS_PERMITIDOS
  • Valor: seudominio.com.br,www.seudominio.com.br (o seu, sem https://)

Salve. Não é segredo: é só a lista de nomes em que a demo pode responder.

Publicar

Clique em Deploy (no alto). O Coolify abre o registro da publicação: ele baixa o código, monta a imagem pelo Dockerfile e liga o sistema. A primeira vez leva uns 3 a 5 minutos. Quando terminar, o estado fica Running (rodando) e saudável.

Abra https://seudominio.com.br: cadeado ao lado do endereço, Você conseguiu! e Seu sistema está no ar, na internet, com cadeado.

No terminal, dentro da pasta meu-primeiro-sistema, confira de fora trocando pelo seu domínio:

Não deu certo? Veja o que fazer
  • O repositório não aparece na lista: o aplicativo do GitHub não tem acesso a ele. No GitHub, Settings, Applications, o aplicativo meu-github, Configure, e acrescente meu-primeiro-sistema em Only select repositories.
  • O navegador avisa que a conexão não é segura: o certificado ainda não saiu. Confira com nslookup seudominio.com.br se aponta para o servidor, espere alguns minutos e clique em Redeploy.
  • Bad Gateway ou no available server: a porta está diferente de 3000 em Ports Exposes, ou o sistema ainda está ligando. Confira, salve e clique em Redeploy.
  • A página diz que a demo só responde no seu computador (erro 403): a variável HOSTS_PERMITIDOS está faltando ou com o nome do domínio diferente do que está em Domains. Corrija e clique em Redeploy.
  • A publicação falhou: copie as últimas linhas do registro e mostre ao Claude: "A publicação no Coolify falhou com este erro: (cole aqui). O que aconteceu?".

Travou nesta etapa? Me conta o que aconteceu.

ESTE GUIA FAZ PARTE DE UM CURSO

Curso de Introdução

Três guias, na ordem, para sair do zero e ter o seu próprio sistema funcionando com a ajuda do Claude. Não precisa saber programar.

Este é o guia 3 de 3.

Ver o curso completo →