Guarda notebooks en GitHub

Guarda notebooks en GitHub

Los notebooks administrados por el usuario de Vertex AI Workbench están obsoletos. El 30 de enero de 2025, finalizará la compatibilidad con notebooks administrados por el usuario y se quitará la capacidad de crear instancias de notebooks administrados por el usuario. 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 por el usuario a instancias de Vertex AI Workbench.

Para crear una copia de seguridad de tu instancia de notebooks administrados por el usuario y hacer que esté disponible para otros, guarda el contenido de tu instancia de notebooks administrados por el usuario en GitHub.

Crea un repositorio de GitHub

Si aún no tienes un repositorio de GitHub, debes crear uno.

Cuando crees el repositorio de GitHub, asegúrate de que el repositorio de GitHub se pueda clonar; para ello, selecciona la casilla de verificación Inicializar este repositorio con un archivo README (Initialize this repository with a README).

Clona tu repositorio de GitHub en tu instancia de notebooks administrados por el usuario

Para clonar tu repositorio de GitHub en la instancia de notebooks administrados por el usuario, completa los siguientes pasos:

1. En tu repositorio de GitHub, haz clic en el botón Código y luego en la pestaña Local.

2. Copia la URL HTTPS.

3. En la consola de Google Cloud, ve a la página Notebooks administrados por el usuario.

   Ir a Notebooks administrados por el usuario

4. Haz clic en Abrir JupyterLab para abrir tu instancia de notebooks administrados por el usuario.

5. En el navegador de archivos de de JupyterLab, selecciona la carpeta en la que deseas clonar el repositorio de GitHub. Por ejemplo, la carpeta principal.

   

6. En JupyterLab, selecciona Git > Clonar un repositorio.

7. Si se te solicita, ingresa tus credenciales.

   • Si usas un nombre de usuario y una contraseña de GitHub, ingresa tu nombre de usuario y contraseña de GitHub.

   • Si usas la autenticación de dos factores con GitHub, crea y usa un token de acceso personal.

8. En el cuadro de diálogo Clonar a repo, pega la URL HTTPS para tu repositorio de GitHub.

   

9. Haz clic en Clonar.

Configura tu instancia de notebooks administrados por el usuario con información de tu usuario de GitHub

1. En JupyterLab, selecciona Git > Open Git Repository in Terminal para abrir la ventana de terminal de Git.

2. En la ventana de la terminal de Git, ingresa los siguientes comandos para configurar tu nombre de usuario y correo electrónico de Git:

   git config --global user.name "YOUR_NAME"
   git config --global user.email "YOUR_EMAIL"

3. Si tu cuenta de GitHub requiere autenticación SSH, completa los siguientes pasos para conectar tu cuenta:

   1. Desde la terminal de Git en la instancia de notebooks administrados por el usuario, sigue las instrucciones para generar una clave SSH nueva de GitHub.

   2. Sigue las instrucciones para agregar la clave SSH a tu cuenta de GitHub.

4. Cierra la ventana de la terminal de Git.

Agrega los archivos confirmados al repositorio de GitHub

1. La instancia de notebooks administrados por el usuario muestra el repositorio como una carpeta nueva. Si no ves el repositorio de GitHub clonado como una carpeta, haz clic en el botón Actualizar lista de archivos.

   

2. Haz doble clic en tu carpeta del repositorio para abrirla.

3. Agrega un notebook nuevo a tu instancia de notebooks administrados por el usuario.

   Para agregar un archivo de notebook, puedes usar el menú o el Selector.

   Menú

   1. Para agregar un archivo de notebook nuevo desde el menú, selecciona File > New > Notebook.

      

   2. En el cuadro de diálogo Seleccionar kernel, selecciona el kernel para tu notebook nuevo, por ejemplo, Python 3 y haz clic en Seleccionar.

      Se abrirá el archivo de notebook nuevo.

   Launcher

   1. Para agregar un archivo de notebook nuevo desde el Selector, selecciona Archivo > Nuevo > Selector (Launcher).

   2. Haz clic en el mosaico del kernel que deseas usar.

      

      Se abrirá el archivo de notebook nuevo.

4. Cambia el nombre de tu nuevo archivo de notebook.

   Menú

   1. Selecciona Archivo > Cambiar nombre de notebook. Se abrirá el cuadro de diálogo Cambiar nombre de archivo.

   2. En el campo Nombre nuevo, cambia Untitled.ipynb por uno significativo, como install.ipynb.

   3. Haga clic en Cambiar nombre.

   Launcher

   1. Haz clic con el botón derecho en la pestaña Untitled.ipynb y, luego, en Cambiar nombre de notebook. Se abrirá el cuadro de diálogo Cambiar nombre de archivo.

   2. En el campo Nombre nuevo, cambia Untitled.ipynb por uno significativo, como install.ipynb.

   3. Haga clic en Cambiar nombre.

5. Selecciona la pestaña Git. El notebook nuevo se enumera en la agrupación Untracked (Sin seguimiento).

6. Para agregar el notebook nuevo como un archivo para tu repositorio de GitHub, haz clic con el botón derecho en el notebook nuevo y selecciona Realizar seguimiento. En la pestaña Git, tu notebook se agrega a la agrupación En etapas.

7. Para confirmar el notebook nuevo en el repositorio de GitHub, en la pestaña Git, agrega un comentario de confirmación y haz clic en Confirmar.

8. Para abrir la ventana de la terminal de Git, selecciona Git > Open Git repositorio en la terminal.

9. En la ventana de terminal de Git, ingresa el comando git push.

   • Si usas un nombre de usuario y una contraseña de GitHub, cuando se te solicite, escribe tu nombre de usuario y contraseña de GitHub.

   • Si usas la autenticación de dos factores con GitHub, crea un token de acceso personal para usarlo.

   Cuando se completa el comando git push, los archivos confirmados se encuentran en el repositorio de GitHub.