Wiki

• FrontPage
• RecentChanges
• FindPage
• HelpContents
• GitWeb

GitWeb (Alojamiento simple para Git)

Disponible desde versión: 19.19

GitWeb proporciona alojamiento Git en FreedomBox. Proporciona un interfaz web para realizar acciones comunes sobre repositorios Git como ver archivos, diferencias, descripciones de cambio, etc. Git es un sistema de control de versiones distribuído para trazar cambios en código fuente durante el desarrollo de software. Con GitWeb puedes hojear la historia y el contenido del código fuente, y usar la búsqueda para encontrar cambios y código específicos. También puedes clonar repositorios y subir cambios al código con un cliente Git de línea de órdenes o con múltiples clientes gráficos que hay disponibles. Y puedes compartir tu código con gente de todo el mundo.

Para aprender a usar Git visita su tutorial.

1. Administrar los repositorios

Tras instalar GitWeb se puede crear un nuevo repositorio. Se puede marcar como privado para limitar el acceso.

2. Acceso

Tras instalar GitWeb se puede acceder a GitWeb mediante el cliente web (p.ej) en https://<mi_freedombox>/gitweb.

3. Autenticación básica HTTP

Actualmente el GitWeb de FreedomBox solo soporta remotos HTTP(S) (no SSH). Para evitar tener que introducir la contraseña cada vez que haces pull/push al repositorio puedes editar tu remoto para incluír credenciales.

Ejemplo: https://usuario:contrasena@mi.freedombox.mola/gitweb/mirepo

Tu nombre de usuario y contraseña se cifrarán. Quien monitorize el tráfico de la red solo apreciará el nombre de dominio.
Nota: Al usar este método tu contraseña se almacenará en claro en el fichero .git/config del repositorio local. Por este motivo debes crear un usuario FreedomBox que solo tenga acceso a gitweb y no usar nunca una cuenta de administrador.

Para usuarios de GNOME (Avanzado) La utilidad "Contraseñas y claves" de GNOME se puede emplear para almacenar el usuario y su contraseña. Más detalles de cómo hacerlo en esta respuesta en StackOverflow.

4. Réplicas espejo

Aunque tus repositorios se albergan principalmente en tu propia FreedomBox puedes configurar un repositorio en otro servicio de alojamiento Git como GitLab a modo de copia espejo.

5. (Des)habilitar funciones

Algunas funciones que en gitweb vienen de serie se han cambiado en FreedomBox:

• Habilitada: Funcionalidad blame para mostrar qué quién y en qué revisión modificó cada línea de un fichero.

• Habilitada: Funcionalidad pickaxe para listar los commits que introdujeron o eliminaron una cadena de texto dada.

• Habilitada: Funcionalidad de resaltado de sintaxis para los blobs.
• Deshabilitada: Funcionalidad de instantánea que descarga un fichero comprimido tar con una revisión dada (por su alto consumo de recursos).

Un administrador puede ajustar estas selecciones editando el fichero de configuration de git de cada repositorio en FreedomBox. Más detalles de sintaxis y funciones en la página man de gitweb.conf(5). Por ejemplo, para rehabilitar las instantánes en el repositorio mirepo, ingresa como administrador al terminal de FreedomBox por SSH o consola web y edita el fichero /var/lib/git/mirepo/config para que contenga la sección siguiente:

• [gitweb]
  snapshot = tgz

6. Enlaces externos

• Sitio web: https://git-scm.com

• Documentación de uso: https://git-scm.com/docs/gitweb

• Wiki de Debian: https://wiki.debian.org/CategoryGit

Volver a la descripción de Funcionalidades o a las páginas del manual.

CategoryFreedomBox