Escenario de equipo

Contexto del escenario

Este capítulo tiene como objetivo mostrar cómo se puede usar Git en equipo, en particular gracias a GitLab, una interfaz web de gestión de repositorios.

Este capítulo va a cubrir muchos temas empleando un escenario para mostrar en qué casos es conveniente realizar ciertas acciones; sin embargo no puede ser exhaustivo sobre los casos de uso de Git en entornos empresariales, ya que existen muchas otras situaciones complicadas en la vida de un proyecto.

Rafael no solo trabaja de forma independiente; también es empleado en una empresa que diseña software a medida para sus clientes. Es desarrollador de esta empresa y forma parte del equipo de un producto que permite a los clientes gestionar sus proyectos: Improllow. Estos son los otros miembros de su equipo:

El producto que diseñan se utiliza en empresas de todos los tamaños. El software les permite gestionar sus proyectos con gran eficacia. Después de la instalación del software y la formación de los colaboradores, los equipos son capaces de medir con mayor facilidad la duración total de un proyecto y los riesgos de desviaciones.

Desde el comienzo del proyecto, el equipo no ha empleado ningún sistema de gestión de versiones. En efecto...

Resumen del proyecto

Antes de embarcarse en este capítulo, puede ser útil ensayar el software para estudiar su funcionamiento y la comprensión de los ejemplos del capítulo. Para esto, debe instalar Python y Django en su sistema (además de Git). Esta parte del capítulo solo tiene como objetivo mostrar el software final. No es necesario en absoluto para el aprendizaje de Git y el lector con prisas puede pasar directamente a la instalación de GitLab.

El proyecto se encuentra en los elementos descargables. El repositorio se encuentra en la carpeta 11/Improllow-up. Las librerías jQuery y AngularJS ya están generadas, la base de datos SQLite también, así como un usuario root. Sin embargo, falta instalar Python y sus dependencias, y luego iniciar el servidor.

Para estos pasos se considera que Git ya está instalado en la máquina.

python -V 

Instalación de GitLab

GitLab es un software que se presenta en forma de una interfaz web que permite trabajar a varios colaboradores en un repositorio y que permite gestionar equipos de desarrolladores más fácilmente. GitLab presenta una serie de ventajas en comparación con el uso de un repositorio local compartido:

La instalación de GitLab se explicará para una distribución de GNU/Linux Debian 8. Para instalar GitLab, en primer lugar se debe visitar la página de descargas del sitio oficial: https://about.gitlab.com/downloads/#debian8. En esta página GitLab ofrece instrucciones para instalar GitLab y todas sus dependencias.

En primer lugar, hay que instalar las dependencias de GitLab. La instalación...

Creación de cuentas de usuario

Para crear las cuentas de usuario, en primer lugar se debe visitar la página de administración pulsando el icono en forma de llave. Aparece un vínculo en el menú de la izquierda; este vínculo representa una persona y hay que hacer clic en él para mostrar una lista de usuarios. De momento, esta lista solo contiene un único usuario: Administrator.

Hacer clic en el botón New User permite crear un nuevo usuario con varios campos para definir:

Pueden suministrarse otros como una dirección de Skype o su sitio web.

Para confirmar la creación de la cuenta, hay que pulsar el botón Create user.

Una vez creada la cuenta, GitLab redirige al Administrador a la página de perfil de la cuenta. En esta página, se puede actualizar la información del usuario haciendo clic en el botón Edit, en la parte superior. Esta página permite también visualizar la información del usuario y bloquearlo para que no siga teniendo acceso...

Creación del proyecto

Para crear un proyecto con GitLab, se requiere, en primer lugar, hacer clic en el botón New project en la parte superior derecha (el botón con forma de signo +). En este escenario, Noelia, la jefa de proyecto, añadirá el proyecto.

Aparecerá un formulario con los siguientes campos:

Cuando se acepta el formulario, se redirige al usuario a la página...

Asignar los proyectos a los usuarios

Una vez creado el proyecto, este solo está accesible para Noelia. Para asignar a otros usuarios, en primer lugar debe ir a la página del proyecto. A continuación, aparece un nuevo vínculo en el menú Members. Haciendo clic en él, Noelia accede a la lista de usuarios vinculados al proyecto. Por el momento, ella es la única integrante de esta lista. El botón Add members, en la parte superior, despliega un marco que permite añadir usuarios escribiendo sus nombres en el campo People. En el campo Project Access, ella les asigna acceso Developer. La asignación del proyecto se hará entonces previa validación del formulario.

Por defecto, GitLab protege ciertas ramas de los push de los desarrolladores. Esto permite autorizar solo a los usuarios con acceso Master a realizar push en estas ramas. Noelia desea autorizar a los desarrolladores de su equipo a efectuar push de sus ramas sin problemas, pero no quiere asignarles acceso Master. Para conseguir esto, Noelia debe, antes que nada, dirigirse a la página del proyecto. Luego, debe pulsar en el enlace del menú izquierdo Settings (en el pie de página). El menú se vuelve a actualizar y deja ver un vínculo Protected Branches, en el que Noelia hace clic. En el pie de esta página se encuentra la lista de las ramas protegidas (por defecto solo la rama master).

Para autorizar a los desarrolladores...

Primer commit del proyecto

Noelia pidió a Rafael ocuparse del primer commit, que situará el proyecto en el repositorio respetando las mejores prácticas.

git add --all --dry-run > lista_de_archivos.txt 

/improllowup/static/lib 

Fase de desarrollo

Para la fase de desarrollo, todos los participantes han clonado el repositorio en sus equipos. También crearon su archivo improllowup/settings/local.py.

git pull --all 

* master 
  remotes/origin/HEAD -> origin/master 
  remotes/origin/develop 
  remotes/origin/master 

git checkout remotes/origin/develop 
git checkout -b develop 

python3 manage.py migrate --settings=improllowup.settings.local 

git submodule init 
git submodule update 

cd improllowup/static/lib/js/jquery 
sudo npm run build 
cd - 

python3 manage.py createsuperuser --username=root 
--email=git@dauzon.com --settings=improllowup.settings.local 

git checkout -b graph_employee 
git commit --allow-empty -m "C3: Creación de la rama graph_employee" 
git push -u origin graph_employee 

Puesta en línea del repositorio en GitHub

Para que los lectores de este libro puedan descargar fácilmente un repositorio explotable y seguir la evolución de este proyecto, es preferible hospedar también el repositorio en GitHub. En una situación más realista, esta parte puede explicar cómo una empresa puede liberar el código fuente de uno de sus proyectos. Esta parte mostrará los pasos para poner en línea un proyecto en GitHub, teniendo en cuenta las mejores prácticas.

1. Creación de una cuenta GitHub

Para publicar un repositorio en GitHub, se requiere una cuenta de GitHub. Para esto, hay que visitar el sitio http://github.com y pulsar el enlace Sign Up, en la parte superior de la página. Aparecerá un formulario que solicita un nombre de usuario (Username), una dirección e-mail (Email Address) y una contraseña (Password).

Después de haber rellenado esta información y pulsar el botón Create an account, hay que elegir el tipo de cuenta que se va a guardar (el plan gratuito solo permite poner en línea repositorios públicos) y hacer clic en Finish sign up.

Una vez conectado a la cuenta GitHub, puede acceder a su perfil haciendo clic en la parte superior derecha en su avatar y a continuación en Your Profile.