Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Fecha
Gua de Administracin
Servicio Gitlab
COPIA NO CONTROLADA
Pg. 2 de 19
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
Creacin de Repositorios
Roles y Permisos
Roles de Usuario
Anexos
COPIA NO CONTROLADA
Pg. 3 de 19
Fecha
Identificacin de Cambios
COPIA NO CONTROLADA
Pg. 4 de 19
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
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
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
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
5
https://about.gitlab.com/
COPIA NO CONTROLADA
Pg. 8 de 19
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
COPIA NO CONTROLADA
Pg. 9 de 19
Fecha
COPIA NO CONTROLADA
Pg. 10 de 19
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.
En la siguiente tabla se listan las diferentes actividades que pueden desarrollar cada uno de los
roles:
COPIA NO CONTROLADA
Pg. 11 de 19
Fecha
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:
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
Fecha
COPIA NO CONTROLADA
Pg. 13 de 19
Fecha
COPIA NO CONTROLADA
Pg. 14 de 19
Fecha
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
Fecha
7. Anexos
COPIA NO CONTROLADA
Pg. 16 de 19
Fecha
8. Identificacin de Cambios
COPIA NO CONTROLADA
Pg. 17 de 19
Fecha
VALID Y APROB
COPIA NO CONTROLADA