Configura un entorno de desarrollo de Python

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

Si ya tienes configurado un entorno de desarrollo, consulta Python y Google Cloud para obtener una descripción general sobre 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 compatible de Python 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 del 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 interferencias 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 para instalar paquetes de Python, necesitas un compilador, que puedes obtener instalando las herramientas de línea de comandos de Xcode.

   xcode-select --install
   

2. Instala homebrew siguiendo las instrucciones que aparecen en la página principal de homebrew y, luego, usa homebrew 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 también se instale pip.

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

   python3 --version
   

   El resultado muestra la versión. Puedes obtener información sobre Python homebrew 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á instalado, 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. Es posible que los números de versión en los resultados sean 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 disponible, ejecuta el siguiente comando:

   py -m pip --version
   

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

   Puedes obtener más 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. En el caso de 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 más información sobre la versión más reciente de pip en las Notas de versión de pip.

Cómo usar venv para aislar dependencias

venv es una herramienta que crea entornos de Python aislados. 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 usar las rutas de acceso 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.

Nota: Si usas Anaconda, sigue las instrucciones de su sitio web.

Instala un editor

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

• Visual Studio Code de Microsoft
• Sublime Text de Jon Skinner
• PyCharm de JetBrains

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 con 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 CLI de gcloud

La CLI de gcloud 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.

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.

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

¿Qué sigue?

• Obtén más información sobre Python en Google Cloud.

• Implementa un servicio de Python en Cloud Run.

• Obtén información sobre los métodos de autenticación en Google.

• Explora la documentación de los productos de Google Cloud .