Guarda notebooks en GitHub

Puedes guardar el contenido de una instancia de notebook en GitHub a fin de crear una copia de seguridad de tu notebook y ponerlo a disposición de otros para que lo usen.

Para guardar un notebook en GitHub, sigue estos pasos:

  1. Crea un repositorio de GitHub.

    Si aún no tienes un repositorio de GitHub, debes crear uno. Cuando crees tu repositorio de GitHub, inicialízalo con un archivo README para asegurarte de que se pueda clonar el repositorio.

    Inicializa un repositorio de GitHub con un archivo README

  2. Configura tu instancia de notebook con la información de tu usuario de GitHub.

    1. Ve a la página AI Platform Notebooks en Google Cloud Console.

      Ir a la página AI Platform Notebooks

    2. Para abrir tu instancia de notebook, haz clic en Abrir JupyterLab (Open JupyterLab).

    3. Selecciona Git -> Abrir terminal (Git -> Open terminal) para abrir una ventana de la terminal de Git.

    4. 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"
      
    5. Si tu cuenta de GitHub requiere autenticación SSH, debes seguir algunos pasos más para conectar tu cuenta. En la ventana de la terminal de Git de AI Platform Notebooks, sigue las instrucciones para generar una clave SSH nueva de GitHub. Luego, sigue las instrucciones para agregar la clave SSH a tu cuenta de GitHub.

    6. Cierra la ventana de la terminal de Git.

  1. Clona tu repositorio de GitHub en tu instancia de notebook.

    1. Copia la URL de tu repositorio de GitHub. Puedes obtener esta información desde la opción Clone or download (Clonar o descargar) en el repositorio de GitHub.

      Obtén la URL del repositorio de GitHub

    2. En la instancia de notebook, selecciona la carpeta en la que deseas clonar el repositorio de GitHub. Por ejemplo, selecciona la carpeta principal, como se muestra a continuación:

      Carpeta principal del notebook

    3. Haz clic en el botón Clonación de Git (Git clone).

      Botón para clonar el repositorio

    4. Cuando se te solicite, pega la URL del repositorio de GitHub que copiaste antes. Luego haz clic en Clone (Clonar).

      Pega la URL del repositorio y clona el repositorio

  2. En la instancia del notebook, se 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.

    Botón Actualizar lista de archivos

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

  4. Agrega un notebook nuevo a tu instancia de notebook.

    Selecciona Archivo -> Nuevo -> Notebook (File -> New -> Notebook). Esto crea un notebook nuevo llamado "Untitled.ipynb". Selecciona el kernel para tu notebook nuevo. Por ejemplo, "Python 3". También puedes crear un notebook de Python 3 con el Selector.

    Agrega un archivo de notebook

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

    Notebook sin seguimiento

    Haz clic con el botón derecho en el notebook nuevo y selecciona Realizar seguimiento a fin de agregar el notebook nuevo como un archivo para el repositorio de GitHub. El notebook se agrega a la agrupación Staged (En etapas) en la pestaña Git.

    Notebook en etapas

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

  7. Selecciona Git -> Abrir terminal para abrir la ventana de la terminal de Git.

    Ingresa el comando git push en la ventana de la terminal de Git. Cuando se te solicite, ingresa tu nombre de usuario y contraseña de GitHub.

    Cuando se completa el comando git push, los archivos confirmados se agregan al repositorio de GitHub.