Docs
...
Publishing notebooks on GitHub

Publicación de cuadernos en GitHub

Última actualización: 21 feb 2025
Publicación de cuadernos en GitHub

Para colaborar con las partes interesadas y otros científicos de datos, puede publicar los cuadernos en los repositorios de GitHub . También puede utilizar GitHub para realizar una copia de seguridad de los cuadernos para la gestión de código fuente.

Visualice este vídeo para ver cómo se habilita la integración de GitHub.

Este vídeo proporciona un método visual para aprender los conceptos y tareas de esta documentación.

  • Transcripción de vídeo
    Hora Transcripción
    00:00 Este vídeo muestra cómo publicar blocs de notas de tu proyecto en tu cuenta de GitHub.
    00:07 Navegue hasta el perfil y los valores.
    00:11 En la pestaña "Integraciones", visite el enlace para generar una señal de acceso personal de GitHub.
    00:17 Proporcione un nombre descriptivo para la señal y seleccione los ámbitos repo y gist y, a continuación, genere la señal.
    00:29 Copie la señal, vuelva a los valores de integración de GitHub y pegue la señal.
    00:36 La señal se valida cuando se guarda en los valores de perfil.
    00:42 Ahora, vaya a sus proyectos.
    00:44 Habilita la integración de GitHub en el nivel de proyecto en la pestaña "Configuración".
    00:50 Simplemente desplácese a la parte inferior y pegue el URL del repositorio de GitHub existente.
    00:56 Lo encontrará en la pestaña "Código" en el repo.
    01:01 Haga clic en "Actualizar" para realizar la conexión.
    01:05 Ahora, vaya a la pestaña "Activos" y abra el cuaderno que desea publicar.
    01:14 Observe que este cuaderno tiene las credenciales sustituidas por X.
    01:19 Es una práctica recomendada para eliminar o sustituir las credenciales antes de publicar en GitHub.
    01:24 Por lo tanto, este cuaderno está listo para su publicación.
    01:27 Puede proporcionar la vía de acceso de destino junto con un mensaje de confirmación.
    01:31 También tiene la opción de publicar contenido sin código oculto, lo que significa que las celdas del cuaderno que empezaban con el comentario de celda oculta no se publicarán.
    01:42 Cuando esté listo, haga clic en "Publicar".
    01:45 El mensaje indica que el cuaderno se ha publicado correctamente y proporciona enlaces al cuaderno, al repositorio y a la confirmación.
    01:54 Echemos un vistazo a la confirmación.
    01:57 Por lo tanto, existe la confirmación, y puede navegar al repositorio para ver el cuaderno publicado.
    02:04 Por último, puede publicar como un gist.
    02:07 Los gists son otra forma de compartir el trabajo en GitHub.
    02:10 Cada gist es un repositorio git, por lo que se puede bifurcar y clonar.
    02:15 Hay dos tipos de gists: el público y el secreto.
    02:19 Si empieza con un gist secreto, puede convertirlo a un gist público más tarde.
    02:24 De nuevo, tiene la opción de eliminar celdas ocultas.
    02:29 Siga el enlace para ver el gist publicado.
    02:32 Así que eso es lo básico de la integración de GitHub.
    02:37 Busque más vídeos en la documentación de Cloud Pak for Data as a Service.

Habilitación del acceso a GitHub desde su cuenta

Antes de poder publicar cuadernos en ' GitHub, ' debes habilitar tu cuenta de ' Cloud Pak for Data as a Service ' para acceder a ' GitHub. Puede habilitar el acceso creando una señal de acceso personal con el ámbito de acceso necesario en GitHub y enlazando la señal a su cuenta de Cloud Pak for Data as a Service .

Siga estos pasos para crear una señal de acceso personal:

  1. Pulse el avatar en la cabecera y, a continuación, pulse Perfil y valores.
  2. Vaya a la pestaña Integraciones y pulse el enlace de señales de acceso personal GitHub en el diálogo y genere una señal nueva.
  3. En la página Nueva señal de acceso personal, seleccione el ámbito de repositorio y pulse para generar una señal.
  4. Copie la señal de acceso generada y péguela en la ventana de diálogo de integración de GitHub en Cloud Pak for Data as a Service.

Enlace de un proyecto a un repositorio GitHub

Después de guardar la señal de acceso, el proyecto debe estar conectado a un repositorio GitHub existente. Sólo puede enlazar con un repositorio GitHub existente desde un proyecto. Se da soporte a los repositorios privados.

Para enlazar un proyecto a un repositorio GitHub existente, debe tener permiso de administrador para el proyecto. Todos los colaboradores del proyecto que tengan permiso de administrador o de editor pueden publicar archivos en este repositorio de GitHub. No obstante, dichos usuarios deben tener permiso para acceder al repositorio. La concesión de permisos de usuario a los repositorios se debe realizar en GitHub.

Para conectar un proyecto a un repositorio de GitHub existente:

  1. Seleccione la pestaña Gestionar y vaya a la página Servicios e integraciones.
  2. Haga clic en la pestaña Integración de terceros.
  3. Haga clic en Integración de conexión.
  4. Especifique la señal de acceso generada de Github.

Ahora puede empezar a publicar cuadernos en GitHub.

Nota:

Para obtener información sobre cómo cambiar la integración de Git , consulte Gestión de las integraciones.

Publicación de un cuaderno en GitHub

Para publicar un cuaderno en GitHub:

  1. Abra el cuaderno en modo de edición: cuando se abra la ventana de vista previa del cuaderno, haga clic en el icono Editar Icono Editar .
  2. Haga clic en el icono de integración de GitHub Icono de carga y seleccione Publicar en GitHub en la barra de acciones del bloc de notas abierto.

Cuando especifica el nombre del archivo que desea publicar en GitHub, puede especificar una vía de acceso de carpeta en el repositorio de GitHub. Tenga en cuenta que los archivos de cuaderno siempre se envían a la rama maestra.

Si obtiene este error: An error occurred while publishing the notebook. Invalid access token permissions or repository does not exist. asegúrese de que:

Tema padre: Gestión del ciclo de vida de cuadernos y scripts