-
Planes Team, Business y Enterprise
Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.
-
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 el acceso a todos los repositorios asociados a una cuenta de GitHub. La autenticación de la cuenta de GitHub también se puede realizar en GitHub App.
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 de archivo de los archivos supervisados o de los archivos de una carpeta supervisada.
-
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 GitHub App 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 GitHub App. La opción OAuth del conector original no es compatible.
Exportación
El conector de GitHub (Beta) agrupa todos los archivos de una sola exportación en una confirmación y una solicitud de extracción, por lo que la integración continua (CI) se ejecuta una vez por exportación, independientemente del número de archivos.
Los archivos se agrupan en una sola 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 solicitud de extracción, se pueden personalizar el nombre de la solicitud de extracción y el de la rama de destino.
Ruta de exportación y subcarpetas
Cuando «Exportar archivos del repositorio en línea a la ruta» comienza con / (una ruta absoluta), el conector de GitHub (Beta) conserva la estructura de subcarpetas de los archivos de origen. Cada archivo traducido se exporta, dentro de la ruta de exportación, a una subcarpeta equivalente a la que ocupa el archivo de origen dentro de la carpeta supervisada por la creación automática de proyectos (APC).
Un archivo situado directamente en la carpeta supervisada se exporta directamente a la ruta de exportación. No se añade ninguna subcarpeta para una ruta de exportación relativa o cuando no se incluyen subcarpetas.
Una ruta de exportación absoluta comienza en la raíz del repositorio de la rama de origen.
Limitaciones conocidas
-
El conector solo puede listar, descargar y cargar archivos. No se admite la eliminación o el traslado 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 para instalar 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 del conector, por lo que la APC vuelve a importar el archivo de origen como un nuevo trabajo 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. Si cambias de conector a mitad de un proyecto, ten en cuenta que el recuento de palabras y el consumo de MTU/créditos de los archivos afectados reflejarán 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 las APC existentes a la vista (mantén abierto el conector anterior 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 activos.
Sigue estos pasos:
-
Instala la aplicación de GitHub de Phrase.
-
En Phrase TMS, desde la página de Configuración
, baja hasta la sección .
-
Haz clic en Conectores.
Se abrirá la página .
-
Haz clic en Nuevo conector.
Se abrirá la página .
-
Cambia el Tipo a GitHub (Beta).
-
Haz clic en Conectar.
Phrase te redirige a GitHub para autorizar la aplicación de GitHub de Phrase.
-
En GitHub, selecciona la organización o cuenta y los repositorios a los que quieres conceder acceso. Después, confirma la instalación. Incluye todos los repositorios supervisados actualmente por los conectores existentes.
GitHub te redirige a Phrase automáticamente.
-
Selecciona la cuenta de usuario o de organización que quieres conectar.
-
-
Crea un nuevo conector.
-
En Phrase TMS, desde la página de Configuración
-
Haz clic en Conectores.
-
Haz clic en Nuevo conector.
-
Selecciona la instalación de la aplicación de GitHub configurada en el primer paso.
-
Copia la configuración del conector existente:
-
Repositorio y rama
-
Ruta de la subcarpeta (si supervisas 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 de solicitudes de extracción)
Es posible crear múltiples conectores bajo la misma instalación de la aplicación de GitHub, cada uno con configuraciones independientes.
-
-
-
Vuelve a crear las APC existentes en el modo dry-run.
No elimines ni desactives las APC existentes todavía.
-
Crea nuevas APC que apunten al nuevo conector y repliquen la configuración de las APC existentes.
-
Activa el modo dry-run en cada nueva APC antes de activarla. El modo dry-run escanea el repositorio y busca coincidencias de archivos sin activar trabajos de traducción.
-
Revisa los archivos encontrados. Confirma que el alcance coincide con el de la APC existente.
-
-
Valida la configuración con una exportación de prueba.
-
Haz un pequeño cambio en un archivo dentro del alcance supervisado.
-
Inicia una exportación mediante el nuevo conector.
-
Confirma lo siguiente:
-
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.
-
-
-
Cambia los flujos de trabajo activos.
Una vez que la validación sea correcta:
-
Desactiva las APC del conector heredado.
-
Activa las APC del nuevo conector (desactiva el modo dry-run).
-
Supervisa uno o dos ciclos de exportación antes de retirar el conector heredado.
-
-
Retira el conector heredado.
Después de confirmar que el nuevo conector es estable:
-
Elimina las APC antiguas.
-
Elimina el conector heredado desde Configuración → Conectores → GitHub (Heredado).
-
Si quieres, revoca el token OAuth de la cuenta de usuario que utilizaba el conector heredado.
-
Configuración de GitHub (heredado)
No se requieren cambios.
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.
-
En la página Configuración
-
Haz clic en Conectores.
Se abrirá la página .
-
Haz clic en Nuevo conector.
Se abrirá la página .
-
Cambia el Tipo a GitHub y pon un nombre al conector.
-
Opcionalmente, activa y proporciona la .
-
Opcionalmente, selecciona y proporciona una .
-
Si es necesario, selecciona para mostrar la URL de la aplicación de GitHub de Phrase e importar/exportar archivos mediante el flujo de autorización de la aplicación de GitHub:
-
Haz clic en el enlace para abrir la página oficial de Phrase App Connector 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.).
-
Instala la aplicación de GitHub de Phrase en la cuenta de GitHub de destino.
Nota
Si la aplicación de GitHub no está instalada en la cuenta de GitHub de destino del usuario, solo los repositorios públicos serán visibles para el conector de GitHub.
-
Completa el procedimiento de instalación seleccionando los repositorios privados que serán visibles y accesibles para el conector de GitHub.
-
Vuelve a la página de Phrase para autorizar la aplicación de GitHub y conectarte a GitHub.
-
-
Haz clic en Conectar con GitHub. Si no te has conectado mediante la aplicación de GitHub, aparecerá una ventana emergente o una nueva pestaña solicitando autorización.
-
Proporciona un si es necesario.
-
Haz clic en el botón Autorizar a Phrase.
Si utilizas la aplicación de GitHub, haz clic en el botón Autorizar a Phrase App Connector.
Si la operación se realiza correctamente, la ventana o pestaña desaparecerá y aparecerá una pequeña marca de verificación junto al botón Conectar con GitHub.
-
Haz clic en Guardar.
El conector se añadirá a la lista de la página .
Importante
Si el conector de GitHub se crea mediante 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.