Consejo
Para obtener información sobre la integración de GitHub en Phrase TMS, consulta GitHub (TMS).
Phrase Strings se integra con repositorios de GitHub para sincronizar archivos de localización entre Phrase y GitHub.
De forma predeterminada, los repositorios se conectan mediante una aplicación OAuth de GitHub. También se admiten tokens de acceso personal, destinados principalmente a instancias autohospedadas o entornos donde no es posible la instalación de una aplicación OAuth.
Requisitos previos
-
El archivo
.phrase.ymlde configuración debe estar presente en la raíz de la rama que se va a supervisar. El archivo define qué importar (pull) o exportar (push) del repositorio. -
Requiere un acceso de lectura y escritura para el repositorio.
-
Los archivos de configuración definidos incorrectamente pueden causar errores. Comprueba que el archivo contiene al menos un meta para importar y otro para exportar, que los formatos de archivo sean correctos y que la configuración del parámetro
update_translationsesté bien. -
-
La aplicación OAuth de GitHub debe estar instalada en la organización o cuenta de GitHub propietaria del repositorio.
-
El repositorio debe estar incluido en la instalación de la aplicación OAuth.
-
Se requieren permisos para instalar o autorizar aplicaciones de GitHub en la organización o cuenta de destino.
-
Permite conectar una cuenta de Strings a varias organizaciones de GitHub. Selecciona qué organización de GitHub se sincroniza en la configuración de la integración. No existe un límite estricto en el número de organizaciones que se pueden conectar.
-
-
-
Tokens clásicos
Requiere el ámbito repo (
public_reposi se sincroniza con un repositorio público) -
Tokens detallados
Requiere los siguientes permisos:
-
Contenido: Lectura y escritura
-
Solicitudes de extracción: Lectura y escritura
-
-
Asegúrate de que la configuración del repositorio no necesite firmar compromisos.
-
-
Si se ha habilitado el SSO en GitHub, también debe estar habilitado para el token de acceso.
-
No se puede proteger la rama phrase_translations.
Nota
Debido a las continuas mejoras, es posible que la interfaz de usuario no sea exactamente la misma que se presenta en el vídeo.
Una vez que el archivo de configuración esté en su lugar, para conectar un repositorio, sigue estos pasos:
-
En la navegación principal, haz clic en Automatizaciones, luego en Sincronizaciones de repositorios.
Alternativamente, desde la página de , desplázate hacia abajo hasta y haz clic en Configurar.
Se abre la página de . La lista de muestra solo los proyectos a los que el usuario que visualiza tiene acceso.
-
Haz clic en Añadir sincronización/GitHub.
Se abre la ventana de configuración de .
-
Selecciona un proyecto de la lista desplegable.
-
Selecciona el método de autenticación:
-
App de GitHub (recomendado)
Si la aplicación de GitHub aún no está instalada, haz clic en Autenticar. La autenticación se realiza una vez y puede reutilizarse para múltiples sincronizaciones de repositorios.
Si la aplicación de GitHub ya está instalada, haz clic en Gestionar instalación para completar la instalación de la aplicación para la organización o cuenta de destino. El acceso al repositorio se gestiona a nivel de organización o cuenta y no está vinculado a un usuario individual de GitHub.
-
Proporciona un personal con un ámbito de API.
Al utilizar un token de acceso personal, el acceso al repositorio depende del usuario de GitHub que creó el token.
-
Proporciona el de GitHub autohospedado y un personal con un ámbito de API.
Si el repositorio de destino requiere confirmaciones (commits) verificadas (firmadas), utiliza el método de autenticación de la aplicación de GitHub. Las confirmaciones enviadas mediante un token de acceso personal no están firmadas, por lo que la sincronización falla con el siguiente error: "El repositorio requiere confirmaciones (commits) verificadas (firmadas)."
-
-
Si se utiliza la aplicación de GitHub, selecciona de la lista desplegable. La lista de repositorios se carga según esa selección.
-
Selecciona un de la lista desplegable.
-
Selecciona una de la lista desplegable desde la cual importar (push) y exportar (pull). Por lo general, esta es la rama principal (master).
-
Opcionalmente, proporciona un nombre de rama para la solicitud de extracción. Si lo dejas vacío, se creará una rama con el valor predeterminado .
-
Opcionalmente, proporciona un personalizado para la solicitud de extracción, de hasta 72 caracteres.
Si dejas el campo vacío, se mantiene el mensaje predeterminado, Traducciones actualizadas desde Phrase. Una vez establecido, el título personalizado reemplaza el mensaje de confirmación predeterminado y el título de la solicitud de extracción en cada exportación.
-
Haz clic en Validar configuración para asegurarte de que la configuración de autenticación y el archivo de configuración sean correctos.
-
Opcionalmente, selecciona una opción de para determinar cuándo se importan automáticamente archivos nuevos o actualizados en el proyecto.
-
Haz clic en Guardar.
El proyecto ya está conectado al repositorio de GitHub seleccionado y agregado a la lista.
-
(Opcional) Haz clic en el icono de lápiz para cambiar el nombre de la integración.
La aplicación de GitHub de Phrase no admite actualmente la inclusión en la lista de direcciones IP permitidas. Si una organización de GitHub tiene habilitada una lista de direcciones IP permitidas con la configuración "Habilitar la configuración de lista de direcciones IP permitidas para aplicaciones de GitHub instaladas" activada, GitHub bloquea la aplicación de GitHub de Phrase, lo que resulta en una lista desplegable de repositorios vacía y exportaciones fallidas. Como solución alternativa, agrega las direcciones IP de salida de Phrase a la lista de direcciones IP permitidas de la organización. Consulta el artículo Direcciones IP de los servidores de Phrase para obtener la lista actual de direcciones que se deben incluir en la lista de direcciones IP permitidas.
Asegúrate de que los comandos de push estén configurados correctamente dentro del archivo .phrase.yml de configuración. Las opciones de push son las mismas que para el endpoint de la API de subidas.
Para importar archivos:
-
Desde la página , seleccione un proyecto y haga clic en Importar
.
Los archivos de idioma (definidos como entradas de origen de envío en el archivo de configuración) se importan al proyecto.
Debe haber una configuración regional predeterminada.
Nota
En caso de problemas durante la importación, usa el cliente CLI para probar el archivo de configuración
.phrase.ymllocalmente y comprobar si hay mensajes de error.Si es necesario, ponte en contacto con el soporte técnico de Phrase y adjunta el archivo de configuración
.phrase.ymla la solicitud de soporte.
Asegúrate de que los comandos de pull estén configurados correctamente dentro del archivo .phrase.yml de configuración. Las opciones de pull (p. ej., el parámetro include_empty_translations) son las mismas que para el endpoint de la API de descarga de locales.
Para exportar archivos:
-
Desde la página , selecciona un proyecto y haz clic en Exportar
.
Se muestra la ventana .
-
Proporciona la rama de destino en el campo .
Los archivos más recientes del repositorio se exportarán como un nuevo pull request a la rama deseada.
-
Una vez exportados los archivos, el pull request puede fusionarse o cerrarse en el repositorio y la rama puede eliminarse.
Nota
En caso de problemas durante la exportación, usa el cliente CLI para probar el archivo de configuración .phrase.yml localmente y comprobar si hay mensajes de error.
Si es necesario, ponte en contacto con el soporte técnico de Phrase y adjunta el archivo de configuración .phrase.yml a la solicitud de soporte.
Historial
Las sincronizaciones de repositorio mantienen un historial de las últimas importaciones y exportaciones para cada proyecto de Phrase Strings.
Para ver el historial: