En esta página se muestra cómo el conector de GitHub puede supervisar y crear proyectos en función de los cambios que se producen en un conjunto de repositorios de GitHub.

El conector de GitHub supervisa archivos específicos en repositorios de GitHub, dado un intervalo de tiempo determinado. Normalmente en proyectos de localización, los archivos comunes son JSON, YML, XLIFF, XML, STRINGS o cualquier otro formato estructurado y predecible. Al comparar el hash del archivo con un repositorio de traducciones ejecutadas previamente para ese mismo archivo, si se detecta un cambio, se creará un nuevo proyecto y se inician los proyectos de traducción.

Podemos monitorear repositorios de GitHub usando su API REST. Para ello, nuestros clientes deben autorizar una cuenta para crear un token en Bureau Works para acceder a la API. Estas credenciales se cifran con AES 256 y se almacenan en el perfil del cliente.

Hay dos estrategias de supervisión: ramas y solicitudes deextracción.

El conector supervisará constantemente una o más ramas en uno o más repositorios, y una vez que se modifiquen los archivos que se observan, creará un proyecto en Bureau Works y notificará a nuestro equipo. En los proyectos de localización continua, las cadenas traducidas anteriormente se tienen plenamente en cuenta.

Una vez que se entrega un proyecto, el conector de GitHub creará una solicitud de extracción para una rama de revisión que contiene los archivos una vez finalizada la traducción. Podemos personalizar la ruta de salida y las estrategias de nomenclatura para los archivos de salida. Esto crea un mecanismo de entrega no intrusivo y muy elegante cuando un equipo tiende a usar una o solo unas pocas ramas para el desarrollo.

Al igual que la estrategia de sucursal, también podemos supervisar las solicitudes de extracción, para los equipos que usan Gitflow o flujos de trabajo similares. El conector puede supervisar todas las solicitudes de extracción, para todas las ramas, para los mismos archivos configurados. Una vez más, una vez que se encuentra una diferencia basada en el hash del archivo, se creará un proyecto.

La gran diferencia con esta estrategia es el mecanismo de entrega. Dado que las solicitudes de extracción hacen referencia a una rama, una vez que se entrega un proyecto, connector creará una confirmación en la misma rama que la solicitud de extracción. Una vez que la solicitud de extracción es aceptada y fusionada, llevará a lo largo de los archivos traducidos a la rama de destino, es decir, maestro, desarrollo, etc.

Para configurar el conector de GitHub, lo primero que debe hacer es autorizar a Bureau Works a acceder a sus repositorios. Como capa adicional de seguridad, le recomendamos que cree un usuario que tenga acceso exclusivo a los repositorios de interés dentro de su organización.

Si no puede ver el flujo de trabajo de autorización de GitHub, es posible que no tenga los roles adecuados aplicados a su cuenta. Comuníquese con el contacto de su organización, o si esa persona es usted, envíenos un correo electrónico a [email protected].

1. Abra Mi cuenta en la esquina superior derecha de la vista Obras de Bureau.

2. En la barra superior, seleccione Conectar GitHub

3. Inicie sesión en GitHub con la cuenta que desea conectar a Bureau Works.

4. GitHub le enviará de vuelta a Bureau Works y le mostrará un mensaje si la autenticación se realiza correctamente.

Una vez que autorice Bureau Works, debe proporcionarnos rutas de archivos y repositorios que necesitan supervisión. Por ejemplo, en proyectos de iOS, es común tener un archivo denominado Localizable.strings implementado en cada carpeta de idioma, por ejemplo:

Necesitamos determinar cuál es el archivo de origen y cuáles son las rutas deseadas para entregar las traducciones. Cada entrega realizada por el conector de GitHub, dependiendo de la estrategia seleccionada, colocará los archivos en la estructura de carpetas correcta en el repositorio GitHub.

Este paso es realizado por nuestro equipo, y se gestiona a través de nuestro soporte en [email protected].

Cada instancia de GitHub Connector es exclusiva del cliente, se ejecuta en un contenedor independiente y solo puede tener acceso al token de GitHub enlazado al perfil del cliente en Bureau Works. Una vez que se crea un token, otorgará Bureau Works acce/zooss a repositorios públicos y privados dentro de esa organización, con el fin de crear correctamente solicitudes de extracción y confirmaciones.

Nuestro equipo no tiene acceso al token cifrado, por lo que no podemos acceder a los repositorios a través de la API. Proporcionamos un seguimiento de auditoría detallado para el uso, si es necesario, y el sistema GitHub también realiza un seguimiento del uso del token.