<\/span><\/h2>\nO pr\u00f3ximo passo \u00e9 instalar o Django nesta aplica\u00e7\u00e3o Python. Caso voc\u00ea seja um usu\u00e1rio avan\u00e7ado e queira usar um cliente de SSH de sua prefer\u00eancia, basta acessar o servidor por SSH e utilizar o comando que est\u00e1 em \u201cEnter to the virtual environment.To enter to virtual environment, run the command:<\/b>\u201d no SSH para entrar no virtualenv e poder instalar tanto o Django quanto os m\u00f3dulos que desejar.<\/p>\n
\u00c9 poss\u00edvel tamb\u00e9m manipular sua conta via SSH pelo pr\u00f3prio painel de controle, utilizando a ferramenta Terminal e ser\u00e1 dessa forma que iremos mostrar nesse exemplo. O primeiro passo \u00e9 copiar o comando para entrar no virtualenv:<\/p>\n
Agora que o comando foi copiado, vamos abrir o terminal :<\/p>\n
\n\n\n
Ao abrir o terminal, ser\u00e1 exibido a tela lhe permitindo inserir comandos e basta colar o comando que foi copiado da tela de projetos conforme o print abaixo:<\/p>\n\n\n\nQuando teclar enter no final da linha desse comando, j\u00e1 estar\u00e1 no virtualenv e ir\u00e1 reparar que o nome do projeto e a vers\u00e3o do python estar\u00e3o logo no inicio da linha:<\/p>\n\n\n\nNo print acima, temos tamb\u00e9m um exemplo de uso do comando “pwd” que exibe na tela o diret\u00f3rio que est\u00e1 visualizando no momento. Pode perceber que j\u00e1 est\u00e1 no diret\u00f3rio do seu projeto. O comando “ls” exibido acima mostra o conte\u00fado gerado automaticamente pelo cPanel. <\/p>\n\n\n\n
O pr\u00f3ximo passo \u00e9 a instala\u00e7\u00e3o do django usando o comando “pip install django”:<\/p>\n\n\n\n<\/p>\n\n\n\n
<\/span>Criar um projeto<\/span><\/h2>\n\n\n\nAgora que temos uma aplica\u00e7\u00e3o Python instalada com o Django, precisamos criar um projeto. Para isso, vamos usar o comando “django-admin startproject meuapp .” Segue print de exemplo:<\/p>\n\n\n\n
Observa\u00e7\u00e3o importante: No final do comando “django-admin startproject meuapp .” h\u00e1 um ponto no final, que significa que o projeto ser\u00e1 instalado no diret\u00f3rio atual. Sem o ponto, ser\u00e1 criado um subdiret\u00f3rio extra que pode gerar confus\u00e3o.<\/p>\n\n\n\nVamos ver agora os novos arquivos e diret\u00f3rios criados pelo comando:<\/p>\n\n\n\nPodemos ver todos os arquivos e diret\u00f3rios criados pelo django-admin. O pr\u00f3ximo passo agora \u00e9 atualizar o arquivo de inicializa\u00e7\u00e3o da aplica\u00e7\u00e3o para o wsgi.py do django. Para isso, devemos voltar na tela de projetos do cpanel e editar o nosso projeto:<\/p>\n\n\n\n
A partir desse momento o site django j\u00e1 dever\u00e1 estar online. Para um teste, basta acessar o site em outra aba do navegador:<\/p>\n\n\n\nQuando acessar o site, ir\u00e1 ver a tela do print acima. Essa tela informa que n\u00e3o h\u00e1 um host configurado com permiss\u00e3o para esse aplicativo. Para corrigir essa configura\u00e7\u00e3o, dever\u00e1 acessar o gerenciador de arquivos do cPanel e editar o arquivo settings.py do seu projeto:<\/p>\n\n\n\nAo clicar no bot\u00e3o “Edit” ser\u00e1 exibido o conte\u00fado do arquivo settings.py e dever\u00e1 localizar a linha do ALLOWED_HOSTS e ir\u00e1 reparar que ela est\u00e1 sem conte\u00fado:<\/p>\n\n\n\nBasta inserir o nome de seu site nessa parte com e sem www seguindo o modelo abaixo:<\/p>\n\n\n\n
ALLOWED_HOSTS = ['siteexemplo.h-br.com','www.siteexemplo.h-br.com']<\/pre>\n\n\n\n\n
⚠️ Antes de colocar em produ\u00e7\u00e3o: DEBUG = False<\/div>\n
No mesmo arquivo settings.py<\/code>, localize a linha DEBUG = True<\/code> e troque por False<\/code>. Com o DEBUG ligado, qualquer erro no site exibe ao visitante o caminho completo dos seus arquivos, as vari\u00e1veis de ambiente, a configura\u00e7\u00e3o do banco de dados e parte da SECRET_KEY.<\/p>\n\u00c9 a falha de seguran\u00e7a mais comum em projetos Django publicados. Durante o desenvolvimento o DEBUG ajuda; em produ\u00e7\u00e3o, n\u00e3o.<\/p>\n<\/div>\n\n\n\nAo final da edi\u00e7\u00e3o dever\u00e1 clicar no bot\u00e3o “Salvar altera\u00e7\u00f5es” no canto superior direito.<\/p>\n\n\n\n
Volte no cpanel na tela de seu aplicativo e de restart na aplica\u00e7\u00e3o para que as atualiza\u00e7\u00f5es sejam aplicadas. <\/p>\n\n\n\nAgora basta testar o acesso em seu site. Estando tudo correto, ele dever\u00e1 exibir a tela de demonstra\u00e7\u00e3o do django como o print abaixo:<\/p>\n\n\n\nAgora devemos configurar o caminho dos arquivos est\u00e1ticos de seu projeto. Para isso, volte no gerenciador de arquivos. O diret\u00f3rio publico de sua conta \u00e9 o public_html. Nesse exemplo, iremos criar um diret\u00f3rio dentro dele de nome “static” conforme os print’s abaixo:<\/p>\n\n\n\nAgora devemos configurar o caminho no arquivo de configura\u00e7\u00e3o, para isso, edite novamente o arquivo settings.py:<\/p>\n\n\n\nDever\u00e1 ir at\u00e9 o final do arquivos e inserir a seguinte linha:<\/p>\n\n\n\n
STATIC_ROOT = '\/home\/siteexem\/public_html\/static'<\/pre>\n\n\n\nObserva\u00e7\u00e3o importante: Nesse exemplo estamos usando o caminho de nossa conta de teste. Em seu caso precisar\u00e1 definir o caminho correto de sua conta no servidor. <\/strong><\/p>\n\n\n\nDepois que inserir a linha, clique em salvar altera\u00e7\u00f5es. A pr\u00f3xima etapa \u00e9 rodar o comando para coletar a nova configura\u00e7\u00e3o de caminho dos arquivos est\u00e1ticos. Esse procedimento deve ser feito via terminal:<\/p>\n\n\n\nAgora o pr\u00f3ximo passo \u00e9 testar. Volte no gerenciador de arquivos, entre no diret\u00f3rio public_html\/static e crie um arquivo teste conforme o print abaixo:<\/p>\n\n\n\nDepois que criar o arquivo dentro da pasta static, vamos edita-lo e inserir um conte\u00fado:<\/p>\n\n\n\nDepois que inserir o texto, clique no bot\u00e3o “salvar altera\u00e7\u00f5es” e fa\u00e7a um teste de acesso via navegador. Em nosso exemplo o link ficou da seguinte forma:<\/p>\n\n\n\nE Voila! Seu projeto j\u00e1 est\u00e1 pronto para receber seu conte\u00fado!<\/p>\n\n\n\n
<\/span>Perguntas frequentes<\/span><\/h2>\n\n\n\nPreciso de VPS para hospedar Django?<\/strong><\/p>\n\n\n\nN\u00e3o necessariamente. Uma hospedagem compartilhada com cPanel e Setup Python App \u2014 como a usada neste tutorial \u2014 roda Django perfeitamente para sites institucionais, blogs, pain\u00e9is internos e aplica\u00e7\u00f5es de tr\u00e1fego moderado. O VPS passa a fazer sentido quando voc\u00ea precisa de acesso root, de bibliotecas que exigem compila\u00e7\u00e3o, de Celery com workers em background, ou quando o tr\u00e1fego come\u00e7a a esbarrar nos limites do plano.<\/p>\n\n\n\n
Qual vers\u00e3o do Python e do Django devo escolher?<\/strong><\/p>\n\n\n\nUse a vers\u00e3o mais recente do Python dispon\u00edvel no painel e uma vers\u00e3o LTS<\/strong> do Django. As LTS recebem corre\u00e7\u00f5es de seguran\u00e7a por tr\u00eas anos, o que evita ter que migrar o projeto no meio do caminho. Vers\u00f5es intermedi\u00e1rias trazem recursos novos mas t\u00eam ciclo de suporte curto.<\/p>\n\n\n\nPor que meu site Django mostra “DisallowedHost”?<\/strong><\/p>\n\n\n\nPorque o dom\u00ednio que voc\u00ea acessou n\u00e3o est\u00e1 na lista ALLOWED_HOSTS<\/code> do settings.py<\/code>. \u00c9 uma prote\u00e7\u00e3o do pr\u00f3prio Django contra ataques de cabe\u00e7alho Host. Acrescente seu dom\u00ednio com e sem www<\/code>, salve, e reinicie a aplica\u00e7\u00e3o no painel \u2014 o rein\u00edcio \u00e9 a parte que muita gente esquece.<\/p>\n\n\n\nPreciso reiniciar a aplica\u00e7\u00e3o depois de cada altera\u00e7\u00e3o?<\/strong><\/p>\n\n\n\nSim, para mudan\u00e7as em arquivos Python \u2014 settings.py<\/code>, views.py<\/code>, models.py<\/code>. O Passenger mant\u00e9m o processo em mem\u00f3ria, ent\u00e3o a altera\u00e7\u00e3o s\u00f3 passa a valer depois do restart, feito pelo bot\u00e3o na tela da aplica\u00e7\u00e3o no cPanel. Altera\u00e7\u00f5es em templates HTML e arquivos est\u00e1ticos n\u00e3o precisam.<\/p>\n\n\n\nMeus arquivos CSS e JavaScript n\u00e3o carregam. O que fazer?<\/strong><\/p>\n\n\n\nProvavelmente falta rodar o collectstatic<\/code>. O Django n\u00e3o serve arquivos est\u00e1ticos em produ\u00e7\u00e3o \u2014 ele espera que estejam reunidos numa pasta p\u00fablica, definida no STATIC_ROOT<\/code>. Depois de configurar o caminho, rode python manage.py collectstatic<\/code> pelo terminal e reinicie a aplica\u00e7\u00e3o.<\/p>\n\n\n\nO que \u00e9 o ponto no final do comando django-admin startproject meuapp .<\/code>?<\/strong><\/p>\n\n\n\nEle indica que o projeto deve ser criado no diret\u00f3rio atual. Sem o ponto, o Django cria uma pasta extra com o mesmo nome, resultando em meuapp\/meuapp\/<\/code> \u2014 o que funciona, mas confunde os caminhos e \u00e9 a causa mais comum de erro no Application startup file<\/code>.<\/p>\n\n\n\nPreciso mudar o DEBUG para False?<\/strong><\/p>\n\n\n\nSim, antes de o site ficar p\u00fablico. Com DEBUG = True<\/code>, qualquer erro exibe ao visitante o caminho completo dos seus arquivos, as vari\u00e1veis de ambiente, a configura\u00e7\u00e3o do banco e parte da SECRET_KEY. \u00c9 a falha de seguran\u00e7a mais comum em projetos Django publicados.<\/p>\n\n\n\nPosso usar banco de dados MySQL em vez do SQLite?<\/strong><\/p>\n\n\n\nSim, e para produ\u00e7\u00e3o \u00e9 o recomendado. O SQLite vem configurado por padr\u00e3o e funciona para testes, mas grava num arquivo \u00fanico e n\u00e3o lida bem com escritas simult\u00e2neas. Crie um banco MySQL no cPanel, instale o mysqlclient<\/code> no virtualenv, e aponte o DATABASES<\/code> do settings.py<\/code> para ele.<\/p>\n\n\n\nComo instalo bibliotecas adicionais no projeto?<\/strong><\/p>\n\n\n\nPelo terminal, dentro do virtualenv. Entre no ambiente com o comando que o painel fornece e use pip install nome-da-biblioteca<\/code>. Instalar fora do virtualenv n\u00e3o funciona \u2014 a aplica\u00e7\u00e3o n\u00e3o v\u00ea o pacote. Vale tamb\u00e9m manter um requirements.txt<\/code> no projeto, com pip freeze > requirements.txt<\/code>.<\/p>\n\n\n\nOnde vejo os erros da minha aplica\u00e7\u00e3o?<\/strong><\/p>\n\n\n\nNo arquivo de log do Passenger, cujo caminho voc\u00ea definiu ao criar a aplica\u00e7\u00e3o \u2014 no exemplo deste tutorial, o diret\u00f3rio logs<\/code>. \u00c9 o primeiro lugar a olhar quando o site retorna erro 500 e nenhuma mensagem aparece na tela, o que \u00e9 justamente o comportamento esperado com DEBUG = False<\/code>.<\/p>\n\n\n\nPosso rodar mais de uma aplica\u00e7\u00e3o Python na mesma conta?<\/strong><\/p>\n\n\n\nSim. Cada aplica\u00e7\u00e3o criada no Setup Python App tem seu pr\u00f3prio virtualenv e sua pr\u00f3pria vers\u00e3o do Python, e pode responder num dom\u00ednio ou subdom\u00ednio diferente. O limite pr\u00e1tico \u00e9 o de recursos do plano, n\u00e3o do painel.<\/p>\n\n\n\n