Como configurar um ambiente de desenvolvimento do Python

Neste tutorial, mostramos como preparar sua máquina local para desenvolvimento em Python, incluindo o desenvolvimento de apps em Python executados no Google Cloud.

Se você já tiver um ambiente de desenvolvimento configurado, consulte Python e Google Cloud para uma visão geral de como executar aplicativos Python no Google Cloud.

Dica: para começar rapidamente, o editor do Cloud Shell oferece suporte a ambientes de desenvolvimento integrado para todo o ciclo de desenvolvimento de aplicativos do Google Kubernetes Engine e do Cloud Run. O editor do Cloud Shell é baseado no Code OSS e vem com a Google Cloud CLI e as ferramentas do Cloud Code pré-instaladas.

Objetivos

  • Instale uma versão compatível do Python compatível com Google Cloud.
  • Use venv para isolar dependências.
  • Instalar um editor (opcional).
  • Instale a Google Cloud CLI (opcional).
  • Instale as bibliotecas de cliente do Cloud para Python (opcional).
  • Instalar outras ferramentas úteis.
  • Configure a autenticação (opcional).

Como instalar o Python

As instruções de instalação do Python variam de acordo com o sistema operacional. Siga o guia do sistema operacional que você está executando no ambiente de desenvolvimento, seja macOS, Windows ou Linux.

macOS

O macOS inclui uma versão do Python por padrão e a utiliza para seus próprios propósitos. Para evitar interferência com o macOS, recomendamos criar um ambiente de desenvolvimento separado e instalar uma versão compatível do Python para Google Cloud. Para instalar o Python, use o homebrew.

  1. Para usar o homebrew para instalar pacotes do Python, você precisa de um compilador, que pode ser instalado instalando ferramentas de linha de comando do Xcode (em inglês).

    xcode-select --install

  2. Instale o homebrew seguindo as instruções na página inicial do homebrew (em inglês) e use-o para instalar o Python da seguinte maneira:

    brew install pyenv
pyenv install PYTHON_VERSION

    O número da versão do Python precisa estar no formato x.y. Exemplo:

    pyenv install 3.12

  3. Após a conclusão das instalações, verifique se o Python 3 está disponível como python e python3 e se o pip também está instalado.

    Para verificar se o Python está disponível, execute o seguinte comando:

    python3 --version

    A saída mostrará a versão. Saiba mais sobre o Python homebrew na página Fórmula de Python do Homebrew (em inglês) e verifique sua versão.

    Para verificar se o pip3 está disponível, execute o seguinte comando:

    pip3 --version

    Se estiver instalado, a saída vai mostrar a versão do pip3. Para mais informações sobre a versão mais recente do pip3, consulte as notas da versão do pip.

    Se o comando anterior não mostrar a versão do pip3, verifique se o pip3 está instalado corretamente. Se pip3 estiver instalado, mas não estiver funcionando, faça upgrade para a versão mais recente usando o comando a seguir:

    python -m pip install --upgrade pip

    O Homebrew instala as versões mais recentes do Python disponíveis na sua plataforma. Os números de versão nas saídas podem ser diferentes das versões oficiais mais recentes do Python.

Windows

  1. Para instalar o Python em um ambiente Windows, faça o download do instalador da versão do Python que você precisa no site do Python (em inglês). Para mais informações, consulte as versões compatíveis do Python para Google Cloud.

  2. Para acessar a versão do Python, use o Python launcher para Windows (em inglês).

    Para iniciar a versão do Python instalada, execute o seguinte comando:

    py

    Para iniciar a versão do Python 3 instalada, execute o seguinte comando:

    py -3

    Para verificar a versão do pip disponível, execute o seguinte comando:

    py -m pip --version

    A saída mostra a versão de C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Saiba mais sobre a versão mais recente do pip nas Notas de lançamento do pip.

Linux

Há versões recentes do Python na maioria das distribuições Linux.

  1. Para instalar o Python em um ambiente Linux, instale os pacotes apropriados para sua distribuição. Para Debian e Ubuntu, esses pacotes são python3, python3-dev, python3-venv e python3-pip.

    Instale esses pacotes usando os seguintes comandos:

    sudo apt update
sudo apt install python3 python3-dev python3-venv python3-pip

  2. Após a conclusão das instalações, verifique se o pip está instalado:

    pip3 --version

    Saiba mais sobre a versão mais recente do pip nas notas da versão do pip.

Como usar o venv para isolar dependências

venv é uma ferramenta que cria ambientes Python isolados. Esses ambientes isolados podem ter versões separadas de pacotes Python, o que permite isolar as dependências de um projeto das dependências de outros projetos. Recomendamos que você sempre use um ambiente virtual por projeto ao desenvolver localmente com o Python.

  1. Use o comando venv para criar uma cópia virtual de toda a instalação do Python. Neste tutorial, criamos uma cópia virtual em uma pasta chamada env, mas é possível especificar qualquer nome para a pasta.

    macOS

    cd your-project
python -m venv env

    Windows

    cd your-project
py -m venv env

    Linux

    cd your-project
python3 -m venv env

  2. Configure o shell para usar os caminhos venv para Python ativando o ambiente virtual:

    macOS

    source env/bin/activate

    Windows

    .\env\Scripts\activate

    Linux

    source env/bin/activate

  3. Agora é possível instalar pacotes sem afetar outros projetos ou a instalação global do Python:

    pip install google-cloud-storage

    Se quiser parar de usar o ambiente virtual e voltar ao Python global, desative-o:

    deactivate

Leia mais sobre venv na documentação venv.

Como instalar um editor

Para desenvolver aplicativos em Python, é necessário um editor. Aqui estão alguns dos editores mais usados (em nenhuma ordem particular):

Como instalar as bibliotecas de cliente do Cloud para Python

As bibliotecas de cliente do Cloud para Python são a integração dos desenvolvedores do Python com os serviços do Google Cloud como o Datastore e o Cloud Storage. Para instalar o pacote para uma API individual, como o Cloud Storage, use um comando semelhante ao seguinte:

pip install --upgrade google-cloud-storage

Como instalar a CLI gcloud

A gcloud CLI é um conjunto de ferramentas de linha de comando para Google Cloud. Ele contém gcloud e bq, que você pode usar para acessar o Compute Engine, o Cloud Storage, o BigQuery e outros produtos e serviços na linha de comando. É possível executar essas ferramentas de maneira interativa ou nos scripts automatizados.

Configurar a autenticação

Para usar a biblioteca de cliente, primeiro você precisa configurar a autenticação.

If you're using a local shell, then create local authentication credentials for your user account: 

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Para mais informações, consulte Autenticar para usar bibliotecas de cliente.

A seguir