Crea una instancia de TPU

En este documento, se muestra cómo crear una instancia de máquina virtual (VM) de TPU, conectarte a ella y ejecutar un cálculo en ella. La instancia de TPU que creas en esta guía de inicio rápido usa la opción de consumo predeterminada, que es a pedido.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. Instala Google Cloud CLI.

  3. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  4. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init

  5. Crea o selecciona un Google Cloud proyecto.

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

    • Crea un proyecto de Google Cloud :

      gcloud projects create PROJECT_ID

      Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

    • Selecciona el proyecto Google Cloud que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

  6. Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

  7. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

  8. Habilita la API de Compute Engine con este comando:

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles. 

    gcloud services enable compute.googleapis.com

  9. Instala Google Cloud CLI.

  10. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  11. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init

  12. Crea o selecciona un Google Cloud proyecto.

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

    • Crea un proyecto de Google Cloud :

      gcloud projects create PROJECT_ID

      Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

    • Selecciona el proyecto Google Cloud que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

  13. Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

  14. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

  15. Habilita la API de Compute Engine con este comando:

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles. 

    gcloud services enable compute.googleapis.com
    16.

Roles obligatorios

Si deseas obtener los permisos que necesitas para crear una instancia de TPU, conectarte a ella con SSH y ejecutar comandos, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea una instancia de TPU

Ejecuta los siguientes comandos en tu terminal local o con Cloud Shell.

  1. Para crear una instancia de TPU, ejecuta el siguiente comando gcloud compute instances create:

    gcloud compute instances create quickstart-tpu \
    --machine-type=ct6e-standard-4t \
    --zone=us-east5-b \
    --image-project=ubuntu-os-accelerator-images \
    --image-family=ubuntu-accelerator-2204-amd64-with-tpu-v6e

  2. De manera opcional, verifica que la instancia esté en ejecución con el comando gcloud compute instances describe:

    gcloud compute instances describe quickstart-tpu --zone=us-east5-b

    En el resultado, verifica el campo status para comprobar si la instancia se está ejecutando o si aún está pendiente.

Conéctate a la instancia de TPU

Puedes conectarte a una instancia de TPU con la consola de Google Cloud o gcloud CLI.

Para conectarte a la VM con SSH, ejecuta el siguiente comando gcloud compute ssh:

gcloud compute ssh quickstart-tpu --project=PROJECT_ID --zone=us-east5-b

Instala JAX

Ejecuta el siguiente comando en tu instancia de TPU para instalar el framework de JAX:

pip install jax[tpu] -f https://storage.googleapis.com/jax-releases/libtpu_releases.html

Cómo ejecutar una verificación del sistema

Verifica que JAX pueda acceder a la TPU y ejecutar operaciones básicas con los siguientes comandos en tu instancia de TPU:

  1. Inicia el intérprete de Python 3:

    python3

  2. Importa el módulo JAX:

    >>> import jax

  3. Muestra la cantidad de núcleos de TPU disponibles:

    >>> jax.device_count()

    El resultado muestra la cantidad de núcleos de TPU. La cantidad de núcleos depende de la versión de TPU que usas. Para obtener más información, consulta Versiones de TPU.

Cómo hacer un cálculo

  1. Ejecuta el siguiente comando para sumar dos números:

    >>> jax.numpy.add(1, 1)

    El resultado debería ser similar al siguiente ejemplo:

    >>> Array(2, dtype=int32, weak_type=True)

  2. Sal del intérprete de Python:

    >>> exit()

Realiza una limpieza

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, borra el proyecto de Google Cloud que tiene los recursos.

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, borra la instancia de TPU con el comando gcloud compute instances delete:

gcloud compute instances delete quickstart-tpu --zone=us-east5-b

¿Qué sigue?