Saltar al contenido

GitLab CI

Solo por invitación

Tuist Runners está disponible solo por invitación. Ponte en contacto o escríbenos en el Slack de la comunidad para solicitar acceso a tu cuenta.

Tus pipelines permanecen en GitLab. Tuist proporciona una máquina Linux o macOS aislada para cada trabajo e informa de sus registros y resultados a GitLab y al panel de control de Tuist. Se requiere GitLab 19.3 o superior. Se admiten GitLab.com e instancias autoalojadas accesibles a través de HTTPS público.

  1. Crea un runner de GitLab. En la sección Ajustes → CI/CD → Runners de tu proyecto, crea un runner de proyecto. También puedes usar un runner de grupo. Añade todas las etiquetas de perfil de Tuist que quieras utilizar como etiquetas del runner, por ejemplo tuist-linux y tuist-macos, y desactiva Ejecutar trabajos sin etiquetar. Conserva el token de autenticación que muestra GitLab, que comienza por glrt-. No necesitas instalar un runner en tu propia máquina.

  2. Conecta una vez en Tuist. En Ajustes → Integraciones, selecciona Conectar en la tarjeta de GitLab CI. Introduce tu URL de GitLab y el token de autenticación del runner. La conexión puede atender trabajos que usen distintos perfiles. Los tokens se almacenan cifrados y no vuelven a mostrarse. Opcionalmente, añade un token de acceso a la API para que los pipelines de merge request puedan guardar volúmenes de caché; consulta Pipelines de merge request.

  3. Elige la máquina en cada trabajo. Establece exactamente una etiqueta de perfil de Tuist en las tags del trabajo. Se permiten otras etiquetas, siempre que el runner de GitLab registrado también las tenga:

    yaml
    # .gitlab-ci.yml
    linux-check:
    tags: [tuist-linux]
    script:
    - uname -a
    test:
    tags: [tuist-macos]
    script:
    - tuist test
    retry:
    max: 2
    when: runner_system_failure
  4. Haz push y observa. Tuist comienza a sondear en menos de un minuto. Los trabajos aparecen bajo Runners, con un enlace al trabajo de GitLab, sus registros y las métricas de la máquina. GitLab recibe los registros mientras el trabajo se ejecuta; Tuist recibe el registro enmascarado cuando finaliza.

Tuist lee CI_JOB_TAGS de cada asignación y resuelve el perfil dentro de la cuenta de Tuist conectada. No infiere la máquina a partir de CI_RUNNER_TAGS ni utiliza un perfil predeterminado. Si faltan etiquetas de perfil de Tuist, son desconocidas o hay varias, el trabajo adquirido falla con una explicación en su registro de GitLab. No sobrescribas CI_JOB_TAGS en las variables de tu pipeline.

Entorno de ejecución#

Los trabajos utilizan el ejecutor de shell de GitLab dentro de una máquina aislada. El checkout, las variables de CI, before_script, script, after_script, los artefactos y la cancelación los gestiona GitLab Runner. Las configuraciones image: y services: del pipeline no configuran este entorno de shell; usa las herramientas instaladas en la imagen del runner o instálalas en tu script.

El token de autenticación reutilizable del runner permanece en el servidor de Tuist. Las máquinas reciben credenciales solo para el trabajo que se les ha asignado. Actualmente, los permisos de firma de caché están retenidos para los trabajos de GitLab. Los volúmenes de caché personalizados de Linux verifican la identidad del trabajo y el permiso de guardado a través de la API de GitLab; las variables de CI anulables no establecen confianza.

GitLab marca un trabajo como en ejecución y comienza su tiempo de espera tan pronto como Tuist lo adquiere. Mientras los trabajos que Tuist ya ha adquirido consumen el límite de concurrencia de tu cuenta, los siguientes trabajos permanecen pendientes en GitLab. Un trabajo adquirido espera una máquina hasta su tiempo de espera máximo, como mucho 12 horas. Si ninguna máquina está disponible para entonces, Tuist hace fallar la asignación con runner_system_failure, y la política de reintentos anterior permite que GitLab lo reintente. La misma política cubre la pérdida de una máquina runner.

Rotación de tokens y desconexión#

Actualiza los tokens de la conexión y selecciona Guardar cambios para rotarlos. Dejar un token en blanco conserva la credencial existente.

Desconectar detiene la adquisición y hace fallar las asignaciones en espera. Los trabajos en ejecución continúan con sus propias credenciales. Si no se puede alcanzar GitLab, Tuist mantiene la conexión deshabilitada mientras reintenta la cancelación de las asignaciones en espera. La conexión se elimina una vez que esas asignaciones se han resuelto.

Volúmenes de caché#

Mantén las cachés de Xcode, de módulos y de Gradle, así como otros directorios, entre trabajos mediante volúmenes de caché. Añádelos después del checkout y antes de los comandos que los utilicen.

Pipelines de merge request#

Los pipelines de push, programados y web del proyecto guardan sus cambios en volúmenes de caché. Los pipelines de merge request utilizan la caché y guardan sus cambios solo cuando la conexión tiene un token de acceso a la API:

  1. En GitLab, crea un token de acceso de proyecto o de grupo con el rol Reporter y el ámbito read_api. Un token de grupo cubre todos los proyectos del grupo que se ejecutan en runners de Tuist.
  2. En Ajustes → Integraciones, pégalo en Token de acceso a la API en la tarjeta de GitLab CI y selecciona Guardar cambios.

Tuist lee entonces el merge request de cada pipeline de merge request. Los pipelines de merge requests abiertos desde una rama del propio proyecto guardan sus cambios bajo la rama origen del merge request, por lo que la configuración de ramas del perfil del runner se aplica a esa rama. Los merge requests desde forks nunca guardan. Si Tuist no puede leer el merge request, el trabajo se ejecuta y utiliza la caché, pero sus cambios se descartan.