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 el equipo de ventas para preguntar por nuestros planes.

Disponible para

  • Planes Ultimate y Enterprise (Legacy)

Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.

Consejo

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

El conector de GitHub permite descargar archivos de origen y cargar archivos de destino directamente desde o hacia el repositorio de GitHub.

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

Casos prácticos

Hay varios casos prácticos del 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 la 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 de los 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 de origen.

  • Configura trabajos continuos para que los archivos seleccionados se supervisen.

GitHub (Beta)

Nota

El conector se encuentra en fase 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 son de corta duración y se renuevan automáticamente. Si un usuario abandona la organización o pierde el acceso al repositorio, el conector sigue funcionando.

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

Exportación

El conector de GitHub (Beta) agrupa todos los archivos de una exportación en una confirmación y una solicitud de extracción, por lo que la integración continua se ejecuta una vez por exportación, independientemente del número de archivos.

Los archivos se agrupan en una única confirmación cuando todo el contenido comparte el mismo propietario del repositorio, repositorio y rama.

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

Los mensajes de confirmación 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 de destino se pueden personalizar.

Limitaciones conocidas

  • El conector solo puede listar, descargar y cargar archivos. No se admite la eliminación o el movimiento de archivos en GitHub. Cualquier eliminación o cambio de nombre debe realizarse directamente en GitHub.

  • Es posible que el listado de archivos no funcione 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 admite el flujo OAuth del conector heredado. Si tu organización tiene restricciones en las instalaciones de aplicaciones de GitHub, resuélvelas antes de migrar.

Cambio al nuevo conector de GitHub (Beta)

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

Nota

Cambiar un APC continuo del conector heredado al nuevo conector no es una migración. Phrase lo trata como una nueva configuración de conector, por lo que el APC vuelve a importar el archivo fuente como un trabajo nuevo en lugar de actualizar el existente. El archivo se trata como contenido nuevo, por lo que las palabras procesadas anteriormente y las Unidades de Traducción Automática (MTU) no se transfieren. Al cambiar de conector a mitad de un proyecto, espere que el recuento de palabras y el consumo de MTU para los archivos afectados reflejen una reimportación completa.

Requisitos previos

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

  • La instalación de la aplicación de GitHub debe tener acceso a los repositorios con contenido para traducir; de lo contrario, la importación a través de APC fallará.

  • Configuración de APC existente visible (mantén el conector heredado abierto en una segunda pestaña).

  • Una rama de prueba o un repositorio que no sea de producción para validar antes de cambiar los flujos de trabajo en vivo.

Sigue estos pasos:

  1. Instala la aplicación de GitHub para Phrase

    1. En Phrase TMS, desde la página de Setup_gear.png Configuración, desplázate hacia abajo 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 Phrase GitHub.

    6. En GitHub, selecciona la organización o cuenta y los repositorios a los que deseas otorgar acceso, luego confirma la instalación. Incluye todos los repositorios supervisados actualmente por el o los conectores existentes.

      GitHub redirige a Phrase automáticamente.

    7. Selecciona la cuenta de usuario u organización que deseas conectar.

  2. Crea un nuevo conector.

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

    2. Haz clic en Conectores.

    3. Haz clic en Nuevo conector.

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

    5. Copia la configuración del conector existente:

      • Repositorio y rama

      • Ruta de la subcarpeta (si usas supervisión de subcarpetas)

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

      • Modo de exportación: confirmación directa o solicitud de extracción, y rama de destino

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

      Puedes crear varios conectores bajo la misma instalación de la aplicación de GitHub, cada uno con una configuración independiente.

  3. Vuelve a crear los APC existentes utilizando el modo dry-run.

    No elimines ni deshabilites aún los APC existentes.

    1. Crea nuevos APC que apunten al nuevo conector, replicando la configuración de los APC existentes.

    2. Habilita el modo dry-run en cada nuevo APC antes de activarlo. El modo dry-run escanea el repositorio y busca coincidencias de archivos sin activar trabajos de traducción.

    3. Revisa los archivos que coinciden. Confirma que el alcance coincide con lo que supervisa el APC existente.

  4. Valida con una exportación de prueba.

    1. Realiza un pequeño cambio en un archivo dentro del alcance supervisado.

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

    3. Confirmar

      • Se crea una única confirmación (no una por archivo).

      • La confirmación aparece bajo la identidad de la aplicación de GitHub, no de una cuenta personal.

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

  5. Cambia a los flujos de trabajo en vivo.

    Una vez que la validación sea correcta:

    1. Deshabilita los APC en el conector heredado.

    2. Habilita los APC en el nuevo conector (quita el modo dry-run).

    3. Supervisa durante uno o dos ciclos de exportación antes de retirar el conector heredado.

  6. Retira el conector heredado.

    Una vez que confirmes que el nuevo conector es estable:

    1. Elimina los APC antiguos.

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

    3. Opcionalmente, revoca el token OAuth de la cuenta de usuario que usaba el conector heredado.

Configuración de GitHub (heredada)

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 de Configuración Setup_gear.png, desplázate hacia abajo 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, habilita Usar dominio personalizado y proporciona API URL.

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

  7. Si es necesario, selecciona Usar aplicación de Github para mostrar la URL de la aplicación Phrase GitHub e importar/exportar archivos mediante 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 Phrase App 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 GitHub en la cuenta de GitHub de destino.

      Nota

      Si la aplicación de GitHub no está instalada en tu cuenta de GitHub de destino, solo los repositorios públicos serán visibles para el conector de GitHub.

    3. Completa el procedimiento de instalación seleccionando los repositorios privados que serán visibles y accesibles para el conector de GitHub.

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

  8. Haz clic en Conectar a GitHub. Si no te conectas mediante la aplicación de GitHub, aparecerá una ventana emergente o una nueva pestaña solicitando autorización.

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

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

    Si utilizas la aplicación de GitHub, haz clic en el botón Autorizar conector de Phrase App.

    Si todo sale bien, la ventana o pestaña desaparecerá y aparecerá una pequeña marca de verificación junto al botón Conectar a GitHub.

  11. Haz clic en Guardar.

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

    Importante

    Si creas el conector de GitHub usando el flujo de autorización de la aplicación, no podrás cambiar el método de autorización después de guardar la configuración del conector.

Eliminar un conector

Para eliminar un conector:

  1. Desde la página Integraciones, selecciona el conector que deseas eliminar.

  2. Haz clic en Eliminar.

    Se abre la ventana Eliminar conector.

  3. Escribe "delete" y haz clic en Eliminar.

    El conector se elimina y se muestra la lista de conectores.

Nota

Un conector no puede eliminarse mientras esté vinculado a trabajos incompletos en un proyecto, incluidos los trabajos que se encuentran en la Papelera de reciclaje. Intentar eliminar dicho conector devuelve un error de "Error al eliminar el conector".

Resolución Abre el proyecto asociado con el conector y completa o elimina los trabajos restantes. Ve a Configuración/Papelera de reciclaje y vacíala para eliminar cualquier trabajo que siga vinculado al conector. Intenta eliminar el conector de nuevo.

¿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.