Inicio
» WINDOWS
»
Cómo configurar un servidor GitLab en Windows Server con Hyper-V
Cómo configurar un servidor GitLab en Windows Server con Hyper-V
Para configurar GitLab Self-Managed en Windows Server, ejecute una máquina virtual Ubuntu Server compatible en Hyper-V e instale GitLab dentro del sistema operativo invitado Linux. Windows Server seguirá siendo el sistema anfitrión; GitLab se ejecuta desde su paquete oficial para Linux. La guía actual del paquete de GitLab para Ubuntu menciona Ubuntu 22.04 y 24.04, por lo que este tutorial utiliza Ubuntu Server 24.04 LTS.
Antes de comenzar, confirme que el host pueda asignar CPU, RAM y disco al sistema invitado. La configuración base de GitLab para un solo nodo requiere 8 vCPU y 16 GB de RAM; asigne 40 GB para la aplicación, entre 5 y 12 GB para la base de datos, además del almacenamiento del repositorio. Utilice discos SSD y reserve recursos para Windows Server.
1. Instale el rol Hyper-V.
En el Administrador del servidor, seleccione Administrar > Agregar roles y características , seleccione el servidor local y habilite Hyper-V . Incluya las herramientas de administración y permita el reinicio necesario. También puede ejecutar PowerShell como administrador e instalar el rol local con:
La instalación de Hyper-V reinicia el host. Consulte la guía de instalación de Hyper-V de Microsoft si su servidor utiliza una configuración de administración diferente.
Seleccione la función Hyper-V en el Administrador del servidor y, a continuación, instale sus herramientas de administración.
2. Crea un conmutador virtual para el invitado.
En el Administrador de Hyper-V, abra el Administrador de conmutadores virtuales y cree un conmutador externo en el adaptador LAN del host. Elija si Windows debe compartirlo. Esto le proporciona a Ubuntu una dirección LAN y permite que los dispositivos autorizados accedan a GitLab. Utilice una LAN o VPN de confianza; siga la política de su red antes de acceder públicamente. Consulte la guía de conmutadores virtuales de Microsoft .
Un conmutador externo conecta el sistema invitado Ubuntu a la red física seleccionada.
3. Crea la máquina virtual Ubuntu
Descarga Ubuntu Server 24.04 LTS . En Hyper-V Manager, crea una máquina virtual con el nombre especificado GitLab-Ubuntu, selecciona Generación 2 , conecta el conmutador externo y crea un archivo VHDX con almacenamiento SSD. Utiliza la configuración base de GitLab de 8 vCPU/16 GB para un solo nodo; un laboratorio puede comenzar con una configuración más pequeña, con un rendimiento menor.
Adjunte la imagen ISO a la unidad de DVD virtual. Si Ubuntu no arranca, configure la plantilla de arranque seguro de la máquina virtual de Generación 2 en la Autoridad de certificación UEFI de Microsoft .
Esta máquina virtual de segunda generación de muestra tiene la configuración base de CPU y memoria publicada por GitLab; ajuste el tamaño de su disco expandible para el crecimiento de la aplicación, la base de datos y el repositorio.Monta aquí la imagen ISO de Ubuntu Server y, a continuación, confirma la opción de conexión externa en la configuración del adaptador de red.
4. Instala Ubuntu y asígnale una dirección estable.
Inicie la máquina virtual y complete la instalación de Ubuntu Server. Cree una cuenta de administrador, use un nombre de host como gitlaby habilite OpenSSH para la administración remota. Asigne a la máquina virtual una IP estática o una reserva DHCP para que su dirección permanezca estable.
Durante la instalación de Ubuntu, configure el nombre de host de la máquina virtual y elija una configuración de red estable.
Tras el primer inicio de sesión, instale las actualizaciones disponibles y reinicie el equipo si se le solicita:
sudo apt update && sudo apt upgrade -y
Actualiza Ubuntu y confirma que la máquina virtual tenga una dirección de red accesible antes de instalar GitLab.
5. Configure el DNS y permita solo el tráfico necesario.
Cree un registro DNS que gitlab.example.comse resuelva a la dirección estable de la máquina virtual. Permita el acceso a los puertos TCP entrantes 22 para Git a través de SSH, 80 para HTTP y la validación del certificado Let's Encrypt, y 443 para HTTPS. Aplique las reglas correspondientes en el firewall de Ubuntu, el firewall de Windows/red y cualquier enrutador o firewall en la nube que se encuentre delante del host. Restrinja el acceso SSH y web a los usuarios o redes autorizados, siempre que sea posible.
Estos comandos instalan el paquete de la Edición Comunitaria. Reemplace el nombre de host de ejemplo con el nombre DNS que configuró. Para la Edición Empresarial, utilice la opción EE en la guía oficial de instalación de GitLab para Ubuntu . Revise el script de configuración del repositorio antes de ejecutarlo como administrador.
Con un nombre DNS público válido y acceso HTTP entrante, GitLab puede solicitar un certificado Let's Encrypt durante la instalación. Para un servidor interno, configure un certificado de confianza para su organización y siga las instrucciones TLS actuales de GitLab. Consulte los requisitos de instalación de GitLab antes de dimensionar una máquina virtual de producción.
7. Inicie sesión, proteja la instancia y pruebe un repositorio.
Cuando finalice la instalación, abra https://gitlab.example.com. Inicie sesión como root; recupere la contraseña inicial de /etc/gitlab/initial_root_passworden la máquina virtual Ubuntu. GitLab elimina ese archivo después de 24 horas, así que cambie la contraseña inmediatamente y guarde la nueva credencial de forma segura.
Utilice el nombre de host HTTPS configurado para acceder a la página de inicio de sesión de GitLab.
Crea un proyecto de prueba, añade un archivo README y clónalo mediante HTTPS o SSH desde un equipo cliente para confirmar que el DNS, las reglas del firewall y la autenticación funcionan correctamente. Antes de invitar a un equipo, revisa los pasos recomendados por GitLab , habilita la autenticación de dos factores y restringe los registros públicos si la instancia es privada. Configura copias de seguridad programadas y cópialas fuera de la máquina virtual; la guía de copias de seguridad de GitLab explica qué incluye el comando de copia de seguridad y qué se debe respaldar por separado.
Utilice el menú de clonación del proyecto para verificar la ruta HTTPS o SSH que utilizará su equipo.
Mantén Windows y Ubuntu actualizados, controla el crecimiento del espacio en disco y prueba una restauración de copia de seguridad antes de confiar en la instancia para repositorios importantes.