Reemplazar los GitHub Services

Hemos obsoletizado los GitHub Services para favorecer la integración con los webhooks. Esta guía te ayuda a hacer la transición hacia los webhooks de GitHub Services. Para obtener más información sobre este anuncio, consulte esta entrada de blog.

Línea del tiempo de la obsoletización

• 1 de octubre de 2018: GitHub dejó de permitir a los usuarios instalar servicios. Eliminamos los GitHub Services de la interface de usuario de GitHub.com.
• 29 de enero de 2019: como alternativa al servicio de correo electrónico, ahora puede comenzar a utilizar las notificaciones por correo electrónico para los envíos de cambios en el repositorio. Consulte "Acerca de las notificaciones por correo electrónico para los envíos de cambios en el repositorio" para obtener información sobre cómo configurar las notificaciones por correo electrónico de confirmación.
• 31 de enero de 2019: GitHub dejará de ofrecer eventos de los servicios instalados en GitHub.com.

Antecedentes de GitHub Services

GitHub Services (a veces denominado enlaces de servicio) es el método heredado de integración en el que GitHub hospeda una parte de los servicios del integrador desde el github-services repositorio. Las acciones que se realizan en GitHub activan estos servicios, y puedes utilizarlos a su vez para activar acciones fuera de GitHub.

Encontrar los repositorios que utilizan GitHub Services

Proporcionamos un script de línea de comandos que te ayuda a identificar los repositorios de tu aplicativo que utilizan GitHub Services. Para obtener más información, consulte ghe-legacy-github-services-report.

GitHub Services vs webhooks

Las diferencias clave entre GitHub Services y los webhooks son:

• Configuración: GitHub Services tiene opciones de configuración específicas de servicios, mientras que los webhooks se configuran simplemente especificando una URL y un conjunto de eventos.
• Lógica personalizada: GitHub Services puede tener una lógica personalizada que responda con acciones múltiples tras procesar un solo evento, mientras que los webhooks no tienen lógica personalizada.
• Tipos de solicitudes: GitHub Services pueden realizar tanto solicitudes HTTP como de otro tipo, mientras que los webhooks solo realizan solicitudes HTTP.

Reemplazar los Servicios con webhooks

Para reemplazar los GitHub Services con Webhooks:

1. Identifique los eventos de webhook pertinentes a los que deberá suscribirse desde esta lista.

2. Cambia tu configuración dependiendo de cómo utilizas los GitHub Services actualmente:

   • Aplicaciones de GitHub: actualiza los permisos y eventos suscritos de la aplicación para configurarla de manera que reciba los eventos de webhook correspondientes.
   • Aplicaciones de OAuth: solicita los alcances repo_hook o org_hook para administrar los eventos pertinentes en nombre de los usuarios.
   • Proveedores de GitHub Services: solicita que los usuarios configuren manualmente un webhook con los eventos pertinentes que se le envíen, o aprovecha esta oportunidad para crear una aplicación que administre esta funcionalidad. Para obtener más información, consulte "Acerca de las aplicaciones".

3. Migra las configuraciones adicionales desde fuera de GitHub. Algunos GitHub Services necesitan configuraciones personalizadas adicionales en la página de configuración dentro de GitHub. Si tu servicio hace esto, necesitarás migrar esta funcionalidad en tu aplicación o depender de GitHub o de las Apps de OAuth conforme esto aplique.

Compatibilidad con GitHub Enterprise Server

• GitHub Enterprise Server 2.17: GitHub Enterprise Server versión 2.17 y posteriores dejarán de permitir que los administradores instalen servicios. Los aministradores podrán seguir modificando los ganchos de servicio existentes y recibiendo ganchos en el GitHub Enterprise Server con lanzamiento 2.17 hasta el 2.19. Como una alternativa al servicio de correo electrónico, podrás utilizar las notificaciones de correo electrónico para las cargas de información a tu repositorio en el GitHub Enterprise Server 2.17 y superior. Consulte esta entrada de blog para obtener más información.
• GitHub Enterprise Server 2.20: GitHub Enterprise Server versión 2.20 y posteriores dejarán de entregar cualquier evento de los servicios instalados.

El lanzamiento 2.17 de GitHub Enterprise Server será el primer lanzamiento que no permite a los administradores instalar GitHub Services. Únicamente admitiremos los GitHub Services existentes hasta el lanzamiento 2.20 de GitHub Enterprise Server. También aceptaremos cualquier parche crítico para tu Github Service que se ejecute en el GitHub Enterprise Server hasta el 1 de octubre de 2019.

Migrarte con nuestra ayuda

Si tiene alguna pregunta, póngase en contacto con nosotros.

Como un resumen de alto nivel, el proceso de migración involucra habitualmente:

• Identificar cómo y dónde tu producto está utilizando los GitHub Services.
• Identificar los eventos de webhook correspondientes que necesites configurar para poder migrarlos a webhooks sencillos.
• Implementación del diseño con OAuth Apps o GitHub Apps. Se prefieren las GitHub Apps. Para obtener más información sobre por qué se prefieren las GitHub Apps, consulte "Motivos para cambiar a GitHub Apps".