SVNFrontend

RDlab@lsi.upc.edu
Febrero 2011

castellano Bienvenidos a LSI.

1. La aplicación de administración

El RDlab ofrece a los usuarios que dispongan de un repositorio subversión la posibilidad de usar una interfaz de administración para gestionar el acceso a sus repositorios, así como para cambiar la contraseña de su usuario Subversion.

Además, permite especificar, para cada usuario con acceso a un repositorio, una dirección de correo para que el hook post-commit les envíe un aviso cada vez que se produzca un cambio en los datos del repositorio.

Para más información sobre cómo obtener acceso al servicio de repositorios Subversion, visite el siguiente enlace: http://rdlab.lsi.upc.edu/index.php/es/servicios/documentacion.html

2. Acceso a la aplicación

Una vez dispongamos de un usuario y de una clave de acceso al repositorio, podemos acceder a la aplicación mediante la siguiente dirección: http://svn-rdlab.lsi.upc.edu/svnfrontend/

El sistema nos pedirá nuestro usuario y contraseña:

IMPORTANTE: La clave de acceso puede no coincidir con la clave de acceso al resto de servicios del LSI.

Una vez entrados los datos, accederemos a la aplicación y podremos escoger entre las distintas opciones:

2.1 Cambio de la contraseña

El formulario superior, Canvi de contrasenya, permite cambiar nuestra clave de acceso a los repositorios. Es importante tener en cuenta que si cambiamos la contraseña, la sesión que tengamos activa en nuestro navegador nos pedirá la nueva clave.

2.2 Acceso al editor

Mediante el formulario inferior, Administració de repositoris, podremos seleccionar uno de los repositorios de los cuales somos administradores y acceder a la aplicación que nos permitirá editar sus permisos de acceso.

3. Editor de permisos

El editor de permisos nos permite especificar qué usuarios tienen acceso al repositorio, ya sea en la raíz o en subcarpetas concretas.

3.1 Vista en modo texto

La vista en modo texto permite editar los permisos como si de la edición de un archivo de texto se tratara.

Para especificar los permisos se debe usar la siguiente sintaxis:

[Repositori:/Carpeta]
Usuario = permiso

Donde Repositorio es el nombre de nuestro repositorio, Carpeta es el camino (path) desde la raíz hasta la subcarpeta de la cual queremos especificar un permiso, Usuario es el nombre de usuario de quien queremos dar – o denegar – permiso, y Permiso es lectura (r), lectura/escritura (wr) o denegar (vacío).

Para guardar los permisos, usaremos el botón Guardar.

AVISO:El sistema validará que los usuarios pertenezcan a la lista de usuarios de Subversion. Si no es así, no permitirá guardar la lista de permisos.

Por otro lado, también hay que tener en cuenta que los permisos son hereditarios desde la raíz hacia las subcarpetas. Dar o denegar accesos a un directorio da o deniega acceso a todos los subdirectorios.

Esto permite diversas vías para especificar los mismos permisos de acceso. A continuación se mostrará un ejemplo con la mínima forma para un caso concreto, de modo que no haya redundancia de permisos.

3.1.1 Ejemplo de uso del editor de permisos

Supongamos un repositorio, de nombre rdlab, que contiene tres carpetas (proyectos), de nombre Projecte1, Projecte2 y Projecte3. Tenemos también a cuatro usuarios: Supervisor, Programador1, Programador2 y Ajudant.

Queremos que Supervisor tenga acceso total a todo el repositorio. Programador1 ha de poder ver la raíz y leer todos los proyectos, pero sólo modificar (escribir) el Proyecto1. Programador2 también puede ver la raíz y el contenido de los proyectos, pero no puede escribir en ninguno y no puede acceder a Projecte2. Ajudant no puede acceder a la raíz pero puede escribir en Proyecto3.

Especificaríamos los permisos de la siguiente manera, intentando hacerlo de forma mínima mediante la herencia de permisos.

En un primer fragmento especificamos que los tres usuarios pueden acceder a la raíz y, si no se especifica lo contrario, estos permisos serán heredados por las subcarpetas.

[rdlab:/]
Supervisor = wr
Programador1 = r
Programador2 = r

A continuación especificamos que Programador1 puede escribir en Projecte1. Se hereda que también lo pueda hacer el Supervisor y que el programador2 pueda leer, y por lo tanto no es necesario volverlo a especificar.

[rdlab:/Projecte1]
Programador1 = wr

Por lo que respeta a Projecte2, sólo puede escribir Supervisor, lo puede leer Programador1 y no puede acceder Programador2. No es necesario especificar permiso alguno para los dos primeros porque este permiso de hereda desde la raíz, pero sí es necesario indicar específicamente que Programador2 no puede acceder (permiso “vacío”).

[rdlab:/Projecte2]
Programador2 =

Finalmente, permitimos que Ajudant pueda escribir en Projecte3. Por herencia desde la raíz, los otros usuarios podrán leer (Programadores) o escribir (Supervisor).

[rdlab:/Projecte3]
Ajudant = wr

La seguiente figura muestra cómo se vería todo junto en el editor:

3.2 Vista en Árbol

Alternativamente al modo textual, el sistema permite editar los permisos en modo gráfico, al que se accede presionando sobre Vista en Arbre.

Pasando el ratón sobre el path del repositorio se nos mostrarán 3 opciones:

3.3 Edición de direcciones de correo

El RDlab, de forma automática, permite que Subversion envíe un correo a todos los usuarios con acceso al repositorio cada vez que algún usuario realiza un cambio (lo que se conoce como un commit).

Para que esto sea posible, se debe indicar al sistema, por cada usuario que queramos que reciba un correo, una dirección donde recibir dicho correo. Asimismo, si no queremos que un usuario reciba los correos, es suficiente con dejar el campo en blanco.

3.3.1 Especificar direcciones de correo

Para acceder al formulario de edición de direcciones de correo, haremos clic en Editar correus.

Los usuarios que aquí aparecen son los que hayamos especificado en la vistas Mode Text y/o Vista en Arbre, de modo que primero hemos de rellenar esas vistas si queremos disponer de un usuario en este formulario.

Para guardar los cambios, haremos clic en Guardar. Este paso también guardará los cambios realizados en los permisos.

4. Agradecimientos

El RDlab agradece al Laboratori de Càlcul de la FIB (lcfib) su colaboración en el desarrollo de la aplicación cediendo el código del editor de permisos al RDlab.