Como usar container Docker básico em hospedagem compartilhada

Como usar container Docker básico em hospedagem compartilhada (com suporte SSH)

Olá, viajante do conhecimento! 👋 Seja bem-vindo ao nosso guia especial para quem quer experimentar o mundo dos containers Docker mesmo em uma hospedagem compartilhada — sim, é possível! Aqui, você vai aprender passo a passo como rodar um container simples, com segurança, sem precisar de root ou servidor dedicado. Vamos com calma, como se fosse uma conversa entre amigos no café da manhã. ☕

Antes de começar: o que é Docker e por que isso importa?

Imagine um ambiente isolado dentro do seu servidor — como uma caixinha que carrega tudo que você precisa para rodar um programa (como um site, uma API ou até um jogo). Esse é o Docker. Ele permite que você "empacote" um software com suas dependências, e rode em qualquer lugar, sem se preocupar com conflitos.

Dica do Sensei: Em hospedagem compartilhada, o Docker não é instalado por padrão, mas com acesso via SSH e algumas ferramentas básicas, você pode rodar containers simples — desde que respeite os limites da sua conta.

Pré-requisitos: o que você precisa ter

• Conta de hospedagem GeHost com acesso SSH (ativado na sua conta).
• Conexão SSH com o servidor (use um cliente como Putty ou Termius).
• Um domínio ou subdomínio apontado para a sua hospedagem.
• Conhecimento básico de comandos no terminal (não se preocupe — vamos ensinar tudo).

Passo a passo: rodando seu primeiro container Docker

1. Faça login via SSH

Abra seu terminal ou cliente SSH e conecte-se ao servidor usando suas credenciais (usuário e senha da GeHost).

Exemplo de comando:

ssh seu_usuario@seu_servidor.gehost.com.br

2. Verifique se o Docker está disponível

Em hospedagem compartilhada, o Docker não é instalado por padrão. Mas, em alguns casos, a GeHost oferece um ambiente pré-configurado com Podman (um substituto seguro e compatível com Docker).

Teste com este comando:

podman --version

Se aparecer a versão, você está pronto para seguir. Se não, verifique com o suporte da GeHost se há suporte a containers.

3. Crie uma pasta para o container

Vamos organizar tudo em um local específico. No terminal, digite:

mkdir ~/docker-nginx

Depois, entre na pasta:

cd ~/docker-nginx

4. Crie um arquivo de configuração simples (para testar)

Queremos rodar um servidor web simples (nginx) como container. Vamos criar um arquivo chamado index.html:

echo "<h1>Olá do Docker!</h1><p>Este site está rodando dentro de um container.</p>" > index.html

Isso cria uma página simples com uma mensagem de boas-vindas.

5. Execute o container com o comando Podman

Agora vamos rodar o container nginx, expondo a porta 8080 do servidor para o seu navegador:

podman run -d -p 8080:80 -v $PWD:/usr/share/nginx/html:ro nginx

Explicando o comando:

• -d: roda em segundo plano (detached).
• -p 8080:80: mapeia a porta 8080 do servidor para a porta 80 do container.
• -v $PWD:/usr/share/nginx/html:ro: monta a pasta atual como conteúdo do nginx (leitura apenas).
• nginx: imagem oficial do nginx.

6. Acesse seu container pelo navegador

Abra seu navegador e vá para:

http://seu_servidor.gehost.com.br:8080

Se tudo deu certo, você verá a página que criamos: “Olá do Docker!” 🎉

7. (Opcional) Verifique os containers em execução

Para ver se o container está rodando, use:

podman ps

Isso mostra uma lista com os containers ativos. Você verá algo como:

CONTAINER ID  IMAGE   COMMAND   CREATED   STATUS   PORTS      NAMES

Se o seu container aparecer, está tudo certo!

8. Interrompa o container quando quiser

Quando terminar de testar, pare o container com:

podman stop CONTAINER_ID

Substitua CONTAINER_ID pelo ID que apareceu no comando podman ps.

Importante: limitações e boas práticas

• Em hospedagem compartilhada, você não tem acesso root, então não pode instalar Docker diretamente.
• Use apenas containers com imagem oficial e segura (como nginx, alpine, node, etc.).
• Evite usar containers que consumam muitos recursos (CPU, memória).
• Seu container só será acessível via porta (ex: 8080), não via domínio direto — use um subdomínio ou proxy se precisar.
• Não armazene dados persistentes no container — use o sistema de arquivos da hospedagem.

Conclusão: você está no caminho certo!

Parabéns, aluno! Você acaba de rodar seu primeiro container Docker (ou Podman) em uma hospedagem compartilhada. Isso é um grande passo rumo à autonomia e criatividade no desenvolvimento.

Lembre-se: o Docker não é só para profissionais — ele é uma ferramenta que pode ajudar qualquer um a testar, aprender e prototipar com segurança.

Do Sensei: “A jornada de mil quilômetros começa com um único passo. Hoje, você deu esse passo com coragem e curiosidade. Continue assim!” 🌟

Se tiver dúvidas, não hesite em entrar em contato com o suporte da GeHost. Estamos aqui para te ajudar a crescer. Até a próxima aventura! 🚀