Configura un entorno de desarrollo de Python

En este instructivo, se muestra cómo preparar tu máquina local para el desarrollo con Python, lo que incluye el desarrollo de apps de Python que se ejecutan en Google Cloud.

Si ya tienes un entorno de desarrollo configurado, consulta Python y Google Cloud para obtener una descripción general de cómo ejecutar apps de Python en Google Cloud.

Sugerencia: Si quieres comenzar con rapidez, el editor de Cloud Shell proporciona compatibilidad con IDE durante todo el ciclo de desarrollo de las aplicaciones de Google Kubernetes Engine y Cloud Run. El editor de Cloud Shell se basa en Code OSS y viene con Google Cloud CLI y las herramientas de Cloud Code preinstaladas.

Objetivos

  • Instala una versión de Python compatible con Google Cloud.
  • Usa venv para aislar las dependencias.
  • Instalar un editor (opcional).
  • Instala Google Cloud CLI (opcional).
  • Instala las bibliotecas cliente de Cloud para Python (opcional).
  • Instala otras herramientas útiles
  • Configura la autenticación (opcional).

Instalar Python

Las instrucciones de instalación de Python varían según el sistema operativo. Sigue la guía para el sistema operativo que ejecutas en tu entorno de desarrollo, macOS, Windows o Linux.

macOS

macOS incluye una versión de Python de forma predeterminada y la usa para sus propios fines. Para evitar interferir con macOS, te recomendamos que crees un entorno de desarrollo independiente y que instales una versión compatible de Python para Google Cloud. Para instalar Python, usa homebrew.

  1. Para usar Homebrew y, así, instalar paquetes de Python, necesitas un compilador, que puedes obtener instalando las herramientas de línea de comandos de Xcode.

    xcode-select --install

  2. Sigue las instrucciones de la página principal de Homebrew para instalarlo y, luego, úsalo para instalar Python de la siguiente manera:

    brew install pyenv
pyenv install PYTHON_VERSION

    El número de versión de Python debe tener el formato x.y. Por ejemplo:

    pyenv install 3.12

  3. Una vez que se completen las instalaciones, verifica que Python 3 esté disponible como python y python3, y que pip también esté instalado.

    Para verificar que Python esté disponible, ejecuta el siguiente comando:

    python3 --version

    En el resultado, se muestra la versión. Puedes obtener información sobre Homebrew para Python en la página Homebrew Python Formulae y, luego, verificar tu versión.

    Para verificar que pip3 esté disponible, ejecuta el siguiente comando:

    pip3 --version

    Si está instalada, el resultado muestra la versión de pip3. Para obtener más información sobre la versión más reciente de pip3, consulta las Notas de la versión de pip.

    Si el comando anterior no muestra la versión de pip3, asegúrate de que pip3 esté instalado correctamente. Si pip3 está instalado, pero no funciona, actualiza a la versión más reciente con el siguiente comando:

    python -m pip install --upgrade pip

    Homebrew instala las versiones más recientes de Python disponibles en tu plataforma. Los números de versión en los resultados pueden ser diferentes de las versiones oficiales más recientes de Python.

Windows

  1. Para instalar Python en un entorno de Windows, descarga el instalador de la versión de Python que necesitas desde el sitio web de Python. Para obtener más información, consulta las versiones compatibles de Python para Google Cloud.

  2. A fin de acceder a tu versión de Python, usa el Selector de Python para Windows.

    Para iniciar la versión de Python que instalaste, ejecuta el siguiente comando:

    py

    Para iniciar la versión de Python 3 que instalaste, ejecuta el siguiente comando:

    py -3

    Para verificar la versión de pip que está disponible, ejecuta el siguiente comando:

    py -m pip --version

    En el resultado, se muestra la versión de C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    Puedes obtener información sobre la versión más reciente de pip en las Notas de la versión de pip.

Linux

La mayoría de las distribuciones de Linux incluyen versiones recientes de Python.

  1. Para instalar Python en un entorno de Linux, instala los paquetes adecuados para tu distribución. Para Debian y Ubuntu, estos paquetes son python3, python3-dev, python3-venv y python3-pip,

    Instala estos paquetes con los siguientes comandos:

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

  2. Una vez que se completen las instalaciones, verifica que tengas instalado pip:

    pip3 --version

    Puedes obtener información sobre la versión más reciente de pip en las notas de la versión de pip.

Usa venv para aislar dependencias

venv es una herramienta que crea entornos aislados de Python. Estos entornos aislados pueden tener versiones separadas de paquetes de Python, lo que te permite aislar las dependencias de un proyecto de las dependencias de otros proyectos. Te recomendamos que siempre uses un entorno virtual por proyecto cuando desarrolles de forma local con Python.

  1. Usa el comando venv para crear una copia virtual de toda la instalación de Python. En este instructivo, se crea una copia virtual en una carpeta llamada env, pero puedes especificar cualquier nombre para la carpeta.

    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. Configura tu shell para que use las rutas de acceso de venv para Python activando el entorno virtual:

    macOS

    source env/bin/activate

    Windows

    .\env\Scripts\activate

    Linux

    source env/bin/activate

  3. Ahora puedes instalar paquetes sin afectar otros proyectos ni tu instalación global de Python:

    pip install google-cloud-storage

    Si quieres dejar de usar virtual environment y volver al Python global, desactívalo:

    deactivate

Puedes obtener más información sobre venv en la documentación de venv.

Instala un editor

Para desarrollar apps de Python, necesitas un editor. Estos son algunos de los editores más populares (sin un orden en particular):

Instala las bibliotecas cliente de Cloud para Python

Las bibliotecas cliente de Cloud para Python son la forma en que los desarrolladores de Python se integran en los servicios de Google Cloud , como Datastore y Cloud Storage. A fin de instalar el paquete para una API individual como Cloud Storage, usa un comando similar al siguiente:

pip install --upgrade google-cloud-storage

Instala la gcloud CLI

La gcloud CLI es un conjunto de herramientas de línea de comandos para Google Cloud. Contiene gcloud y bq, que puedes usar para acceder a Compute Engine, Cloud Storage, BigQuery y otros productos y servicios desde la línea de comandos. Puedes ejecutar estas herramientas de manera interactiva o en tus secuencias de comandos automatizadas.

Configura la autenticación

Para usar la biblioteca cliente, primero debes configurar la autenticación.

Crea credenciales de autenticación locales para tu cuenta de usuario: 

gcloud auth application-default login

Si se devuelve un error de autenticación, confirma que accediste a gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Autentícate para usar las bibliotecas cliente.

Observabilidad (opcional)

Google Cloud Observability incluye servicios de observabilidad que te ayudan a comprender el comportamiento, el estado y el rendimiento de tus aplicaciones de Python. Para obtener más información, consulta Google Cloud Observability para Python.

¿Qué sigue?