Crea una instancia de notebooks administrados

Crea una instancia de notebooks administrados

Los notebooks administrados de Vertex AI Workbench están obsoletos. El 30 de enero de 2025, finalizará la compatibilidad con notebooks administrados y se quitará la capacidad de crear instancias de notebooks administrados. Las instancias existentes seguirán funcionando, pero los parches y las actualizaciones no estarán disponibles. Para seguir usando Vertex AI Workbench, te recomendamos migrar tus instancias de notebooks administrados a instancias de Vertex AI Workbench.

En esta página, se muestra cómo crear una instancia de notebook administrados con la consola de Google Cloud o Google Cloud CLI. Mientras creas la instancia, puedes configurar el hardware, el tipo de encriptación, la red y otros detalles de la instancia.

Antes de comenzar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Notebooks API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Notebooks API.

   Enable the API

Crea una instancia con propiedades predeterminadas

Puedes crear una instancia de notebooks administrados mediante la consola de Google Cloud o gcloud CLI:

Console

1. En la consola de Google Cloud, ve a la página Notebooks administrados.

   Ir a Notebooks administrados

2. Haz clic en  Notebook nuevo.

3. En el campo Nombre del notebook, ingresa un nombre para tu instancia. El nombre debe comenzar con una letra seguida de un máximo de 62 letras minúsculas, números o guiones (-), y no puede terminar en un guion.

4. Haz clic en la lista Región y elige una región para tu instancia.

5. Elige una opción de permiso para definir qué usuarios pueden acceder a la instancia de notebooks administrados:

   • Cuenta de servicio: Esta opción otorga acceso a todos los usuarios que tienen acceso a la cuenta de servicio de Compute Engine que vinculas al entorno de ejecución. Para especificar tu propia cuenta de servicio, desmarca la casilla de verificación Usar la cuenta de servicio predeterminada de Compute Engine e ingresa la dirección de correo electrónico de la cuenta de servicio que deseas usar. Para obtener más información sobre las cuentas de servicio, consulta Tipos de cuentas de servicio.

   • Usuario único: Esta opción otorga acceso solo a un usuario específico. En el campo Correo electrónico del usuario, ingresa la dirección de correo electrónico de la cuenta de usuario que usará la instancia de notebooks administrados.

   Nota: Para otorgar acceso a la instancia a través de la cuenta de servicio o una opción de usuario único, debes usar la dirección de correo electrónico de una cuenta de usuario de una persona. No se admite el acceso grupal.

   Para obtener más información sobre cómo otorgar acceso, consulta Administra el acceso.

6. Haz clic en Crear.

   Vertex AI Workbench inicia la instancia de forma automática. Cuando la instancia está lista para usarse, Vertex AI Workbench activa un vínculo Abrir JupyterLab.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• INSTANCE_NAME: El nombre de tu instancia de notebooks administrados. Debe comenzar con una letra seguida de hasta 62 letras minúsculas, números o guiones (-) y no puede terminar con un guion.
• PROJECT_ID: el ID de tu proyecto
• LOCATION: La zona en la que deseas que se ubique la instancia.
• ACCESS_MODE: El modo de acceso que deseas usar, por ejemplo, SINGLE_USER o SERVICE_ACCOUNT
• OWNER_EMAIL_ADDRESS: La dirección de correo electrónico del usuario único o la cuenta de servicio que necesita acceso a la interfaz de JupyterLab de la instancia
• MACHINE_TYPE: el tipo de máquina de la VM de tu instancia

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init, o gcloud auth login y gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Si deseas obtener más información sobre el comando para crear una instancia desde la línea de comandos, consulta la documentación de gcloud CLI.

Vertex AI Workbench inicia la instancia automáticamente después de su creación. Cuando la instancia esté lista para usarse, podrás acceder a ella desde la consola de Google Cloud.

Crea una instancia con la configuración avanzada

1. En la consola de Google Cloud, ve a la página Notebooks administrados.

   Ir a Notebooks administrados

2. Haz clic en  Notebook nuevo.

3. En el campo Nombre del notebook, ingresa un nombre para tu instancia. El nombre debe comenzar con una letra seguida de un máximo de 62 letras minúsculas, números o guiones (-), y no puede terminar en un guion.

4. Haz clic en la lista Región y elige una región para tu instancia.

5. Elige una opción de permiso para definir qué usuarios pueden acceder a la instancia de notebooks administrados:

   • Cuenta de servicio: Esta opción otorga acceso a todos los usuarios que tienen acceso a la cuenta de servicio de Compute Engine que vinculas al entorno de ejecución. Para especificar tu propia cuenta de servicio, desmarca la casilla de verificación Usar la cuenta de servicio predeterminada de Compute Engine e ingresa la dirección de correo electrónico de la cuenta de servicio que deseas usar. Para obtener más información sobre las cuentas de servicio, consulta Tipos de cuentas de servicio.

   • Usuario único: Esta opción otorga acceso solo a un usuario específico. En el campo Correo electrónico del usuario, ingresa la dirección de correo electrónico de la cuenta de usuario que usará la instancia de notebooks administrados.

   Nota: Para otorgar acceso a la instancia a través de la cuenta de servicio o una opción de usuario único, debes usar la dirección de correo electrónico de la cuenta de usuario de una persona. No se admite el acceso grupal.

   Para obtener más información sobre cómo otorgar acceso, consulta Administra el acceso.

6. Haz clic en Configuración avanzada y completa el diálogo con las instrucciones de las siguientes secciones.

Usa imágenes personalizadas de Docker

Para ejecutar archivos de notebook en un contenedor de Docker personalizado, agrega la imagen de contenedor de Docker personalizada a la instancia de notebooks administrada.

La imagen de contenedor de Docker personalizada debe estar ubicada en Artifact Registry. Debes tener acceso a la imagen de contenedor.

1. En la sección Entorno, en Imágenes de Docker personalizadas, elige la casilla de verificación Proporcionar imágenes de Docker personalizadas.

2. Escribe una ruta de imagen de contenedor de Docker o haz clic en Elegir para agregar una de Artifact Registry.

3. Para agregar otra imagen de Docker personalizada, haz clic en  Agregar otra imagen de Docker y repite estos pasos.

Configura hardware

Elige una configuración de hardware para tu entorno. Puedes cambiarlo más adelante desde la interfaz de usuario de JupyterLab.

Confirma la disponibilidad de la GPU

La disponibilidad del acelerador de GPU se basa en la región, el tipo de máquina y la cantidad de GPU que deseas. Se recomienda confirmar la disponibilidad mediante los siguientes recursos:

• Disponibilidad de regiones y zonas de GPU. El tipo de acelerador que desees debe estar disponible en la zona de la instancia.
• GPU NVIDIA® A100. Comprueba la disponibilidad de GPU para tu tipo de máquina.

Configura el hardware

Para configurar tu hardware, completa los siguientes pasos:

1. En la sección Configuración de hardware, elige un Tipo de máquina.

2. Si deseas usar GPU, elige un Tipo de GPU. Si no ves el tipo de GPU que deseas, comprueba la disponibilidad de GPU para el tipo de máquina y la zona.

3. Si eliges usar GPU, elige una Cantidad de GPU y, luego, Instalar el controlador de GPU de NVIDIA de forma automática.

4. Elige un Tipo de disco de datos y un Tamaño de disco de datos en GB.

5. Para usar el comportamiento de papelera predeterminado del sistema operativo, elige la casilla de verificación Borrar a la papelera. Si usas el comportamiento predeterminado de la papelera, los archivos borrados con la interfaz de usuario de JupyterLab se pueden recuperar, pero estos archivos borrados usan espacio en disco.

Elige el tipo de encriptación

Elige la clave de encriptación predeterminada administrada por Google o una clave de encriptación administrada por el cliente (CMEK). Para obtener más información sobre las CMEK con notebooks administrados, consulta Usa claves de encriptación administradas por el cliente.

1. En la sección Encriptación de disco, elige la clave de encriptación administrada por Google predeterminada o elige Clave de encriptación administrada por el cliente (CMEK).

2. Si eliges Clave de encriptación administrada por el cliente (CMEK), haz clic en la lista y elige tu clave administrada por el cliente.

   • Si la clave que deseas usar no está en la lista, ingresa el ID de recurso de tu clave de encriptación.

   • Para crear una clave de encriptación administrada por el cliente, consulta Crea claves de encriptación simétricas.

Habilitar el cierre inactivo

El cierre inactivo está habilitado de forma predeterminada para cerrar tu instancia después de 180 minutos de inactividad. Puedes cambiar la cantidad de minutos de inactividad antes de la desactivación o puedes inhabilitar el cierre inactivo. Para obtener más información, consulta Cierre inactivo.

• Para cambiar la cantidad de minutos antes del cierre, en la sección Cierre inactivo, en el campo Tiempo de inactividad antes del cierre (minutos), cambia el valor a un número entero entre 10 y 1440.

• Para inhabilitar el cierre inactivo, en la sección Cierre inactivo, desmarca la opción Habilitar cierre inactivo.

Configurar la red

De forma predeterminada, la instancia de notebooks administrados usa una red de VPC administrada por Google, que no requiere configuración. Si quieres, puedes especificar una red ubicada dentro de tu proyecto o una red que se te haya compartido. Si especificas una red, esta requiere una conexión de acceso privado a servicios. La red también debe tener acceso a Internet o debes habilitar el Acceso privado a Google para la red.

1. En la sección Herramientas de redes, elige Redes del proyecto o Redes compartidas conmigo.

2. En el campo Red, elige la red que deseas usar.

3. En el campo Subred, elige la subred que deseas usar.

4. Para habilitar una dirección IP externa, elige la casilla de verificación Habilitar dirección IP externa. Si la red especificada no tiene acceso a Internet o si no habilitas la dirección IP externa, debes habilitar el Acceso privado a Google para la red para usar esta instancia.

5. Si aún no configuraste una conexión de acceso privado a servicios para esta red, haz clic en Configurar conexión y completa lo siguiente:

   1. En el cuadro de diálogo Crear una conexión de acceso a servicios privados, habilita la API de Service Networking y, luego, haz clic en Habilitar API. Si la API de Service Networking ya está habilitada, haz clic en Continuar.

   2. En la sección Asigna un rango de IP, completa el cuadro de diálogo para elegir uno o más rangos de IP existentes, crea un rango de IP nuevo o usa un rango de IP asignado de forma automática.

   3. Cuando finalices, haz clic en Continuar.

   4. En la sección Crear una conexión, revisa la red y el rango de IP asignado que seleccionaste y, luego, haz clic en Crear conexión.

Configurar las opciones de seguridad

Habilita o inhabilita las siguientes opciones:

• nbconvert: nbconvert permite a los usuarios exportar y descargar un archivo de notebook como un tipo de archivo diferente, como HTML, PDF o LaTeX.
• Descarga de archivos desde la IU del notebook: Esta configuración permite que los usuarios descarguen archivos desde la interfaz de usuario de JupyterLab.
• Terminal: Esto habilita el acceso de terminal a tu instancia de notebooks administrados desde la interfaz de usuario de JupyterLab.

Termina de crear la instancia

1. Haz clic en Crear.

   Vertex AI Workbench inicia la instancia de forma automática. Cuando la instancia está lista para usarse, Vertex AI Workbench activa un vínculo Abrir JupyterLab.

Crea una instancia mediante Terraform

Puedes crear una instancia de notebooks administrados mediante el recurso google_notebooks_runtime de Terraform. Usa la siguiente muestra para crear una instancia de notebooks administrada nueva llamada notebooks-runtime-basic.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

resource "google_notebooks_runtime" "basic_runtime" {
  name     = "notebooks-runtime-basic"
  location = "us-central1"

  access_config {
    access_type   = "SINGLE_USER"
    runtime_owner = "[e-mail]"
  }

  virtual_machine {
    virtual_machine_config {
      machine_type = "n1-standard-4"
      data_disk {
        initialize_params {
          disk_size_gb = "100"
          disk_type    = "PD_STANDARD"
        }
      }
    }
  }
}

Abre JupyterLab

Después de crear la instancia, Vertex AI Workbench la inicia de forma automática. Cuando la instancia está lista para usarse, Vertex AI Workbench activa un vínculo Abrir JupyterLab.

1. Junto al nombre de la instancia de notebooks administrados, haz clic en Abrir JupyterLab.

2. La primera vez que accedas a la interfaz de usuario de JupyterLab de una instancia de notebooks administrados, debes otorgar permiso a gcloud CLI para acceder a los datos y autenticar la instancia de notebooks administrados.

   1. En el cuadro de diálogo Authenticate your managed notebook, haz clic en el botón para obtener un código de autenticación.

   2. Elige una cuenta y haz clic en Permitir. Copia el código de autenticación.

   3. En el cuadro de diálogo Autenticar tu notebook administrado, pega el código de autenticación y, luego, haz clic en Autenticar.

Tu instancia de notebooks administrados abre JupyterLab.

Abre un archivo de notebook nuevo

1. Elige Archivo > Nuevo > Notebook.

2. En el cuadro de diálogo elegir Kernel, elige Python y haz clic en elegir.

3. Se abrirá el archivo de notebook nuevo.

¿Qué sigue?

• Prueba uno de los instructivos que se incluye en tu nueva instancia de notebooks administrados. En el Navegador de archivos de JupyterLab, abre la carpeta de instructivos y abre uno de los archivos del notebook.