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. Instala Google Cloud CLI.

  2. Configura gcloud CLI para usar tu identidad federada.

    Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.

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

    gcloud init

  4. Crea o selecciona un Cloud de Confiance 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 Cloud de Confiance :

      gcloud projects create PROJECT_ID

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

    • Selecciona el proyecto Cloud de Confiance que creaste:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el nombre de tu Cloud de Confiance proyecto.

  5. 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.

  6. Verifica que la facturación esté habilitada para tu proyecto de Cloud de Confiance .

  7. 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

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 Cloud de Confiance 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 Cloud de Confiance por los recursos que usaste en esta página, borra el proyecto de Cloud de Confiance que tiene los recursos.

Para evitar que se apliquen cargos a tu cuenta de Cloud de Confiance by S3NS 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?