En esta página

Delimitar un repositorio y configurar herramientas Git

Los repositorios grandes, los archivos grandes y las distintas identidades de firma necesitan controles propios. Abre la acción correspondiente al repositorio activo, examina la vista previa y aplica el cambio que necesita tu tarea.

Delimitar un monorepo con sparse checkout

  1. Abre sparse checkout y selecciona los directorios necesarios. Filtrar la lista conserva la selección; elegir una carpeta superior hace redundantes las selecciones de sus carpetas descendientes.
  2. Comprueba el número de archivos visibles. El modo cone conserva los directorios elegidos, los archivos de la raíz y los archivos directamente en sus directorios superiores.
  3. Elige sparse index solo si tus demás herramientas Git son compatibles. Puede reducir el índice; no garantiza builds más rápidos ni instala dependencias del proyecto.
  4. Aplica la selección revisada. Las ediciones pendientes, los archivos ignorados u otra operación Git pueden bloquear el cambio. Resuelve el estado indicado y genera una nueva vista previa si el repositorio cambió.
  5. Usa la acción para restaurar el árbol completo cuando necesites todos los archivos con seguimiento de nuevo.

Esto cambia qué archivos con seguimiento están presentes en el árbol de trabajo, sin cambiar el historial completo. No realiza un partial clone. Las configuraciones non-cone existentes pueden desactivarse, pero el selector no las edita. Los límites actuales son 250.000 archivos, 20.000 directorios y 1.000 directorios seleccionados; se informa del exceso sin truncar silenciosamente la selección.

Gestionar archivos grandes con Git LFS

Abre el panel de extensiones del repositorio para inspeccionar Git LFS, sus archivos, la disponibilidad de objetos y las reglas del .gitattributes de la raíz. Las acciones requieren Git LFS 3.8.1 o posterior instalado en el equipo.

  1. Instala la configuración LFS en este repositorio si hace falta. Configura el repositorio, sin instalar el ejecutable Git LFS. Las rutas de hooks compartidas o inseguras pueden impedir la acción; no se sustituyen los hooks existentes a la fuerza.
  2. Añade o quita un patrón de seguimiento y confirma. Revisa el cambio en .gitattributes e inclúyelo en un commit cuando corresponda.
  3. Selecciona un remoto para obtener los objetos LFS de HEAD. Después, materializa los objetos disponibles en los archivos de trabajo cuando sea necesario.

El panel muestra hasta 2.000 archivos e indica la cobertura parcial. No edita todos los archivos de atributos anidados, migra el historial existente a LFS, purga objetos ni los sube automáticamente. Seguir un patrón no convierte los commits anteriores.

Actualizar un submódulo con un destino concreto

En el mismo panel, selecciona un submódulo y compara su commit actual con el registrado en el índice del repositorio padre. Revisa la inicialización y los cambios pendientes antes de actualizar.

La actualización inicializa cuando es necesario, obtiene los datos y hace checkout del commit registrado en detached HEAD. No avanza hasta el último commit de la rama remota, cambia el commit registrado en el padre ni actualiza recursivamente los submódulos anidados. Se rechazan rutas modificadas o inseguras y operaciones en curso. Abre el submódulo como un contexto propio de Riff para trabajar en él.

Una descarga cancelada puede dejar objetos descargados o un submódulo parcialmente inicializado. Lee el estado actualizado antes de reintentar; cancelar no significa que se hayan deshecho todos los pasos anteriores.

Aplicar un perfil de identidad o firma

  1. Abre la identidad del repositorio y comprueba el autor efectivo, el origen de la configuración y la política de la organización. Elige la identidad Git, la cuenta Gapfy cuando esté disponible o el comportamiento predeterminado permitido por la política.
  2. Guarda un perfil con nombre para reutilizarlo. Guardarlo o cargarlo no modifica el repositorio; revisa y confirma Aplicar por separado.
  3. Elige firma heredada, OpenPGP o SSH según necesites. Proporciona un identificador de clave o una referencia a una clave pública SSH. Riff no importa ni almacena claves privadas de firma. Desactivar la firma exige una elección explícita.
  4. Comprueba el ámbito de destino. Si está habilitada la configuración específica del worktree, Aplicar cambia ese worktree; en caso contrario, cambia la configuración compartida del repositorio. No reescribe la configuración global ni los archivos incluidos.
  5. Inspecciona la firma de HEAD. El resultado distingue ausencia de commit, commit sin firma, firma válida y no verificada, sin crear un commit de prueba.

La política de identidad de la organización prevalece sobre el perfil. La verificación en el equipo no demuestra que el próximo commit pueda firmarse ni que un host remoto confíe en la firma. Configura por separado la herramienta, el agente y la confianza según las exigencias de la organización.

Para ramas dependientes, usa stacks y publicación coordinada. Para tareas independientes, usa contextos de trabajo y worktrees.