Cd.

Gua de Administracin Servicio Gitlab

Fecha

Gua de Administracin
Servicio Gitlab

COPIA NO CONTROLADA
 Pg. 2 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

TABLA DE CONTENIDO
No. de pg.

Objetivo

Alcance

Glosario

Consideraciones Generales

Credenciales de Acceso

Introduccin a Git

Qu es GIT?

Qu es Gitlab?

Tareas de Administracin

Direccin de Acceso

Reglas para la Creacin de Grupos y Repositorios

Creacin de Repositorios

Roles y Permisos

Roles de Usuario

Permisos por Grupo

Permisos por Proyecto

Autorizar Acceso a Repositorios

Anexos

COPIA NO CONTROLADA
 Pg. 3 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

Identificacin de Cambios

COPIA NO CONTROLADA
 Pg. 4 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

1. Objetivo
Este documento pretende documentar los temas relacionados con la administracin del servicio de
versionamiento de cdigo fuente utilizado en la oficina de informtical basado en el protocolo GIT
utilizando la versin comunitaria del producto GitLab 1.

2. Alcance
Dirigido a los gestores de infraestructura de tecnologa y admistrador de la aplicacin.

3. Glosario
Git: Git es un software de control de versiones diseado por Linus Torvalds, pensando en
la eficiencia y la confiabilidad del mantenimiento de versiones de aplicaciones cuando stas
tienen un gran nmero de archivos de cdigo fuente. Al principio, Git se pens como un
motor de bajo nivel sobre el cual otros pudieran escribir la interfaz de usuario o front end
como Cogito o StGIT. 3 Sin embargo, Git se ha convertido desde entonces en un sistema
de control de versiones con funcionalidad plena. 4 Hay algunos proyectos de mucha
relevancia que ya usan Git, en particular, el grupo de programacin del ncleo Linux2 .
Control de Versiones: Se llama control de versiones a la gestin de los diversos cambios
que se realizan sobre los elementos de algn producto o una configuracin del mismo. Una
versin, revisin o edicin de un producto, es el estado en el que se encuentra el mismo en
un momento dado de su desarrollo o modificacin3.

1
https://about.gitlab.com/
2
https://es.wikipedia.org/wiki/Git
3
https://es.wikipedia.org/wiki/Control_de_versiones

COPIA NO CONTROLADA
 Pg. 5 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

4. Consideraciones Generales
4.1. Credenciales de Acceso
En un documento adicional se entregarn los usuarios y credenciales de administracin de las
herramientas. Es responsabilidad de la nueva persona o personas asignadas a la administracin
del servicio, que dichas credenciales sean cambiadas peridicamente.

Con respecto al acceso para los usuarios desarrolladores que requieren acceder al servicio: La
autenticacin del servicio est configurada para utilizar el servidor de directorio activo institucional
DCIGAC.

COPIA NO CONTROLADA
 Pg. 6 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

5. Introduccin a Git
5.1. Qu es GIT?
Git, es un software de control de versiones diseado por Linus Torvalds. Se define como control de
versiones a la gestin de los diversos cambios que se realizan sobre los elementos de algn
producto o una configuracin del mismo es decir a la gestin de los diversos cambios que se
realizan sobre los elementos de algn producto o una configuracin. Git fue creado pensando en
la eficiencia y la confiabilidad del mantenimiento de versiones de aplicaciones cuando stas tienen
un gran nmero de archivos de cdigo fuente, es decir Git proporciona las herramientas para
desarrollar un trabajo colaborativo de manera inteligente y rpida4.

5.2. Qu es Gitlab?
Gitlab es un producto de software que permite la administracin del versionamiento de cdigo
fuente a gravs del protocolo Git. Dicho software permite el seguimiento y revisin colaborativa de
los cambios a travs de un entorno web.

4
https://codigofacilito.com/articulos/que-es-git

COPIA NO CONTROLADA
 Pg. 7 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

6. Tareas de Administracin
6.1. Direccin de Acceso
Al momento de escribir el presente documento la direccin para acceder al servidor GIT publicado
ttp://172.17.3.60/
por la oficina de informtica es la siguiente: h

La distribucin utilizada est basada en el software Gitlab5.

6.2. Reglas para la Creacin de Grupos y Repositorios

Se establecen las siguientes reglas para la creacin de Grupos y Repositorios en el servidor GIT
institucional:

La nica persona autorizada para la creacin de grupos y repositorios en el servidor es el

administrador de la herramienta asignado por la oficina de Informtica.
No se permite la creacin de repositorios para uso personal. Todos los proyectos deben
estar asociados a proyectos aprobados por la oficina de informtica.
Para solicitar la creacin de grupos y repositorios el responsable del proyecto debe dirigir la
solicitud a la oficina de informtica a travs de la mesa de ayuda (GLPI). En la solicitud
debe incluir la siguiente informacin:
Para grupos:
Nombre del Grupo
rea de la Organizacin
Descripcin del Grupo
Para repositorios:
Nombre del Repositorio
Grupo al que pertenece
Descripcin del Repositorio
Lista de usuarios a los que se debe dar acceso con sus respectivos roles

5
https://about.gitlab.com/

COPIA NO CONTROLADA
 Pg. 8 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

Una vez se creen los nuevos repositorios o grupos, debe realizarse la respectiva
actualizacin del documento Gitlab Listado de Repositorios donde se reflejen los
cambios.
nicamente se permite la creacin de usuarios directamente en la aplicacin gitlab para
procesos automatizados de integracin y verificacin de calidad. Dichos usuarios deben
ttp://gitlab.igac.gov.co/groups/bots )
estar asociados al grupo bots ( h

6.3. Creacin de Repositorios

En la pgina principal debe seleccionar la opcin New Project

Asignar los datos del nuevo proyecto:

Project Path: Nombre del proyecto

Namespace: Espacio de trabajo o nombre del grupo. Debe ser una sola palabra corta sin
caracteres especiales (Ejemplos: snc, servicios, siga)

COPIA NO CONTROLADA
 Pg. 9 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

Description: Descripcin del proyecto

Visibilidad: Para los proyectos la visibilidad debe configurarse como private

6.4. Roles y Permisos

6.4.1. Roles de Usuario
El acceso a gitlab est restringido ya sea por roles de usuario o grupo.

Roles de Usuario para Administracin del repositorio:

COPIA NO CONTROLADA
 Pg. 10 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

admin: Administrador del repositorio. Este rol no debe ser utilizado dado que las tareas del
mismo son asignadas al administrador general de la plataforma.

Roles de Usuario permitido para los desarrolladores y usuarios de la herramienta implantada en la

unidad de informtica:

master: Lder de Desarrollo. Adems de las tareas permitidas al desarrollador, est

encargado de otras responsabilidades tales como la configuracin general del repositorio,
creacin de ramas, administracin de tags y milestones, verificacin del cumplimiento de
las reglas para commits y merge.
developer: Desarrollador. Tiene la responsabilidad de versionar el cdigo fuente en la
herramienta, creacin de tags y branches, solicitud de merge request con la rama principal.
reporter: Puede crear issues y ver el cdigo fuente del repositorio.
guest: Puede consultar la actividad general del repositorio.

En la siguiente tabla se listan las diferentes actividades que pueden desarrollar cada uno de los
roles:

COPIA NO CONTROLADA
 Pg. 11 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

6.4.2. Permisos por Grupo

Cualquier usuario puede apartarse de un grupo, a menos que sean el ltimo propietario del mismo.
La siguiente tabla muestra los diferentes niveles de permisos de usuario en un grupor6 segn su
rol:

6.4.3. Permisos por Proyecto

La siguiente tabla muestra los diferentes niveles de permisos de usuario en un proyecto segn su
rol:

6
https://docs.gitlab.com/ce/user/permissions.html

COPIA NO CONTROLADA
 Pg. 12 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

COPIA NO CONTROLADA
 Pg. 13 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

6.5. Autorizar Acceso a Repositorios

En la pgina del proyecto debe seleccionar la opcin members:

COPIA NO CONTROLADA
 Pg. 14 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

En la opcin people seleccionar la persona a la que se debe autorizar el acceso y seleccionar el

rol del usuario segn la tabla de permisos establecida por gitlab.

Nota: Para que el usuario aparezca en la lista de people primero debe hacer login en
gitlab utilizando su usuario del directorio activo del IGAC

COPIA NO CONTROLADA
 Pg. 15 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

7. Anexos

COPIA NO CONTROLADA
 Pg. 16 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

8. Identificacin de Cambios

Versin Descripcin Autor Fecha

1.0 Versin Inicial del Juan Carlos Mndez 2016-11-01

Documento

COPIA NO CONTROLADA
 Pg. 17 de 19

Gua de Administracin Servicio Gitlab Cd. PRxxxx4-XX/14XX

Fecha

ELABOR GRUPO INTERNO DE TRABAJO

SNC

REVIS METODOLGICAMENTE GRUPO

INTERNO DE TRABAJO SNC

VERIFIC TCNICAMENTE GRUPO INTERNO

DE TRABAJO SNC

VALID Y APROB

COPIA NO CONTROLADA