Como subir um site com Docker

Como subir um site com Docker na GeHost 🐳

Olá, querido(a) aluno(a)! Aqui é a Sensei da GeHost, e hoje vamos desbravar juntos um assunto que parece complicado, mas que — com calma e o caminho certo — fica muito mais simples do que parece. Vamos falar sobre Docker: aquela "caixinha mágica" que empacota seu site direitinho pra ele funcionar em qualquer servidor, sem quebrar nada.

Respira fundo. Não precisa ser programador(a) pra entender a ideia. E, se na hora de executar o passo a passo a coisa apertar, a equipe de suporte da GeHost está ali pra te dar uma mão — são 30 dias de suporte grátis após a entrega do seu serviço. 💛

⚠️ Antes de tudo: Docker precisa de um VPS (ou Servidor Dedicado)

Essa é a informação mais importante do guia, então vamos deixar bem claro:

Docker NÃO roda nos planos de Hospedagem Compartilhada (Econômico, Básico, Médio, Plus). Esses planos usam cPanel e não dão acesso root nem permissão pra instalar softwares de sistema como o Docker.

Para rodar Docker, você precisa de um serviço da linha VPS (VPS Essential, VPS Start/Business ou VPS Pro/AI Ready) ou de um Servidor Dedicado (Bare Metal) da GeHost. Nesses serviços você tem acesso root e SSH — ou seja, o servidor é "seu" pra configurar como quiser.

Se você ainda não tem um VPS e quer saber qual atende melhor ao seu projeto, acesse o catálogo no painel painel.gehost.com.br ou abra um ticket pelo Suporte. A equipe vai te orientar sem compromisso.

📋 O que você vai precisar (pré-requisitos)

Um VPS ou Bare Metal ativo na GeHost, com sistema operacional Linux (AlmaLinux, Ubuntu ou Debian, conforme o plano).
Acesso SSH ao servidor (usuário root ou um usuário com permissão de administrador).
Um programa de terminal no seu computador: no Windows, use o PuTTY ou o Windows Terminal; no Mac/Linux, o próprio Terminal.
Os arquivos do seu site (código-fonte, banco de dados, imagens) organizados numa pasta no seu computador.
Um arquivo Dockerfile (ou docker-compose.yml) que descreve como o site deve ser empacotado. Se o desenvolvedor do seu site criou o projeto, ele geralmente já entrega esse arquivo junto.

💡 Dica da Sensei: Se você contratou um desenvolvedor ou agência, pergunte a ele(a): "Vocês entregam o projeto com Dockerfile ou docker-compose?". Se a resposta for sim, você já tem 90% do caminho andado!

🚀 Passo a passo: subindo seu site com Docker

Passo 1 — Acesse seu servidor via SSH

Abra o terminal (PuTTY, Windows Terminal, Terminal do Mac/Linux).
Digite o comando de conexão:
```
ssh root@SEU_IP_DO_VPS
```
(O IP do seu VPS está nos detalhes do serviço dentro do painel painel.gehost.com.br → Serviços → clique no seu VPS.)
Ao pedir a senha, digite a senha root que foi enviada na entrega do serviço. Atenção: a senha não aparece na tela enquanto você digita — é normal!
Se aparecer a mensagem pedindo para aceitar a chave do servidor (fingerprint), digite yes e pressione Enter.

🔒 Segurança: Nunca compartilhe sua senha root com terceiros. Se precisar dar acesso a um desenvolvedor, crie um usuário separado com permissões limitadas.

Passo 2 — Instale o Docker no servidor

Se o Docker ainda não estiver instalado (nos Bare Metals da GeHost ele já vem pronto; nos VPS, você instala), rode os comandos abaixo. Eles funcionam tanto em Ubuntu quanto em AlmaLinux/Debian:

# Atualizar pacotes do sistema
sudo apt update && sudo apt upgrade -y   # Ubuntu/Debian
# ou
sudo dnf update -y                        # AlmaLinux

# Instalar o Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Iniciar e ativar o Docker
sudo systemctl start docker
sudo systemctl enable docker

# Verificar se instalou certo
docker --version

Se aparecer algo como Docker version 27.x.x, parabéns — está instalado! 🎉

Passo 3 — Envie os arquivos do seu site para o servidor

Agora vamos colocar os arquivos do projeto lá dentro. Use o comando scp (que roda no terminal do seu computador, não no servidor):

scp -r /caminho/no/seu/computador/meu-site root@SEU_IP_DO_VPS:/opt/meu-site

Se preferir uma interface gráfica, programas como FileZilla ou WinSCP também funcionam: basta conectar via SFTP com o mesmo IP e senha do SSH e arrastar a pasta.

Passo 4 — Construa a imagem Docker

Volte ao terminal conectado no servidor (SSH) e entre na pasta do projeto:

cd /opt/meu-site

Se o projeto tem um Dockerfile na raiz, basta rodar:

docker build -t meu-site .

O Docker vai "cozinhar" a imagem: baixar dependências, copiar arquivos e preparar tudo pra rodar. Pode levar alguns minutos na primeira vez. Tenha paciência — é como esperar um bolo assar. 🍰

Se o projeto usa docker-compose.yml, o comando é ainda mais simples:

docker compose up -d --build

O -d roda em segundo plano (modo "detached"), pra você poder fechar o terminal sem derrubar o site.

Passo 5 — Confirme que o site está no ar

Liste os containers rodando:
```
docker ps
```
Você deve ver seu container com status Up.
Abra o navegador e acesse:
```
http://SEU_IP_DO_VPS:PORTA
```
(A "PORTA" é a que o Dockerfile ou o docker-compose define — por exemplo, 80, 3000, 8080. Consulte quem desenvolveu o site.)
Se a página carregar, parabéns! Seu site está rodando com Docker. 🥳

Passo 6 — Aponte seu domínio (opcional, mas recomendado)

Para que as pessoas acessem seusite.com.br em vez de um IP com número de porta:

No painel da GeHost, vá em Domínios → Meus Domínios e confirme que o domínio está ativo.
No Editor de Zona de DNS do domínio, crie um registro A apontando para o IP público do seu VPS.
Para HTTPS (o cadeadinho verde), instale um certificado SSL gratuito com o Certbot ou configure um proxy reverso (Nginx, Caddy, Traefik) dentro do próprio Docker.

💡 Dica da Sensei: Se você não tem familiaridade com proxy reverso e SSL, abra um ticket no Suporte da GeHost. A equipe pode te orientar sobre a melhor configuração pro seu caso.

🧹 Manutenção do dia a dia

Depois que o site está no ar, alguns comandos que você vai usar com frequência:

Parar o site: docker compose down (ou docker stop NOME_DO_CONTAINER)
Reiniciar após atualização: docker compose up -d --build
Ver logs (erros, acessos): docker compose logs -f
Ver se está tudo rodando: docker ps
Limpar imagens antigas: docker system prune -f (use com cuidado!)

⚠️ Backup! A GeHost orienta que, salvo contratação expressa de backup, a responsabilidade pelos backups é do cliente. Antes de qualquer atualização, faça um backup do banco de dados e dos arquivos. Um simples docker compose down bem feito evita sustos.

🤔 "Sensei, e se eu não quiser mexer com Docker?"

Sem problema nenhum! Se o seu site é um WordPress, uma landing page ou uma loja que funciona perfeitamente num cPanel, os planos de Hospedagem Compartilhada da GeHost (a partir do Econômico) são a escolha mais prática: você sobe os arquivos pelo Gerenciador de Arquivos, cria o banco de dados MySQL e pronto — sem terminal, sem linha de comando.

Docker brilha quando o projeto tem múltiplos serviços (app + banco + cache + fila de mensagens) ou quando você precisa de controle total do ambiente. Se é o seu caso, o VPS é o caminho. Se não é, o cPanel vai te servir muito bem — e com menos trabalho.

📞 Precisa de ajuda?

A Sensei entende: terminal preto com letras brancas pode dar um friozinho na barriga. Se travar em qualquer passo:

Abra um ticket: painel.gehost.com.br → Suporte → Abrir Ticket. Descreva o que você tentou fazer e cole o erro que apareceu.
WebChat: disponível no site da GeHost, pra perguntas rápidas.
E-mail: contato@entexp.com.br

Lembre-se: os 30 dias de suporte grátis contam a partir da entrega do serviço. Use-os sem medo — a equipe está ali pra isso mesmo.

🌸 Recado final da Sensei: Docker não é bicho de sete cabeças. É só uma caixinha que organiza seu site pra funcionar sempre igual, em qualquer lugar. Você não precisa entender cada linha de comando de cabeça — precisa saber onde colar e quando chamar ajuda. E a GeHost tá aqui pra isso. Boa jornada, e conta comigo! 💛