Comenzar con la API de la Base de Datos de Git

La API de la Base de datos de Git te da acceso de escritura y lectora para los objetos sin procesar de Git que se encuentran en tu base de datos de Git en GitHub Enterprise Server y para listar y actualizar tus referencias (cabezas de rama y etiquetas).

Resumen

Básicamente, esto te permite volver a implementar muchas de las funcionalidades de Git sobre nuestra API mediante la creación de objetos sin procesar (raw) directamente en la base de datos y actualizando las referencias de rama que técnicamente podrían hacer todo lo que pueda hacer Git sin que se éste se instale.

La API de la Base de Datos de Git devolverá un 409 Conflict si el repositorio de Git está vacío o no disponible. Que un repositorio se muestre como no disponible habitualmente significa que GitHub Enterprise Server está en el proceso de crearlo. Para los casos de repositorios vacíos, puedes utilizar la terminal "Crear o actualizar el contenido de un archivo" para crear contenido e inicializar el repositorio para que puedas utilizar la API de la Base de Datos de Git. Contacta a el administrador de tu sitio si este estado de respuesta persiste.

resumen de la base de datos de git

Para obtener más información sobre la base de datos de objetos de Git, por favor lee el capítulo Internos de Git en el libro Pro de Git.

Como ejemplo, si quieres confirmar un cambio en un archivo de tu repositorio, lo que harías es:

  • Obtener el objeto de la confirmación actual
  • Recuperar el árbol al cual apunta
  • Recuperar el contenido del objeto del blob que tiene el árbol para esa ruta de archivo en particular
  • Cambiar el contenido de alguna manera y publicar un objeto de blob nuevo con este contenido nuevo, obteniendo el SHA del blob a cambio
  • Publicar un nuevo objeto de árbol con ese indicador de la ruta del archivo reemplazándolo con el SHA de tu blob nuevo y obteniendo a cambio el SHA del árbol
  • Crear un objeo de confirmación nuevo con el SHA de la confirmación actual como el padre y el SHA del árbol nuevo, obteniendo a cambio el SHA de la confirmación
  • Actualizar la referencia de tu rama para apuntar al nuevo SHA de la confirmación

Puede que parezca complejo, pero en realidad es bastante simple cuando entiendes el modelo y te proporciona la oportunidad de hacer un sin fin de cosas cuando lo haces potencialmente con la API.

Verificar la capacidad de fusión de las solicitudes de extracción

¡Advertencia! Por favor no dependas de utilizar git directamente o de utilizar GET /repos/{owner}/{repo}/git/refs/{ref} para las actualizaciones a las referencias de Git de tipo merge, ya que este contenido se desactualiza sin aviso previo.

Una API consumible debe solicitar explícitamente que una solicitud de extracción cree una confirmación de fusión de prueba. Una confirmación de fusión de prueba se crea cuando ves la solicitud de extracción en la IU y cuando se muestra el botón de "Fusionar", o cuando obtienes, creas, o editas una solicitud de extracción utilizando la API de REST. Sin esta solicitud, las Referencias de Git para merge se harán obsoletas hasta la próxima vez que alguien vea la solicitud de extracción.

Si actualmente utilizas métodos de sondeo que produzcan referencias de Git de tipo merge descatualizadas, entonces GitHub te recomienda utilizar los siguientes pasos para obtener los últimos cambios de la rama predeterminada:

  1. Recibir el webhook de la solicitud de extracción.
  2. Llamar a GET /repos/{owner}/{repo}/pulls/{pull_number} para iniciar un job en segundo plano para crear el candidato de la confirmación de fusión.
  3. Sondear tu repositorio utilizando GET /repos/{owner}/{repo}/pulls/{pull_number} para ver si el atributo mergeable está como true o como false. Puedes utilizar Git directamente o referencias de Git de tipo GET /repos/{owner}/{repo}/git/refs/{ref} for updates to merge únicamente después de haber llevado a cabo los siguientes pasos.

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.