20081113 - inducción a microsoft visual sourcesafe 2005 (public)

Inducción a Microsoft Visual SourceSafe 2005Tito Peralta Benítez - 2010

Contenido• ¿Qué es Microsoft Visual SourceSafe?• ¿Cómo funciona Visual SourceSafe?• Administración de repositorios• Administración de usuarios• Administración de repositorios• Integración con Visual Studio 2005 y 2008

Microsoft Visual SourceSafe 2005

• Software para administrar cambios en el código fuente de una aplicación o sistema.• El código fuente es texto plano.

• Consta de dos utilerías.• Visual SourceSafe Explorer.• Visual SourceSafe Administrator.

• La información se almacena en un repositorio.

Cómo Funciona

Repositorios – Creación• Abrir Visual SourceSafe Administrator• Acceder al menú File > New Database…

• Debe de estar en una carpeta compartida (En nuestro caso la carpeta debe estar en \\fileservercolom\sourcesafe\sourcesafe\.

• Requiere de privilegios de lectura y escritura.

Repositorios – Creación (2)• Se ejecutará el siguiente asistente:• Hacemos click en “Next >”

Repositorios – Creación (3)• Escribimos la ruta de la nueva base de datos, Hacemos click en

“Next >”

Repositorios – Creación (4)• Escribimos el nombre de la base de datos, hacemos click en

“Next >”

Repositorios - Creación (5)• Seleccionamos el modelo de control del código. Se

recomienda usar el modelo Lock-Modifi-Unlock, hacemos click en “Next >”

Repositorios - Creación (6)• Hacemos click en “Finish”

Abrir repositorio• Abrimos la base de datos haciendo click en el menu File >

Open Source Database

Abrir repositorio (2)• Si la base de datos está presente en la lista, la seleccionamos y

hacemos click en “Open”

Abrir repositorio (3)• En caso de que no se encuentre en la lista, hacemos click en

“Add”, se ejecutará un asistente.

Abrir repositorio (4)• Seleccionamos “Connect to existing database”, hacemos click

en “Next >”

Abrir repositorio (5)• Escribimos la ruta de la base de datos.• hacemos click en “Next >”

Abrir repositorio (6)• Escribimos el nombre de la base de datos• Hacemos click en “Next >”

Abrir repositorio (7)• Hacemos click en “Finish”

Crear copia local de un repositorio• Las copias locales de los

repositorios se mantienen sincronizadas con las versiones del servidor.

• Para descargarla primero debemos configurar el directorio de trabajo (Working folder); para ello, seleccionamos la raíz de la base de datos en Visual SourceSafe y hacemos click con el botón secundario del mouse y en el menú contextual seleccionamos “Set working folder”.

Crear copia local de un repositorio (2)

• Al seleccionar la opción “Set Working folder”, aparecerá una ventana donde debemos buscar la carpeta en la que vamos a almacenar el código:

Crear copia local de un repositorio (3)

• Una vez seleccionada la carpeta, hacemos click con el botón secundario sobre la raíz de la base de datos y seleccionamos en el menú contextual la opción “Get latest versión”

Crear copia local de un repositorio (4)• Entonces, aparecerá una ventana que nos muestra la ruta del

directorio de trabajo y unas opciones. En esta ventana marcamos la opciones “Recursive” y “Build tree”, y oprimimos OK.

Gestión de usuarios• Abrimos Microsoft Sourcesafe Administrator• Abrimos un repositorio• En la ventana principal encontramos los usuarios del repositorio, los permisos y si están trabajando

actualmente sobre el repositorio:

Editar usuario• Seleccione uno de los usuarios de la grilla y luego haga click en

“Users > Edit User”• Puede cambiar el nombre de usuario y los privilegios de acceso

al código fuente.• Si desea cambiar la contraseña, haga click en el menú “Users >

Change Password”.

Crear usuario• Haga click en el menu “Users > Add User”• En “User name” escriba el nombre de login del usuario.• En “SourceSafe password” escriba la contraseña.• Si quiere que el usuario tenga acceso de solo lectura al repositorio

active la casilla “Read only”• Si desea inscribir un usuario del dominio de windows, solo escriba el

nombre del usuario sin la contraseña.

Eliminar usuario• Seleccione un usuario de la grilla• Haga click en “Users > Delete user”• En el mensaje de confirmación, haga click en “Yes”

Mantenimiento de repositorios• Se realiza mediante la herramienta “Microsoft Visual

SourceSafe”, en donde podemos administrar:• Consolidar ó deshacer las protecciones pendientes (Get, Checkin,

Checkout y Undo Checkout)• Obtener la ultima versión (Get last version)• Historial• Diferencias

Abrir repositorio• Para abrir un repositorio se realiza el mismo procedimiento

descrito para la gestión de repositorios.

Agregar archivos• Seleccionamos un directorio en la lista de arbol del panel

izquierdo y hacemos click en “File > Add files”, seleccionamos los archivos y hacemos click en “Open”

Eliminar archivos• Seleccionamos el directorio en árbol del panel izquierdo.• En el panel derecho seleccionamos los archivos que deseamos

eliminar• Confirmamos la eliminación y si será de forma permanente

(incluyendo la copia local)

Editar archivos• Hay que tener en cuenta que el usuario tenga los privilegios

lectura y escritura en el repositorio

Editar archivos (2)• Para editarlo debemos indicarle un directorio de trabajo si no

tenemos ya uno configurado. El directorio de trabajo es una carpeta en donde se almacenarán las copias locales de Visual SourceSafe.

Editar archivos (3)• En el momento de editar el archivo el sistema solicitará el

editor que usaremos y el modo en el que abriremos el archivo, como copia local ó Bloquear el archivo en el servidor y editarlo (checkout)

Editar archivos (4)• El proceso de checkout crea y actualiza una copia local de los

archivos en un directorio local.

Editar archivos (4)• Una vez editado el archivo, habiendo elegido el bloqueo del archivo,

vemos que aparece el icono en color rojo como se muestra en la pantalla:

Editar archivos (5)• El icono rojo indica que el archivo está bloqueado y que el

usuario que aparece en la fila lo está editando.• Una vez finalizadas las modificaciones, se debe hacer

“checkin” a todos los archivos modificados:

Editar archivos (5)• La acción “checkin” o proteger, sube los cambios en el servidor

y desbloquea el archivo.

Editar archivo (6)• En caso de que hallamos tenido problemas y nos toque

recuperar el archivo original, hacemos un “Undo checkout”; esta operación recupera la última versión del código.

Historial de cambios de un archivo

• Visual SourceSafe genera respaldos cada vez que hacemos cambios sobre los archivos y los clasifica por versiones.

• También puede mostrarnos las diferencias entre una versión y la otra:• Para ver el historial, seleccionamos el archivo y hacemos click en “Tools >

Show History”

Historial de cambios de un archivo (2)

• Luego de acceder desde el menú al historial, Nos aparecerá la siguiente ventana:

● Si queremos ver todo el historial dejamos tal cual y oprimimos “OK”

● Podemos filtrar con la fecha de inicio (From), Fecha final (To) y usuario.

Historial de cambios de un archivo (3)• Luego de oprimir “Ok” sobre la ventana anterior, aparecerá la

siguiente ventana, en donde nos indica la versión, el usuario, la fecha y la acción sobre el archivo:

Historial de cambios de un archivo (4)• En la ventana de historial encontraremos varios comandos:• Close: Cierra la ventana.• View: Ver el contenido de la versión seleccionada del archivo.• Details: En esta ventana podemos ver o configurar la etiqueta y

descripción de la versión del archivo.• Get: Reemplaza la copia local del archivo por la versión

seleccionada.• Differences: Compara el archivo local con la versión seleccionada y

muestra las diferencias en pantalla.• Pin: Fija la versión de un archivo y no permite su eliminación

aunque se haga rollback.• Rollback: Deshace los cambios del código a la versión especificada y

elimina las versiones posteriores que no estén fijadas.• Report: Imprime un reporte de los detalles y cambios de un archivo.• Help: muestra la ayuda de Visual SourceSafe.

Integración con Visual Studio• Visual SourceSafe solo está soportado hasta la versión 2008 de

Visual Studio y SQL Management Studio.• Integra todas las funciones de gestión de archivos (Get, Get

latest version, Checkout, Checkin, Compare, View History, etc.)• Muestra las protecciones pendientes.• Permite subir las soluciones locales al control de código fuente

desde Visual Studio.• Se integra de manera automaticamente al Visual Studio, al

instalar el paquete de Visual Source Safe.

Integración con Visual Studio – Añadir al control de código fuente• Debemos tener instalado Visual Source Safe.• Abrimos Visual Studio ó Sql Server Management Studio y

cargamos la solución. Vamos al menu Archivo > Control de Codigo Fuente > Agregar proyecto al control de código fuente

Integración con Visual Studio – Añadir al control de código fuente (2)• Aparecerá una ventana para conectarnos a una base de datos

existente, escribimos usuario y contraseña si deseamos agregar el código a la base de datos actual (La cual se muestra en el campo Database), en caso contrario hacemos click en el botón “Browse”

Integración con Visual Studio – Añadir al control de código fuente (3)• Si oprimimos el botón “Browse”, Seleccionamos la base de

datos en donde deseamos agregar el código. Lo recomendable es crear una base de datos por cada solución (Para lo cual, hacemos click en Add y seguimos los pasos del apartado de la creación de repositorios)

Integración con Visual Studio – Gestión de archivos• Una vez tengamos nuestra solución en el control de código

fuente, Visual Studio mostrará un icono a la izquierda de cada archivo de la solución:

Integración con Visual Studio – Gestión de archivos (2)

• El icono indica el estado del archivo:

Indica que esta siendo editado y que está bloqueado para los

demás usuarios

Indica que el archivo esta disponible para ser editado. Este es el

estado ideal.

Indica que el archivo esta bloqueado por otro usuario

Integración con Visual Studio – Gestión de archivos (3)

• Las operaciones de control de código fuente estarán disponibles en el menú contextual de cada archivo, en el explorador de soluciones y funcionan de la misma forma que se explicó en los puntos anteriores.

Integración con Visual Studio - Abrir un código existente en el control de código fuente

• Para descargar una solución para manipularla desde Visual Studio y que se encuentra en el control de versiones, primero descargamos una copia local mediante Visual Source Safe utilizando el procedimiento mencionado en el apartado “Crear copia local de un repositorio”.

• Luego, abrimos la copia en el disco, la cual se sincronizará con el servidor cada vez que realicemos una modificación.

Integración con Visual Studio - Protecciones pendientes

• Cuando instalamos Visual Source Safe, en visual studio tenemos una barra en la que podremos gestionar las protecciones pendientes (pending checkins), la cual se habilita seleccionando en el menú la opción Ver > Protecciones pendientes

Integración con Visual Studio - Protecciones pendientes (2)• En la ventana de protecciones pendientes podemos ver los

archivos que hemos modificado y que deben ser protegidos.• Mediante las cajas de verificación a la izquierda de cada icono

en esa ventana, podemos elegir que queremos proteger y que no.

• Para proteger el código (checkin) hacemos click en el botón “Proteger”

Integración con Visual Studio - Recomendaciones• Siempre que abramos una solución de Visual Studio que tenga

control de código es recomendable Obtener la ultima versión para tener la copia local completamente actualizada con la versión del servidor.

• Asegurarnos que lo que subimos al servidor funcione correctamente.

• Cuando finalicemos nuestra jornada es fundamental realizar las protecciones para que los demás usuarios puedan tener acceso a los archivos bloqueados.

Tito Peralta Beníteztperalta@gilatla.com