Versión del artículo: Enterprise Server 2.17
Instalar el servidor de GitHub Enterprise en OpenStack KVM
Para instalar GitHub Enterprise Server en OpenStack KVM, debes tener acceso a OpenStack y descargar la imagen QCOW2 GitHub Enterprise Server.
Prerrequisitos
- Debes tener un archivo de licencia de GitHub Enterprise. Para descargar un archivo de licencia existente o solicitar una licencia de prueba, visita enterprise.github.com. Para obtener más información, consulta "Administrar tu licencia de GitHub Enterprise Server".
- Debes tener acceso a una instalación de OpenStack Horizon, la interfaz de usuario con base en la web para los servicios de OpenStack. Para obtener más información, consulta la Documentación de Horizon.
Consideraciones relativas al hardware
GitHub Enterprise Server requiere un disco de datos persistente separado del disco raíz. Para obtener más información, consulta "Resumen del sistema". Para tu dispositivo de almacenamiento, recomendamos usar un SSD de alto rendimiento, ya sea que lo conectes en forma directa o desde una red del área de almacenamiento (SAN). Recomendamos diferentes configuraciones de hardware con base en la cantidad de licencias de usuario que se utilicen en tu instancia de servidor de GitHub Enterprise. |
Licencias de usuario | vCPU | Memoria | Almacenamiento conectado | Almacenamiento raíz |
---|---|---|---|---|
Prueba, Demo o 10 usuarios no frecuentes | 2 | 16 GB | 100 GB | 200 GB |
10-3000 | 4 | 32 GB | 250 GB | 200 GB |
3000-5000 | 8 | 64 GB | 500 GB | 200 GB |
5000-8000 | 12 | 96 GB | 750 GB | 200 GB |
8000-10000+ | 16 | 128 GB | 1000 GB | 200 GB |
Estas son las recomendaciones mínimas. Es posible que se requieran más recursos según su uso, como la actividad del usuario y las integraciones seleccionadas. Cuando incrementas los recursos de CPU, se recomienda agregar por lo menos 6.5 GB de memoria a cada uno (hasta 16 CPU) de los que hayas añadido a tu instancia de GitHub Enterprise Server. Para obtener más información, consulta "Aumentar los recursos de memoria o la CPU."
Nota: el disco raíz se puede cambiar de tamaño si construyes un aplicativo nuevo o si utilizas un aplicativo existente. Para obtener más información, consulta la sección Incrementar la capacidad de almacenamiento"
Advertencia: Te recomendamos utilizar webhooks para extraer cambios de repositorio para integración contínua (IC) o sistemas similares. Realizar verificaciones automáticas frecuentes, o sondeos, reducirá significativamente la escalabilidad de tu instancia. Para obtener más información, consulte "Acerca de webhooks"
Descargar la imagen GitHub Enterprise Server
- Visita la GitHub Enterprise Server página de descargas.
- Para descargar tu archivo de licencia, haz clic en Download license (Descargar licencia).
- Haz clic en Get the latest release of GitHub Enterprise Server (Obtener el último lanzamiento del GitHub Enterprise Server).
- Selecciona GitHub locales, después haz clic en OpenStack KVM (QCOW2) (Abrir Stack KVM (QCOW2)).
- Haz clic en Download for OpenStack KVM (QCOW2) (Descargar para OpenStack KVM (QCOW2)).
Crear la instancia GitHub Enterprise Server
Para crear la instancia, deberás importar la imagen del GitHub Enterprise Server a tu máquina virtual y adjuntar un volumen de almacenamiento adicional para los datos de tu instancia. Para obtener más información, consulta "Consideraciones relativas al hardware."
-
En OpenStack Horizon, carga la imagen GitHub Enterprise Server que descargaste. Para obtener instrucciones, consulta la sección "Cargar una imagen" de la guía de OpenStack "Cargar y administrar imágenes."
-
Crear un nuevo disco virtual para utilizarlo como un volumen adjunto de almacenamiento para los datos de tu instancia, y configurar el tamaño con base en la cantidad de licencias de usuario disponibles. Para obtener instrucciones, consulta la guía de OpenStack "Crear y administrar volúmenes."
-
Crea un grupo de seguridad, y agrega una nueva regla de grupo de seguridad para cada puerto en la tabla de abajo. Para obtener instrucciones, consulta la guía de OpenStack "Configurar acceso y seguridad para instancias."
Puerto Servicio Descripción 22 SSH Git a través de acceso SSH. Se admite clonar, extraer y subir operaciones a repositorios privados/públicos. 25 SMTP SMTP con soporte de encriptación (STARTTLS). 80 HTTP Acceso a aplicación web. Todas las solicitudes se redireccionan al puerto HTTPS cuando se habilita SSL. 122 SSH Acceso a shell de instancia. El puerto predeterminado (22) se dedica a la aplicación de git+el tráfico de red ssh. 161/UDP SNMP Se requiere para operar el protocolo de revisión de red. 443 HTTPS Aplicación web y Git a través de acceso HTTPS. 1194/UDP VPN Túnel de red de replicación segura en la configuración de alta disponibilidad. 8080 HTTP Consola de administración basada en la web de texto simple. No se requiere excepto que el SSL esté inhabilitado de forma manual. 8443 HTTPS Consola de administración seguro basada en la web. Requerido para la instalación y la configuración básicas. 9418 Git Puerto simple de protocolo de Git. Únicamente clonar y extraer operaciones a repositorios públicos. Comunicación de red no encriptada. -
De forma opcional, asocia una IP flotante a la instancia. Según tu configuración de OpenStack, es posible que necesites asignar una IP flotante al proyecto y asociarla a la instancia. Contacta a tu administrador de sistema para determinar si este es tu caso. Para obtener más información, consulta "Asignar una dirección de IP flotante a una instancia" en la documentación de OpenStack.
-
Inicia tu instancia de servidor de GitHub Enterprise utilizando la imagen, el volumen de datos y el grupo de seguridad creado en los pasos previos. Para obtener instrucciones, consulta la guía OpenStack "Iniciar y administrar instancias."
Configurar la instancia GitHub Enterprise Server
- Copia el nombre DNS público de la máquina virtual y pégalo en un navegador de red.
- En el prompt, carga tu archivo de licencia y configura una contraseña de consola de administración. Para obtener más información, consulta "Administrar tu licencia de GitHub Enterprise Server".
- En la Consola de administración, configura y guarda a configuración que desees. Para obtener más información, consulta "Configurar el aparato del GitHub Enterprise Server."
- La instancia se reiniciará automáticamente.
- Da clic en Visitar tu instancia.