Base de Conhecimento

13.04 Como configurar virtual environment Python

O virtual environment do Python serve para criar um ambiente isolado para a sua aplicação, com bibliotecas próprias, evitando conflito com outros projetos do mesmo servidor.

Na prática, isso permite instalar pacotes específicos para um aplicativo sem misturar dependências com outras aplicações da conta.

Como acessar o cPanel

Entre no cPanel por:

https://seudominio.com.br/cpanel
https://seudominio.com.br:2083
área do cliente MyWay

Depois acesse Software > Setup Python App.

Como configurar virtual environment Python

O que é o virtual environment

O virtual environment, também chamado de ambiente virtual, é um espaço isolado com seu próprio interpretador e suas próprias bibliotecas.

Tradução útil:

virtual environment = ambiente virtual

Quando uma aplicação Python é criada corretamente, o ambiente virtual ajuda a manter o projeto organizado e previsível.

Por que ele é importante

evita conflito entre versões de bibliotecas
permite instalar somente o que o projeto precisa
facilita manutenção
reduz risco de quebrar outras aplicações

Sem isolamento, um pacote instalado para um projeto pode impactar outro app hospedado na mesma conta.

Passo 1 – Criar ou revisar a aplicação

Normalmente o ambiente virtual está ligado à própria aplicação criada no Setup Python App.

Por isso, o primeiro passo é criar a aplicação com os campos corretos:

versão do Python
application root
application URL
startup file
entry point

A base do ambiente virtual nasce da configuração da aplicação e do diretório escolhido.

Passo 2 – Entender onde ele atua

Depois que a aplicação existe, o ambiente virtual passa a ser o local onde as dependências daquele app devem ser instaladas.

Na prática, isso significa que:

as bibliotecas da aplicação ficam vinculadas àquele ambiente
o app pode usar versões específicas de pacotes
o projeto fica menos dependente do Python global do sistema

Isso é especialmente importante em servidores com várias aplicações Python.

Passo 3 – Associar a versão certa do Python

O ambiente virtual deve estar coerente com a versão do Python escolhida para a aplicação.

Se você alterar a versão depois, pode ser necessário revisar o ambiente e reinstalar dependências.

Mudar a versão do interpretador sem revisar o ambiente virtual é uma das causas mais comuns de erro em aplicações Python hospedadas.

Passo 4 – Instalar as dependências dentro da aplicação

Depois que a aplicação estiver criada, use os mecanismos disponíveis para instalar os pacotes do projeto.

No uso prático, isso normalmente é feito com:

arquivo requirements.txt
botão de instalação de dependências
ambiente da aplicação já associado ao projeto

Quando isso é feito corretamente, a aplicação passa a usar suas próprias dependências isoladas.

Como saber se está bem configurado

Você tende a ter um ambiente virtual corretamente configurado quando:

a aplicação inicia sem erro de importação
as bibliotecas necessárias foram instaladas
o projeto responde pela URL publicada
o comportamento é consistente após reiniciar

Em outras palavras, o ambiente virtual “bem configurado” é aquele em que a aplicação encontra tudo o que precisa para funcionar.

Erros comuns

instalar bibliotecas na versão errada do Python
trocar a versão da aplicação e não reinstalar dependências
usar startup file incorreto
entry point incompatível com o código
subir o projeto sem o arquivo de requisitos correto

Mesmo com o ambiente criado, a aplicação não funcionará se os arquivos do projeto ou as dependências não estiverem corretos.

Resultado esperado

Ao final, sua aplicação Python terá um ambiente isolado, coerente com a versão escolhida e pronto para receber ou usar as bibliotecas do projeto.

Resumo rápido:

1. Acesse Setup Python App
2. Crie a aplicação com a versão correta do Python
3. Use o diretório raiz da aplicação como base do projeto
4. Instale as dependências do app
5. Valide startup file e entry point
6. Teste o funcionamento

Na prática, o virtual environment é o isolamento que mantém o app organizado e funcional.

Se houver mudança de versão do Python ou do conjunto de bibliotecas, revise a aplicação e valide novamente o ambiente antes de colocar em produção.

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

0 Usuários acharam útil