Cómo crear grupos y mover proyectos en GitLab

Cree un grupo en GitLab y luego transfiera el proyecto desde su configuración para organizar el acceso y la colaboración. Elija la visibilidad del grupo de forma deliberada, confirme la transferencia en GitLab y compruebe después el proyecto en su nuevo grupo.

Crear un grupo de GitLab

1. Inicie sesión y abra Groups en la navegación superior; después, seleccione Your groups.
2. Elija New group y seleccione la opción de creación de grupos que muestre su instancia de GitLab.
3. Introduzca un nombre de grupo y una ruta URL. La ruta forma parte de la URL del grupo, así que elija una que sea reconocible y esté disponible.
4. Ajuste la visibilidad según quién debería poder descubrir el grupo o acceder a él. Revise las opciones de visibilidad de la instancia antes de crearlo; las políticas de la organización pueden restringirlas.
5. Cree el grupo. Invite a los miembros ahora o más tarde y asígneles solo los roles que necesiten. La pertenencia al grupo y los permisos del proyecto determinan quién puede trabajar con el proyecto.

Antes de crear el grupo, confirme el nombre y la ruta URL con las personas que lo utilizarán. La ruta forma parte de la dirección que compartirán los miembros del equipo. Si planea automatizar la creación de grupos, consulte la documentación de la API de grupos de GitLab correspondiente a su versión de GitLab para confirmar la operación admitida, los campos obligatorios, la autenticación y los permisos. Esta guía no proporciona ni verifica una solicitud de creación de grupos mediante la API.

Mover un proyecto de GitLab existente a un grupo

1. Abra el proyecto y vaya a Settings > General.
2. Expanda o desplácese hasta Advanced y localice Transfer project. Las etiquetas exactas pueden variar según la versión de GitLab y los permisos.
3. Seleccione el grupo de destino. Confirme que es el espacio de nombres deseado, ya que la URL del proyecto cambia cuando se completa la transferencia.
4. Siga el aviso de confirmación de GitLab, que puede pedirle que introduzca el nombre del proyecto, y envíe la transferencia.
5. Abra el proyecto desde el grupo de destino y compruebe su nueva URL y su espacio de nombres. Si la opción de transferencia no aparece o el destino no está disponible, pida a un propietario del grupo o a un administrador de la instancia que revise su rol y la política de transferencias.

Para la automatización, verifique el punto de conexión de transferencia de proyectos, el método de solicitud, la carga útil, la autenticación y los requisitos de permisos en la documentación de la API de proyectos de GitLab correspondiente a su versión de GitLab antes de enviar una solicitud. La documentación es la referencia autorizada para la forma de la solicitud; el ejemplo de Python siguiente solo reúne e imprime detalles ilustrativos de la solicitud. Sus ID y su carga útil de ejemplo no son instrucciones que deban copiarse entre versiones de GitLab. No contacta con GitLab ni verifica que una solicitud sea aceptada:

import json

project_id = 456
group_id = 123
request = {
    "method": "POST",
    "path": f"/api/v4/projects/{project_id}/transfer",
    "json": {"namespace_id": group_id},
}
print(json.dumps(request, sort_keys=True))

{"json": {"namespace_id": 123}, "method": "POST", "path": "/api/v4/projects/456/transfer"}

Después de que GitLab confirme la transferencia, vuelva a abrir el proyecto desde el grupo de destino y compruebe que su espacio de nombres y su URL reflejan la nueva ubicación. Revise quién puede acceder a él según la configuración de visibilidad y pertenencia del grupo de destino, y confirme que los colaboradores previstos pueden llegar hasta él. Si va a mover varios proyectos, gestione cada transferencia según las indicaciones de la interfaz o de la API para su versión de GitLab; no dé por hecho que existe una opción de transferencia en bloque. Vuelva a comprobar el historial del proyecto, las integraciones y el acceso como parte de la lista de verificación de traslado de su equipo.