Cómo descargar e instalar Jenkins on Windows

Jenkins puede instalarse en cualquiera de los dos Windows o plataformas Unix, pero este tutorial se centra en la Windows instalación solamente. El Windows Registros del instalador MSI Jenkins como herramienta de edición del Windows servicio y selecciona uno de 64 bits Java El sistema lo pone en marcha rápidamente, lo que lo convierte en la vía más rápida para obtener un servidor de automatización funcional. Antes de abrir el instalador, confirme que su equipo cumple con los requisitos que se indican en la siguiente sección.

Jenkins Requisitos previos y requisitos del sistema

Jenkins Es ligero en reposo, pero crece rápidamente una vez que se acumulan el historial de compilaciones, los espacios de trabajo y los complementos. Dimensionar correctamente la máquina desde el principio evita una migración complicada más adelante.

Requerimientos de Hardware:

Requisitos de software:

• Jenkins se ejecuta en Java, por lo que un apoyado Java Kit de desarrollo (JDK) o Java El entorno de ejecución (JRE) debe estar presente. Jenkins Los lanzamientos requieren Java 21 o posterior; Java Los modelos 8, 11 y 17 ya no cuentan con el soporte de la nueva línea de soporte a largo plazo.
• Se necesita un navegador web moderno para acceder a la Jenkins .
• Una cuenta con derechos administrativos en el Windows Se necesita una máquina para registrar el Jenkins .

Confirme la instalación Java Verifique la versión desde el símbolo del sistema antes de continuar. Si el comando falla o muestra una versión inferior a la 21, instale primero un JDK compatible.

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

Tipos de lanzamiento

Jenkins Publica dos líneas de lanzamiento, y la elección afecta la frecuencia con la que se actualiza.

Este tutorial utiliza la versión LTS, aunque el proceso de instalación es idéntico para la versión semanal. Una vez que se cumplen los requisitos previos, se puede iniciar la descarga.

Cómo Descargar Jenkins?

Siga los pasos a continuación para obtener el Windows instalador y completar una instalación exitosa:

Paso 1) Vaya al https://www.jenkins.io/download/ y seleccione la plataforma. En nuestro caso, Windows.

Paso 2) Dirígete a la ubicación de descarga en tu ordenador y descomprime el paquete descargado. Double-haga clic en el archivo descomprimido jenkins.msi . Jenkins También puede ejecutarse desde un archivo WAR (Archivo de aplicación web), pero esa ruta no se recomienda. Windows porque omite el registro del servicio que realiza el instalador.

Nota: Windows SmartScreen puede informar que impidió que se iniciara una aplicación no reconocida. Seleccione INFO, luego Correr a ninguna parte, para continuar con el firmado Jenkins instalador.

Paso 3) En la sección Jenkins Pantalla de configuración, haga clic en Siguiente.

Paso 4) Elija la ubicación donde el Jenkins Se debe instalar la instancia. La ubicación predeterminada en los instaladores actuales de 64 bits es C: \ Archivos de programa \Jenkins. Anote esta ruta, porque la contraseña de administrador inicial se almacena dentro de ella. Haga clic Siguiente.

Paso 5) A continuación, el instalador le pedirá las credenciales de inicio de sesión del servicio y el número de puerto. Proporcione una cuenta local o de dominio dedicada y haga clic en Aceptar. Credenciales de pruebaLuego, configure el puerto y haga clic. Puerto de prueba. Puerto 8080 es el valor predeterminado. Ejecutando Jenkins bajo una cuenta de servicio con nombre es más seguro que la opción LocalSystem, que otorga Jenkins acceso completo a la máquina.

Paso 6) Confirme la Java directorio de inicio que detecta el instalador, revise las opciones de configuración personalizadas y haga clic en el Instale botón. Una vez completada la instalación, haga clic. Termine.

Paso 7) Durante el proceso de instalación, puede aparecer un panel informativo para informarle que se requiere un reinicio al final de la instalación actual. Haga clic en el OK botón cuando aparece el panel de información.

Los archivos ya están en el disco y el servicio está registrado. La siguiente etapa desbloquea la interfaz web.

Cómo desbloquear Jenkins?

Después de completar el Jenkins En la fase de instalación, el controlador se bloquea hasta que usted proporcione una contraseña generada automáticamente. Los pasos a continuación explican cómo desbloquearlo. Jenkins solicitud:

Paso 1) Una vez finalizado el proceso de instalación, se abrirá una pestaña del navegador que le pedirá la contraseña de administrador inicial. Para llegar Jenkins, navegue a la siguiente ruta en su navegador web.
http://localhost:8080

Si la dirección anterior se carga correctamente, la instalación se ha realizado con éxito y el servicio está en funcionamiento.

Paso 2) La contraseña inicial del administrador se almacena en el Jenkins Ruta de instalación que configuró en el paso 4 de la instalación. Para la ubicación predeterminada C: \ Archivos de programa \Jenkins, un archivo llamado Contraseña de administrador inicial se encuentra debajo C: \ Archivos de programa \Jenkins\misterios. Si se seleccionó una ruta personalizada, verifique esa ubicación en su lugar. El mismo valor también se escribe en el jenkins.err.log presentar en el Jenkins directorio de inicio.

Paso 3) Abra el archivo resaltado y copie el contenido del mismo. Contraseña de administrador inicial .

Paso 4) Pegue la contraseña en el Contraseña de administrador campo en el Desbloqueo Jenkins página en su navegador y haga clic en el Continuar .

Una vez desbloqueado el controlador, el asistente de configuración pasa a los complementos y a la primera cuenta de usuario.

Personalizar Jenkins

También puede personalizar su Jenkins entorno siguiendo los pasos que se indican a continuación:

Paso 1) Haga clic en el botón Instalar los complementos sugeridos botón para que Jenkins Recupera e instala los complementos esenciales.

Jenkins comienza a descargar e instalar todos los complementos necesarios para crear nuevos Jenkins puestos de trabajo.

Nota: Puedes elegir la opción Seleccione los complementos que desea instalar y seleccione solo los complementos que desee. Los complementos se pueden agregar o eliminar posteriormente desde Gestionar Jenkins > Complementos, por lo que esta elección no es permanente.

Paso 2) Después de instalar todos los complementos sugeridos, Crear primer usuario administrador Aparece el panel. Rellene todos los campos con los datos de cuenta deseados y haga clic en el botón. Guardar y finalizar .

Paso 3) Jenkins finalmente pide el URL donde se accederá a la instancia. Deje el valor predeterminado para evitar confusiones posteriores. Si otra aplicación ya utiliza el puerto 8080, proporcione un puerto diferente aquí y luego haga clic en el botón. Guardar y continuar .

¡Felicidades! Un nuevo Jenkins El servidor ya está instalado. Haga clic en el Empieza a usarlo Jenkins .

El Jenkins La instancia está en funcionamiento y lista para su primer trabajo. Un breve Jenkins Tutorial para principiantes Explica cómo crear ese puesto de trabajo.

Cómo verificar el Jenkins Instalación y gestión del servicio

Un panel que se carga una vez no es prueba de una instalación correcta. Porque el instalador MSI registra Jenkins como herramienta de edición del Windows El servicio debe sobrevivir a un reinicio y reiniciarse correctamente cuando se le solicite. Realice las comprobaciones que se indican a continuación inmediatamente después de que se cierre el asistente de configuración.

1. Confirma que el servicio existe. Prensa Win + R, tipo services.mscy pulse Intro. Localice la entrada llamada Jenkins y confirmar que el estado dice Correr y el tipo de inicio dice Automático.
2. Verifique la cuenta en uso. Abra las propiedades del Jenkins servicio y revisión del iniciar pestaña. Es preferible una cuenta de servicio dedicada a LocalSystem para cualquier cosa que vaya más allá de la experimentación local.
3. Verifique el puerto de escucha. Ejecutar netstat -ano | findstr :8080 desde el símbolo del sistema. Una entrada LISTENING confirma que Jenkins Mantiene el puerto.
4. Lea el banner de la versión. Iniciar sesión en http://localhost:8080 y lee el número de versión que aparece en la esquina inferior derecha del panel de control. Compáralo con la versión que descargaste.
5. Reiniciar una vez. Reanudación Windows y vuelve a acceder al panel de control sin iniciar nada manualmente. Si la página se carga, el servicio es realmente automático.

El servicio también se puede controlar desde un símbolo del sistema con privilegios elevados, lo que resulta más rápido que la consola gráfica y funciona bien dentro de los scripts de implementación:

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

💡 Consejo: El instalador silencioso acepta INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME, y SERVICE_PASSWORD como anulaciones de propiedades. Cualquier valor que no se pase vuelve a su valor predeterminado, y en modo silencioso el servicio se ejecuta como LocalSystem a menos que se proporcione una cuenta de servicio.

Si alguna de estas comprobaciones falla, las causas suelen ser predecibles, como se muestra en la siguiente sección.

Preguntas frecuentes sobre bancarrota Jenkins Errores de instalación en Windows y cómo solucionarlos

La mayoría fracasó Windows instalaciones tracVolvamos a un pequeño conjunto de causas: una sin respaldo Java El problema puede deberse a un entorno de ejecución, un puerto ocupado o una cuenta de servicio que no tiene permisos para iniciar sesión como servicio. Cada uno produce un síntoma distinto, por lo que la solución suele ser rápida una vez que se lee el mensaje con atención.

• Credenciales de inicio de sesión de servicio no válidas: El instalador rechaza la cuenta durante el Credenciales de prueba paso. Abrir secpol.msc, expandir Políticas locales > Asignación de derechos de usuario, abierto Iniciar sesión como servicioy añade la cuenta. A continuación, vuelve a intentar la prueba de credenciales.
• El puerto 8080 ya está en uso: El Puerto de prueba El botón se vuelve rojo porque otra aplicación, a menudo un Tomcat local o un servidor de desarrollo, ya está utilizando el puerto. Elija un puerto libre como el 8081 o detenga el proceso conflictivo identificado por netstat -ano.
• No compatible o faltante Java: El instalador no puede rellenar previamente el Java directorio principal, o el servicio se inicia y se detiene inmediatamente. Instale un JDK 21 de 64 bits o posterior, luego indique al instalador su directorio principal.
• SmartScreen bloquea al instalador: Windows Informa de una aplicación no reconocida. Seleccionar INFO, luego Correr a ninguna parte, tras confirmar que el archivo provenía de la fuente oficial Jenkins página de descarga.
• No se encontró el archivo initialAdminPassword: Se eligió un directorio de instalación personalizado. Mire dentro del secrets carpeta de ese directorio, o lea la contraseña de jenkins.err.log en el Jenkins directorio de inicio.

En el momento que todos los DARWINs coticen incluyendo los deslizamientos Jenkins Si funciona de forma fiable, el siguiente paso natural es conectarlo a un repositorio de código fuente y a una canalización de compilación. Los tutoriales sobre Jenkins Integración de GitHub y conectar Canalización de CI / CD Explique cómo se implementa la integración continua en torno a esta instalación.

Preguntas Frecuentes