Base de Conhecimento

13.02 Como criar aplicação Python no cPanel

A opção criar aplicação Python no cPanel serve para registrar um novo projeto Python dentro da hospedagem, definindo a estrutura básica que o servidor usará para executar o aplicativo.

Na prática, ao criar a aplicação você escolhe a versão do Python, o diretório raiz, a URL, o arquivo de inicialização e o entry point, preparando o ambiente para publicação.

Como acessar o cPanel

Entre no cPanel por um destes endereços:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
pela área do cliente MyWay, usando o atalho do serviço

Depois de entrar no cPanel, vá até Software e clique em Setup Python App.

Como criar aplicação Python no cPanel

Antes de começar

Antes de criar a aplicação, tenha em mãos:

o domínio ou subdomínio onde a aplicação ficará publicada
o caminho do diretório onde os arquivos do projeto ficarão
o nome do arquivo principal da aplicação
o nome do objeto WSGI que será exposto

Se você ainda não sabe o que é startup file ou entry point, pense assim: o primeiro é o arquivo inicial; o segundo é o objeto da aplicação que o servidor deve carregar.

Passo 1 – Entrar na tela de criação

Dentro de Setup Python App, clique em Create Application.

Tradução útil:

Create Application = Criar aplicação

Ao clicar, será aberta a aba ou formulário de criação da nova aplicação.

É nessa tela que você informará todos os dados necessários para registrar o novo app Python.

Passo 2 – Escolher a versão do Python

No campo Python version, escolha a versão desejada.

Essa seleção é obrigatória.

Escolha a versão compatível com o seu projeto. Uma aplicação criada para bibliotecas mais novas pode falhar se você usar uma versão antiga do Python.

Passo 3 – Definir o diretório raiz da aplicação

No campo Application root, informe o diretório físico da aplicação dentro da sua conta.

Exemplos comuns:

meuapp
apps/api
python/projeto

Esse caminho é relativo à sua conta de hospedagem. É nele que ficarão os arquivos principais do projeto e do ambiente virtual.

Passo 4 – Informar a URL da aplicação

No campo Application URL, informe o endereço HTTP ou HTTPS em que a aplicação será acessada.

Exemplos:

https://seudominio.com.br/app
https://api.seudominio.com.br
https://seudominio.com.br/python

Planeje a URL com cuidado. Se você publicar na raiz errada ou em um caminho inadequado, o acesso poderá ficar confuso ou conflitar com outros arquivos do site.

Passo 5 – Definir o arquivo de inicialização

No campo Application startup file, informe o arquivo de inicialização.

Em muitos cenários, o padrão utilizado é passenger_wsgi.py.

Traduções úteis:

Application startup file = Arquivo de inicialização da aplicação
passenger_wsgi.py = arquivo padrão usado com frequência em aplicações Python publicadas via Passenger

Esse arquivo é o ponto de entrada técnico usado pelo servidor para carregar sua aplicação.

Passo 6 – Definir o entry point

No campo Application Entry point, informe o objeto WSGI que será carregado.

O padrão comum é application.

Exemplo prático:

se o seu passenger_wsgi.py termina expondo application, esse é o valor que deve ser informado

Quando startup file e entry point estão corretos, o servidor sabe exatamente qual arquivo abrir e qual objeto executar.

Passo 7 – Adicionar variáveis de ambiente, se necessário

Se o projeto precisar de parâmetros extras, use Add Variable para incluir variáveis de ambiente.

Exemplos:

FLASK_ENV
APP_MODE
API_KEY
DATABASE_URL

Evite erros de digitação em nomes e valores. Uma variável incorreta pode fazer a aplicação iniciar em modo errado ou até não subir.

Passo 8 – Concluir a criação

Depois de revisar todos os dados, conclua a criação da aplicação.

Após isso, ela passará a aparecer na tabela de aplicações do Setup Python App.

Depois de criada, a aplicação poderá ser iniciada, parada, reiniciada, editada e ter dependências instaladas.

Exemplo prático de estrutura

Um cenário típico pode ser:

Python version: 3.x
Application root: meuapp
Application URL: https://seudominio.com.br/meuapp
Startup file: passenger_wsgi.py
Entry point: application

Essa combinação é bastante comum para publicar uma aplicação WSGI organizada de forma tradicional.

Cuidados importantes

não use nomes confusos para os diretórios
evite apontar a aplicação para pasta errada
confira se o arquivo startup realmente existe
confira se o entry point bate com o código do projeto
lembre que criar a aplicação não substitui a instalação das bibliotecas

Se a aplicação for criada com caminho, arquivo ou entry point incorretos, ela pode aparecer cadastrada no painel, mas não funcionar ao ser acessada.

Resultado esperado

Ao final do processo, sua aplicação Python estará registrada no cPanel com seus parâmetros básicos definidos.

Resumo rápido:

1. Acesse Setup Python App
2. Clique em Create Application
3. Escolha a versão do Python
4. Defina o diretório raiz
5. Informe a URL da aplicação
6. Configure o arquivo de inicialização
7. Defina o entry point
8. Adicione variáveis de ambiente, se necessário
9. Conclua a criação

Na prática, isso registra a sua aplicação Python no ambiente de hospedagem.

Depois da criação, o próximo passo normalmente é instalar as dependências com pip, revisar os arquivos e testar o acesso.

Atenciosamente,
MyWay Hosting
Servidores Otimizados por inteligência artificial
www.myway.com.br

0 Usuários acharam útil