10.8 Los entresijos internos de Git - Variables de entorno

Como programa de computadora que es, el comportamiento general de Git depende de variables de entorno.

GIT_EXEC_PATH determina el sitio donde Git busca sus subprogramas (como git-commit, git-diff, y otros). Puedes comprobar la configuración actual ejecutando git --exec-path.

HOME por regla general no se considera personalizable (demasiadas cosas dependen de él), pero es el sitio donde Git busca el archivo de configuración global. Si deseas una instalación de Git realmente portable, completa con configuración global, puedes sobreescribir HOME en el perfil de shell portable de Git.

PREFIX es parecido, pero para la configuración del sistema. Git busca este archivo en $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM, si está establecida, deshabilita el uso del archivo de configuración del sistema. Esto es útil si la configuración de tu sistema está interfiriendo con tus comandos, pero no tienes acceso para modificarlo o eliminarlo.

GIT_PAGER controla el programa usado para mostrar la salida de varias páginas en la línea de comandos. Si no está establecida, será usado PAGER por defecto.

GIT_EDITOR es el editor que Git lanzará cuando el usuario necesite editar un texto (un mensaje para confirmación de cambio, por ejemplo). Si no está establecida, será usado EDITOR.

Git utiliza varias variables de entorno para determinar la forma en que interactúa con el repositorio actual.

GIT_DIR es la ubicación del directorio .git. Si no se especifica, Git subirá por el árbol de directorios hasta llegar a ~ o /, en busca de un directorio .git en cada directorio visitado.

GIT_CEILING_DIRECTORIES controla el comportamiento de búsqueda del directorio .git. Si accedes a directorios que son lentos de cargar (tales como aquellos en un dispositivo de cinta magnética, o a través de una conexión de red lenta), es posible que desees que Git se detenga antes de lo establecido, especialmente si Git se invoca durante la construcción de tu indicador de shell.

GIT_WORK_TREE es la ubicación de la raíz del directorio de trabajo para un repositorio con contenido. Si no se especifica, se utiliza el directorio padre de $GIT_DIR.

GIT_INDEX_FILE es la ruta de acceso al archivo index (solo repositorios con contenido).

GIT_OBJECT_DIRECTORY puede utilizarse para especificar la ubicación del directorio que normalmente reside en .git/objects.

GIT_ALTERNATE_OBJECT_DIRECTORIES es una lista separada por dos puntos (formateada como /dir/one:/dir/two:…) que indica a Git dónde buscar objetos si no están en GIT_OBJECT_DIRECTORY. Si tienes muchos proyectos con archivos grandes que tienen exactamente el mismo contenido, puedes utilizar esto para evitar almacenar demasiadas copias de ellos.

Un 'pathspec' se refiere a la forma de especificar rutas de acceso a las cosas en Git, incluyendo el uso de comodines. Se utilizan en el archivo .gitignore, pero también en la línea de comandos (git add *.c).

GIT_GLOB_PATHSPECS y GIT_NOGLOB_PATHSPECS controlan el comportamiento por defecto de los comodines en las especificaciones de rutas de acceso. Si GIT_GLOB_PATHSPECS está establecida a 1, los caracteres de comodín actúan como comodines (lo cual es la situación por defecto); si GIT_NOGLOB_PATHSPECS está establecida a 1, los caracteres de comodín sólo coinciden consigo mismos, lo que significa que algo como \*.c solo coincidiría con un archivo llamado *.c, en lugar de cualquier archivo cuyo nombre acabe en .c. Puedes sobreescribir esto para casos individuales iniciando la especificación de ruta de acceso con :(glob) o :(literal), como en :(glob)*.c.

GIT_LITERAL_PATHSPECS deshabilita los dos comportamientos anteriores; los caracteres de comodín no funcionarán, y la sobreescritura de prefijos estará deshabilitada también.

GIT_ICASE_PATHSPECS establece todas las especificaciones de rutas de acceso para que funcionen de forma que no se diferencie entre mayúsculas y minúsculas (case-insensitive).

La creación final de un objeto de confirmación de cambios en Git se realiza generalmente con git-commit-tree, que utiliza estas variables de entorno como su fuente primera de información, utilizando los valores de la configuración sólo si éstas no están presentes.

GIT_AUTHOR_NAME es el nombre completo en el campo 'author'.

GIT_AUTHOR_EMAIL es el email para el campo 'author'.

GIT_AUTHOR_DATE es la fecha y hora utilizada para el campo 'author'.

GIT_COMMITTER_NAME establece el nombre completo para el campo 'committer'.

GIT_COMMITTER_EMAIL es la dirección de email para el campo 'committer'.

GIT_COMMITTER_DATE se utiliza para la fecha y hora en el campo 'committer'.

EMAIL es la dirección de email utilizada en caso de que el valor de configuración user.email no esté establecido. Si éste no está configurado, Git utilizará los nombres de usuario y equipo.

Git utiliza la biblioteca curl para realizar operaciones de red sobre HTTP, así que GIT_CURL_VERBOSE le indica a Git que emita todos los mensajes generados por esta biblioteca. Esto es similar a hacer curl -v en la línea de comandos.

GIT_SSL_NO_VERIFY indica a Git que no verifique los certificados SSL. Esto a veces puede ser necesario si estás utilizando un certificado autofirmado para servir un repositorio Git a través de HTTPS, o estás montando un servidor Git, pero todavía no has instalado un certificado completo.

Si la velocidad de datos de una operación de HTTP es menor de GIT_HTTP_LOW_SPEED_LIMIT bytes por segundo durante más de GIT_HTTP_LOW_SPEED_TIME segundos, Git abortará esa operación. Estos valores sobreescriben los valores de configuración http.lowSpeedLimit y http.lowSpeedTime.

GIT_HTTP_USER_AGENT establece el texto de agente de usuario utilizado por Git cuando se comunica sobre HTTP. El valor predeterminado es similar a git/2.0.0.

GIT_DIFF_OPTS es un nombre poco apropiado. Los únicos valores válidos son -u<n> o --unified=<n>, que controla el número de líneas de contexto mostradas en un comando git diff.

GIT_EXTERNAL_DIFF se utiliza como para sobreescribir el valor de configuración diff.external. Si está establecido, Git invocará este programa cuando se ejecute git diff.

GIT_DIFF_PATH_COUNTER y GIT_DIFF_PATH_TOTAL son útiles para el programa especificado en GIT_EXTERNAL_DIFF o diff.external. El primero representa el archivo de la serie (empezando en 1) que está siendo comparado, y el último es el número total de archivos en el lote.

GIT_MERGE_VERBOSITY controla la salida de la estrategia de fusión recursiva. Los valores permitidos son los siguientes:

El valor predeterminado es 2.

¿Quieres saber lo que hace realmente Git? Git tiene un conjunto bastante completo de trazas incorporadas, y todo lo que hay que hacer es activarlas. Los posibles valores de estas variables son los siguientes:

GIT_TRACE controla las trazas generales, que no se ajustan a una categoría específica. Esto incluye la expansión de alias, y la delegación a otros subprogramas.

GIT_TRACE_PACK_ACCESS controla el trazado de acceso a empaquetados (packfile). El primer campo es el archivo empaquetado que está siendo accedido, el segundo es el desplazamiento (offset) dentro del archivo:

GIT_TRACE_PACKET habilita el trazado a nivel de paquete para las operaciones de red.

GIT_TRACE_PERFORMANCE controla el registro de datos de rendimiento. La salida muestra cuánto dura cada invocación particular de git.

GIT_TRACE_SETUP muestra información que Git va descubriendo sobre el repositorio y el entorno con el que interactúa.

GIT_SSH, si se especifica, es un programa que se invoca en lugar de ssh cuando Git intenta conectar a un equipo SSH. Se invoca como $GIT_SSH [username@]host [-p <port>] <command>. Observa que esta no es la forma más fácil de personalizar como ssh es invocado; no soportará parámetros extra en la línea de comandos, de modo que tendrías que escribir un script envoltorio y hacer que GIT_SSH apunte a él. Es probablemente más fácil usar simplemente el archivo ~/.ssh/config para esto.

GIT_ASKPASS es una sobreescritura para el valor de configuración core.askpass. Este es el programa invocado cada vez que Git necesita pedir al usuario las credenciales, que puede mostrar un indicador similar a la línea de comandos, y debería devolver la respuesta en stdout. (Consulta Almacenamiento de credenciales para más detalles acerca de este subsistema.)

GIT_NAMESPACE controla el acceso a las referencias de un espacio de nombres, y es equivalente al indicador --namespace. Esto es principalmente útil en el lado servidor, donde puedes querer almacenar múltiples bifurcaciones (forks) de un único repositorio en un repositorio, solo manteniendo las referencias separadas.

GIT_FLUSH puede usarse para forzar a Git a usar Entrada/Salida sin buffer cuando escribe de forma incremental a la salida estándar (stdout) . Un valor de 1 hace que Git actualice más a menudo, un valor de 0 hace que toda la salida sea con buffer. El valor por defecto (si esta variable no está definida) es elegir un esquema de buffer adecuado en función de la actividad y el modo de salida.

GIT_REFLOG_ACTION te permite especificar el texto descriptivo escrito en el registro de referencias. Aquí tienes un ejemplo: