-
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 fuente y cargar archivos meta 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 puede realizarse en la aplicación de GitHub.
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 meta solo pueden almacenarse en la misma rama que el archivo fuente.
-
-
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 identificador único (token) de instalación de la aplicación de GitHub en lugar de una cuenta de usuario individual. Los identificadores únicos (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 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 sola exportación en una confirmación (commit) y una solicitud de extracción (pull request), 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 (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 enviará 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 meta se pueden personalizar.
Limitaciones conocidas
-
El conector solo puede listar, descargar y cargar archivos. No se admite eliminar o mover 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 su organización tiene restricciones en las instalaciones de aplicaciones de GitHub, resuélvalas antes de realizar la migración.
Cambiar 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 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. Al cambiar de conector a mitad de un proyecto, espere que el recuento de palabras y el consumo de MTU de los archivos afectados reflejen una reimportación completa.
Requisitos previos:
-
Acceso de admin a su organización de GitHub para instalar una aplicación de GitHub. Instálela a nivel de organización para que cubra todos los repositorios que supervisan sus APC.
-
Configuración de APC existente visible (mantén el conector antiguo 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:
-
Instala la aplicación de Phrase GitHub.
-
En Phrase TMS, en la página 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 .
-
Cambiar el Tipo a GitHub (Beta).
-
Haz clic en Conectar.
Phrase redirige a GitHub para autorizar la aplicación de Phrase GitHub.
-
En GitHub, seleccionar la organización o cuenta y los repositorios a los que conceder acceso, luego confirmar la instalación. Incluye cada repositorio supervisado actualmente por el conector o los conectores existentes.
GitHub redirige a Phrase automáticamente.
-
Seleccionar la cuenta de usuario u organización para conectar.
-
-
Crear un nuevo conector.
-
En Phrase TMS, en la página Configuración
-
Haz clic en Conectores.
-
Haz clic en Nuevo conector.
-
Seleccionar la configuración de instalación de la aplicación de GitHub realizada en el primer paso.
-
Copiar la configuración del conector existente:
-
Repositorio y rama
-
Ruta de la subcarpeta (si se utiliza la 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 meta
-
Nombre de la solicitud de extracción y nombre de la rama meta (si se utiliza el modo de PR)
Es posible crear múltiples conectores bajo la misma instalación de GitHub App, cada uno con configuración independiente.
-
-
-
Volver a crear los APC existentes usando el modo de prueba.
No eliminar ni deshabilitar los APC existentes todavía.
-
Crear nuevos APC que apunten al nuevo conector, replicando la configuración de APC existente.
-
Habilitar el modo dry-run en cada nuevo APC antes de activarlo. El modo de prueba escanea el repositorio y hace coincidir los archivos sin activar trabajos de traducción.
-
Revise los archivos coincidentes. Confirmar que el ámbito coincide con lo que supervisa el APC existente.
-
-
Valide con una exportar de prueba.
-
Realice un pequeño cambio en un archivo dentro del ámbito supervisado.
-
Inicie una exportar a través del nuevo conector.
-
Confirmar:
-
Se crea una única confirmación (no una por archivo).
-
La confirmación aparece bajo la identidad de la GitHub App, no de una cuenta personal.
-
La CI se ejecuta una vez, no una vez por archivo.
-
-
-
Cambie los flujos de trabajo activos.
Una vez que la validación sea correcta:
-
Deshabilitar los APC en el conector heredado.
-
Habilitar los APC en el nuevo conector (eliminar el modo de prueba).
-
Supervise durante uno o dos ciclos de exportar antes de retirar el conector heredado.
-
-
Eliminar el conector heredado.
Después de confirmar que el nuevo conector es estable:
-
Eliminar los APC antiguos.
-
Eliminar el conector heredado desde Configuración → Conectores → GitHub (heredado).
-
Opcionalmente, revocar el identificador único (token) de OAuth para la cuenta de usuario que fue utilizada por 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
-
Haz clic en Conectores.
Se abrirá la página .
-
Haz clic en Nuevo conector.
Se abrirá la página .
-
En la opción Tipo, cámbialo a GitHub y pon un nombre para el conector.
-
Opcionalmente, Habilitar y proporcionar .
-
Opcionalmente Seleccionar y proporcionar una .
-
Si es necesario, Seleccionar para mostrar la URL de la aplicación de GitHub de Phrase e importar/exportar archivos usando el flujo de autorización de la aplicación de GitHub:
-
Haga clic en el enlace para abrir la página oficial del conector de 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.).
-
Instalar la aplicación de GitHub de Phrase en la cuenta de GitHub meta.
Nota
Si la aplicación de GitHub no está instalada en la cuenta de GitHub meta del usuario, solo los repositorios públicos serán visibles para el conector de GitHub.
-
Completar el procedimiento de instalación seleccionando cualquier repositorio privado que será visible y accesible para el conector de GitHub.
-
Regresar a la página de Phrase para autorizar la aplicación de GitHub y conectarse a GitHub.
-
-
Hacer clic en Conectar a GitHub. Si no se conecta usando la aplicación de GitHub, aparecerá una ventana emergente o una nueva pestaña solicitando autorización.
-
Proporcionar un si es necesario.
-
Hacer clic en el botón Autorizar Phrase.
Si usa la aplicación de GitHub, hacer clic en el botón Autorizar conector de Phrase App.
Si se realiza correctamente, la ventana/pestaña desaparecerá y aparecerá una pequeña marca de verificación junto al botón Conectar a 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.