Como usar container Docker para aplicação customizada — Guia para iniciantes (com carinho, como um Sensei)
Olá, viajante da tecnologia! Se você chegou até aqui, provavelmente quer dar um passo além do simples site estático e colocar sua aplicação personalizada para rodar com mais liberdade e controle. Que bom que você está aqui!
Com o Docker, você pode embalar sua aplicação — junto com todas as suas dependências — como um "container", como se fosse uma caixa mágica que funciona igual em qualquer lugar. E aqui na GeHost, você pode usar isso com segurança, sem precisar de servidores complexos.
Este guia vai te levar, passo a passo, como configurar e rodar um container Docker com sua aplicação personalizada — mesmo que você nunca tenha usado Docker antes. Acalme-se, vamos juntos. Você já está no caminho certo.
Antes de começar: o que você precisa saber
- Você precisa ter acesso ao cPanel da sua conta na GeHost.
- Sua aplicação deve estar pronta: código, arquivos, configurações.
- Se for uma aplicação web (como uma API ou site em Node.js, Python, PHP, etc.), ela precisa de uma porta aberta (ex: 8080).
- Não se preocupe com servidores reais — tudo acontece dentro do seu espaço na GeHost.
Dica do Sensei: Se você ainda não tem uma aplicação pronta, comece com um simples "Hello World" em Node.js ou Python. Assim, você aprende o caminho sem pressa.
Passo 1: Acesse o cPanel
Primeiro, faça login no seu cPanel com seu usuário e senha.
Passo 2: Acesse o Docker (em "Outras Ferramentas")
Depois de logado, procure na barra lateral por “Outras Ferramentas” e clique em Docker.
Se você não vir o Docker, verifique com o suporte da GeHost — pode ser que precise ativar o recurso para sua conta.
Passo 3: Crie seu container com uma imagem pronta
O Docker funciona com imagens — como modelos prontos para aplicativos. Por exemplo:
nginx— para servir páginas estáticas.node:18— para rodar aplicativos em Node.js.python:3.11— para aplicativos em Python.
Para começar, vamos criar um container com uma imagem simples. No cPanel, clique em “Criar Container”.
Na tela que aparecer, preencha:
- Nome do container: Ex:
meu-app. - Imagem: Ex:
node:18. - Porta de host: Ex:
8080(essa será a porta que você acessa pelo navegador). - Comando de inicialização: Ex:
npm start(se for um app Node.js). - Volume (opcional): Se quiser salvar dados, você pode mapear uma pasta do servidor.
Dica do Sensei: Se você não souber qual imagem usar, comece comnginxoupython:3.11. Elas são bem amigáveis!
Passo 4: Envie sua aplicação para o servidor
Seu container precisa dos arquivos da sua aplicação. Use o Gerenciador de Arquivos do cPanel para subir seus arquivos.
1. Vá em Arquivos → Gerenciador de Arquivos.
2. Navegue até a pasta public_html ou crie uma nova pasta (ex: app).
3. Arraste e solte seus arquivos (HTML, JS, Python, etc.) lá dentro.
Passo 5: Configure o Docker para usar seus arquivos
Volte ao Docker no cPanel. Agora, no campo Volume ou Mount, você pode mapear a pasta onde seus arquivos estão.
Exemplo:
- Path no container:
/app - Path no servidor:
/home/seu-usuario/public_html/app
Isso faz com que o container veja seus arquivos como se estivessem dentro dele.
Passo 6: Inicie o container e teste
Após configurar tudo, clique em “Iniciar” ou “Criar e Iniciar”.
Depois de iniciado, você pode ver o status do container na lista. Quando estiver "Rodando", acesse:
http://seu-dominio.com:8080
Substitua seu-dominio.com pelo seu domínio real. Se tudo estiver certo, sua aplicação aparecerá!
Dica do Sensei: Se não funcionar, verifique se a porta está correta, se o comando de inicialização está certo e se os arquivos estão no lugar certo.
Passo 7: Gerencie seu container (opcional)
Com o tempo, você pode:
- Parar o container quando não estiver usando.
- Reiniciar caso algo falhe.
- Remover se quiser começar de novo.
- Ver logs para entender erros (clique em "Logs" no Docker).
Conclusão: Você está no caminho certo!
Parabéns, viajante! Você acabou de colocar sua aplicação customizada em um container Docker, com tudo dentro de seu espaço na GeHost. Isso é poder — e você o conquistou com calma, paciência e um bom coração.
Se tiver dúvidas, não hesite em entrar em contato com nosso suporte. Estamos aqui para te ajudar, sempre.
Até a próxima aventura, com código limpo e coração leve.
Com carinho,
O Sensei da GeHost
