Como usar Python/Django na hospedagem com uWSGI ou Gunicorn Print

Como usar Python/Django na hospedagem com uWSGI ou Gunicorn — Guia para Iniciantes (Sensei da GeHost)

Olá, querido(a) desenvolvedor(a)! Se você está aqui, provavelmente quer colocar seu site feito com Django no ar — e quer saber como fazer isso com tranquilidade, mesmo sendo iniciante. Aqui na GeHost, você pode sim rodar aplicativos em Python/Django com segurança e facilidade. Vamos juntos, passo a passo, como usar uWSGI ou Gunicorn — dois grandes amigos do Python na web. Não se preocupe: não precisa ser expert!

Dica do Sensei: Django é uma poderosa framework Python para criar sites dinâmicos. Para deixá-lo acessível na internet, precisamos de um "motor" que o conecte ao servidor web (como o Apache). Esse motor é o uWSGI ou Gunicorn. Vamos usar o Gunicorn — mais simples para iniciantes.

Passo 1: Acesse o cPanel da sua conta

Primeiro, faça login no seu painel de controle. É onde tudo acontece.

Insira suas credenciais (usuário e senha da sua hospedagem) e clique em Log in.

Passo 2: Acesse o Gerenciador de Arquivos

Após logar, você verá o painel principal. Vamos localizar o Gerenciador de Arquivos, que é onde vamos organizar seu projeto Django.

Na seção Arquivos, clique em Gerenciador de Arquivos.

Passo 3: Crie a pasta do seu projeto Django

Na pasta public_html (que é a raiz do seu site), crie uma nova pasta com o nome do seu projeto. Por exemplo: meu_site_django.

Na tela do Gerenciador de Arquivos:

• Clique em Novo → Pasta.
• Nomeie a pasta como meu_site_django.
• Clique em Criar Pasta.

Essa será a pasta onde seu código Django ficará.

Passo 4: Envie seu código Django

Seu projeto Django já deve estar pronto localmente. Agora, vamos transferir os arquivos para o servidor.

• Abra o Gerenciador de Arquivos novamente.
• Navegue até a pasta meu_site_django.
• Clique em Enviar (ou Upload) e envie todos os arquivos do seu projeto Django.
• Seu projeto deve ter pastas como manage.py, meu_site_django/ (com settings.py), urls.py, views.py, etc.

Dica do Sensei: Se seu projeto estiver em um repositório Git, você pode usar o Git no cPanel (em Ferramentas) ou usar o File Manager para copiar os arquivos manualmente.

Passo 5: Instale o Gunicorn (via Terminal ou SSH)

Para rodar seu Django com Gunicorn, precisamos instalá-lo no servidor. Isso é feito via Terminal (ou SSH).

Na barra de ferramentas do cPanel, clique em Terminal.

Em seguida, digite os seguintes comandos (um por vez):

1. cd meu_site_django — entra na pasta do seu projeto.
2. pip install gunicorn — instala o Gunicorn.

Pronto! O Gunicorn está agora disponível para rodar seu aplicativo.

Passo 6: Crie um arquivo de configuração para o Gunicorn

Vamos criar um arquivo chamado gunicorn_config.py dentro da pasta do seu projeto.

• No Gerenciador de Arquivos, clique em Novo → Arquivo.
• Nomeie o arquivo como gunicorn_config.py.
• Clique em Criar Arquivo.
• Abra o arquivo e cole o seguinte conteúdo:

bind = "127.0.0.1:8000"
workers = 1
user = "seu_usuario"
group = "seu_usuario"
timeout = 120

Substitua seu_usuario pelo nome da sua conta no cPanel (você pode ver isso no cPanel ou no painel de controle).

Passo 7: Teste o Gunicorn localmente

Vamos testar se o Gunicorn consegue rodar seu Django.

No Terminal do cPanel, execute:

Se tudo estiver certo, você verá mensagens como Starting gunicorn e o servidor começará a rodar.

Dica do Sensei: Se aparecer erro sobre settings.py ou manage.py, verifique se o caminho está correto e se o arquivo my_project/wsgi.py existe.

Passo 8: Acesse seu site no navegador

Se o Gunicorn estiver rodando, seu site estará disponível em:

http://seu_dominio.com/meu_site_django

Substitua seu_dominio.com pelo domínio que você está usando (ex: meusite.com).

Se tudo funcionar, você verá a página inicial do seu Django!

Passo 9: (Opcional) Use um serviço para manter o Gunicorn rodando

O Gunicorn pode parar se o Terminal for fechado. Para manter o site sempre ativo, use o Process Manager no cPanel.

Na seção Processos do cPanel, clique em Gerenciar Processos.

Adicione um novo processo com o seguinte comando:

Salve e ative. Agora seu site será iniciado automaticamente.

Pronto! Seu Django está no ar!

Parabéns, Sensei! Você acaba de colocar seu aplicativo Django no ar com Gunicorn — e tudo isso com apenas alguns cliques e comandos simples.

Leve com você: Se precisar de ajuda, entre em contato com o suporte da GeHost. Estamos aqui para te ajudar, sempre.

Até a próxima, e que seu código seja sempre feliz!