Cómo Crear una Aplicación GitHub Autoalojada

Si estás utilizando Bencher Cloud, entonces puedes simplemente registrarte o iniciar sesión usando el botón GitHub.

Für die selbstgehostete Bencher-Variante benötigen Sie einen Bencher Plus Enterprise-Plan, müssen Ihre eigene GitHub-App erstellen und Ihre Konsolenkonfiguration sowie die API-Server-Konfiguration aktualisieren.

Crea una Aplicación GitHub

• Crea una Aplicación GitHub
• Nombre de la aplicación GitHub
  • Escoge un nombre único (ej: Bencher para Mi Empresa)
• URL de la página de inicio
  • Configúralo a tu URL de la Consola Bencher Autoalojada (ej: https://bencher.example.com)
• Identificar y autorizar a usuarios
  • URL de devolución de llamada
    • Configura la URL de devolución de llamada a tu URL de la Consola Bencher Autoalojada con la ruta /auth/github (ej: https://bencher.example.com/auth/github)
  • ✅ caducar los tokens de autorización del usuario
  • ✅ solicitar la autorización del usuario (OAuth) durante la instalación
  • ✅ habilitar flujo de dispositivo
• Webhook
  • ❌ Activo - Desmarca esta casilla
• Permisos
  • Permisos de la cuenta
    • Direcciones de correo electrónico: Solo lectura
• ¿Dónde se puede instalar esta aplicación GitHub?
  • 🔘 cualquier cuenta
• Haz clic en Crear aplicación GitHub
• Ahora debajo de General para la nueva aplicación creada
• Toma nota del ID del Cliente (ej: Iv1.12864abcd1232048)
• Secretos del cliente
  • Haz clic en Generar un nuevo secreto del cliente
  • Toma nota de este secreto (ej: 00000abcd12345wxyz123456789abcdefgh0000)
• Añade el logo PNG de Bencher bajo Información para mostrar
• Claves privadas
  • Haz clic en Generar una clave privada

Configuración de la Aplicación GitHub

Consola UI

Configura la variable de entorno GITHUB_CLIENT_ID cuando ejecutes la imagen Docker bencher-console. (ej: GITHUB_CLIENT_ID=Iv1.12864abcd1232048) Si falta el ID del cliente, los botones de GitHub no aparecerán en la interfaz de usuario.

Servidor API

Añade el client_id y el client_secret a la sección plus.github de la configuración del servidor. Si falta la sección de GitHub, entonces el servidor fallará cualquier petición de autenticación de GitHub.

Repositorios vinculados

Actualiza el servidor API y la Consola de Bencher Autoalojado a v0.6.16 o posterior antes de cambiar estos ajustes.

Para que un Proyecto pueda vincular un repositorio de GitHub para sus ejecuciones desacopladas, configura también lo siguiente en la aplicación de GitHub:

• Identificar y autorizar a usuarios
  • URL de devolución de llamada
    • Configura la primera URL de devolución de llamada a tu URL de la Consola Bencher Autoalojada con la ruta /console/github (ej: https://bencher.example.com/console/github). GitHub envía al usuario a la primera URL de devolución de llamada después de que instala la aplicación.
    • Mantén después la URL de devolución de llamada con la ruta /auth/github, para iniciar sesión (ej: https://bencher.example.com/auth/github). GitHub rechaza un inicio de sesión cuya URL de devolución de llamada no está en la lista.
  • ✅ solicitar la autorización del usuario (OAuth) durante la instalación
• Webhook
  • ✅ Activo - Marca esta casilla
  • URL del webhook
    • Configúrala a tu URL del Servidor API de Bencher Autoalojado con la ruta /v0/github/webhook (ej: https://api.bencher.example.com/v0/github/webhook)
  • Secreto del webhook
    • Introduce un secreto aleatorio y toma nota de él (ej: 0123456789abcdef0123456789abcdef)
• Permisos
  • Permisos del repositorio
    • Contenido: Lectura y escritura
  • Suscribirse a eventos
    • Deja todos los eventos sin marcar
• Toma nota del slug de la aplicación, la última parte de la URL de su página pública (ej: my-bencher-app en https://github.com/apps/my-bencher-app)

Añade el slug, la clave privada y el secreto del webhook como app a la sección plus.github de la configuración del servidor.

🐰 ¡Felicidades! ¡Has aprendido cómo configurar una Aplicación de GitHub! 🎉

Añadir Bencher a GitHub Actions ➡