Integraciones

GitHub (TMS)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Disponible para

  • Planes Team, Business y Enterprise

Ponte en contacto con Ventas para preguntas sobre licencias.

Disponible para

  • Planes Ultimate y Enterprise (Legacy)

Ponte en contacto con Ventas para preguntas sobre licencias.

Consejo

Para obtener información sobre la integración de GitHub en Phrase Strings, consulta GitHub (Strings).

El conector de GitHub permite la descarga de archivos fuente y la carga de archivos de destino directamente al/desde el repositorio de GitHub.

El conector utiliza la API de GitHub para implementar la integración. El conector permite el acceso a todos los repositorios asociados con una cuenta de GitHub. La autenticación de la cuenta de GitHub también se puede realizar en la Aplicación de GitHub.

Casos de uso

Hay varios casos de uso para el conector:

  • Los project managers pueden agregar archivos directamente a los proyectos desde un repositorio en línea.

  • Configura el portal de solicitudes para permitir que los remitentes agreguen archivos a las solicitudes directamente desde el repositorio en línea.

  • Usa creación automática de proyectos (APC) para que se creen nuevos proyectos automáticamente cuando se detecte un cambio en el tamaño del archivo en archivos o una carpeta supervisados.

    • Este conector admite la configuración de rutas absolutas. Los archivos de traducción de destino solo se pueden almacenar en la misma rama que el archivo fuente.

  • Configura trabajos continuos para que los archivos seleccionados se supervisen en busca de cambios.

GitHub (Beta)

Nota

El conector está en beta desde junio de 2026.

Autenticación

El conector de GitHub (Beta) utiliza el token de instalación de la aplicación de GitHub en lugar de una cuenta de usuario individual. Los tokens tienen una vida corta y se renuevan automáticamente. Si un usuario deja la organización o pierde acceso al repositorio, el conector sigue funcionando.

El conector de GitHub (Beta) solo admite autenticación de la aplicación de GitHub. La opción OAuth del conector original no es compatible.

Exportar

El conector de GitHub (Beta) agrupa todos los archivos de una única exportación en un solo commit y una sola solicitud de extracción, por lo que CI se ejecuta una vez por exportación, independientemente de la cantidad de archivos.

Los archivos se agrupan en un solo commit cuando todo el contenido comparte el mismo propietario del repositorio, repositorio y rama.

Si el APC está configurado para cargar archivos a medida que se completan individualmente, cada archivo se confirmará por separado en lugar de agruparse.

Los mensajes de commit se generan automáticamente y no se pueden personalizar. Si se exporta como una solicitud de extracción, el nombre de la solicitud de extracción y el nombre de la rama objetivo se pueden personalizar.

Limitaciones conocidas

  • El conector solo puede listar, descargar y cargar archivos. Eliminar o mover archivos en GitHub no es compatible. Cualquier eliminación o cambio de nombre debe hacerse directamente en GitHub.

  • La lista de archivos puede no funcionar correctamente para repositorios con más de 50,000 archivos debido a las limitaciones de la API de GitHub.

  • GitHub Enterprise Server no es compatible actualmente.

  • El nuevo conector no soporta el flujo OAuth del conector heredado. Si tu organización tiene restricciones sobre las instalaciones de aplicaciones de GitHub, resuélvelas antes de migrar.

Migración al nuevo conector de GitHub (Beta)

La migración automatizada no es posible debido al cambio en el modelo de autenticación.

Requisitos previos:

  • Acceso de administrador a tu organización de GitHub para instalar una aplicación de GitHub. Instálalo a nivel de organización para que cubra todos los repositorios que tus APCs monitorean.

  • Configuraciones de APC existentes visibles (mantén el antiguo conector abierto en una segunda pestaña).

  • Una rama de prueba o un repositorio no productivo para validar antes de cambiar flujos de trabajo en vivo.

Sigue estos pasos:

  1. Instala la aplicación de GitHub Phrase.

    1. En Phrase TMS, desde la página de Configuración Setup_gear.png, baja hasta la sección Integraciones.

    2. Haz clic en Conectores.

      Se abrirá la página Conectores.

    3. Haz clic en Nuevo conector.

      Se abrirá la página Crear conector.

    4. Cambia el Tipo a GitHub (Beta).

    5. Haz clic en Conectar.

      Phrase redirige a GitHub para autorizar la aplicación de GitHub Phrase.

    6. En GitHub, selecciona la organización o cuenta y los repositorios a los que otorgar acceso, luego confirma la instalación. Incluya todos los repositorios actualmente monitoreados por el/los conector(es) existente(s).

      GitHub redirige automáticamente a Phrase.

    7. Seleccione la cuenta de usuario u organización para conectar.

  2. Cree un nuevo conector.

    1. En Phrase TMS, desde la página de Configuración Setup_gear.png, baja hasta la sección Integraciones.

    2. Haz clic en Conectores.

    3. Haz clic en Nuevo conector.

    4. Seleccione la instalación de la aplicación de GitHub configurada en el primer paso.

    5. Copie la configuración del conector existente:

      • Repositorio y rama

      • Ruta de la subcarpeta (si utiliza monitoreo de subcarpetas)

      • Expresión regular de filtro de archivos (si está configurada)

      • Modo de exportación: compromiso directo o solicitud de extracción, y rama objetivo

      • Nombre de la solicitud de extracción y nombre de la rama objetivo (si utiliza el modo de PR)

      Es posible crear múltiples conectores bajo la misma instalación de la aplicación de GitHub, cada uno con configuraciones independientes.

  3. Recrea los APC existentes utilizando el modo de prueba.

    No elimine ni deshabilite los APC existentes aún.

    1. Cree nuevos APC apuntando al nuevo conector, reflejando la configuración del APC existente.

    2. Habilite el modo prueba en cada nuevo APC antes de activarlo. El modo de prueba escanea el repositorio y coincide con los archivos sin activar trabajos de traducción.

    3. Revise los archivos coincidentes. Confirme que el alcance coincide con lo que monitorea el APC existente.

  4. Valide con una exportación de prueba.

    1. Realiza un pequeño cambio en un archivo en el ámbito monitoreado.

    2. Inicia una exportación a través del nuevo conector.

    3. Confirmar:

      • Se crea un único commit (no uno por archivo).

      • El commit aparece bajo la identidad de la aplicación de GitHub, no en una cuenta personal.

      • CI se ejecuta una vez, no una vez por archivo.

  5. Cambia los flujos de trabajo en vivo.

    Una vez que la validación pase:

    1. Deshabilita los APC en el conector heredado.

    2. Habilita los APC en el nuevo conector (elimina el modo de prueba).

    3. Monitorea uno o dos ciclos de exportación antes de desactivar el conector heredado.

  6. Desactiva el conector heredado.

    Después de confirmar que el nuevo conector es estable:

    1. Elimina los APC antiguos.

    2. Elimina el conector heredado de Configuración → Conectores → GitHub (Heredado).

    3. Opcionalmente, revoca el token OAuth para la cuenta de usuario que fue utilizada por el conector heredado.

Configuración de GitHub (heredado)

No se requieren cambios.

Configuración de Phrase TMS

Importante

Si accedes desde un dominio personalizado (por ejemplo, mydomain.phrase.jp), abre una ventana de navegador en modo incógnito e inicia sesión a través de cloud.memsource.com o us.cloud.memsource.com para aplicar la autenticación requerida para la creación o el guardado del conector. Después de guardar, se puede acceder al conector a través del dominio personalizado.

  1. En la página Setup_gear.png Configuración, baja hasta la sección Integraciones.

  2. Haz clic en Conectores.

    Se abrirá la página Conectores.

  3. Haz clic en Nuevo conector.

    Se abrirá la página Crear conector.

  4. Cambia el Tipo a GitHub y proporciona un nombre para el conector.

  5. Opcionalmente selecciona Exportar traducciones como solicitudes de extracción y proporciona una Rama de solicitud de extracción.

  6. Si es necesario, selecciona Usar la aplicación de GitHub para mostrar la URL de la aplicación Phrase de GitHub e importar/exportar archivos utilizando el flujo de autorización de la aplicación de GitHub:

    1. Haz clic en el enlace para abrir la página oficial del Conector de la Aplicación Phrase en una nueva pestaña: https://github.com/apps/phrase-app-connector-eu (centro de datos de la UE) o https://github.com/apps/phrase-app-connector-us (centro de datos de EE. UU.).

    2. Instala la aplicación Phrase de GitHub en la cuenta de GitHub objetivo.

      Nota

      Si la aplicación de GitHub no está instalada en la cuenta de GitHub objetivo del usuario, solo se verán los repositorios públicos en el conector de GitHub.

    3. Completa el procedimiento de instalación seleccionando cualquier repositorio privado que será visible y accesible para el conector de GitHub.

    4. Regresa a la página Conectores/Crear de Phrase para autorizar la aplicación de GitHub y conectarte a GitHub.

  7. Haz clic en Conectar a GitHub. Si no estás conectado usando la aplicación de GitHub, aparecerá una ventana emergente o una nueva pestaña solicitando autorización.

  8. Proporciona un Mensaje de confirmación si es necesario.

  9. Haz clic en el botón Autorizar Phrase.

    Si usas la aplicación de GitHub, haz clic en el botón Autorizar Conector de la Aplicación Phrase.

    Si es exitoso, la ventana/pestaña desaparecerá y aparecerá una pequeña marca de verificación junto al botón Conectar a GitHub.

  10. Haz clic en Guardar.

    El conector se añade a la lista de la página Conectores.

    Importante

    Si el conector de GitHub se crea utilizando el flujo de autorización de la aplicación de GitHub, no es posible cambiar el método de autorización después de guardar la configuración del conector.

¿Fue útil este artículo?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.