Compartir a través de


Introducción: Instalación de Jenkins en una máquina virtual Linux de Azure

En este artículo se muestra cómo instalar Jenkins en una máquina virtual Ubuntu Linux con las herramientas y complementos configurados para trabajar con Azure.

En este artículo, aprenderá a:

  • Creación de un archivo de instalación que descargue e instale Jenkins
  • Creación de un grupo de recursos
  • Creación de una máquina virtual con el archivo de instalación
  • Abra el puerto 8080 para acceder a Jenkins en la máquina virtual.
  • Conexión a la máquina virtual a través de SSH
  • Configuración de un trabajo de Jenkins de ejemplo basado en una aplicación java de ejemplo en GitHub
  • Crear la tarea de ejemplo en Jenkins

1. Configuración del entorno

  • Suscripción de Azure: si no tiene una suscripción de Azure, cree una cuenta gratuita antes de comenzar.

2. Abra Cloud Shell

  1. Si ya tiene abierta una sesión de Cloud Shell, puede ir directamente a la sección siguiente.

  2. Vaya a Azure Portal.

  3. Si es necesario, inicie sesión en la suscripción de Azure y cambie el directorio de Azure.

  4. Abra el Cloud Shell.

    Abra Cloud Shell desde el menú superior en el portal de Azure.

  5. Si no ha usado anteriormente Cloud Shell, configure los valores de entorno y almacenamiento.

  6. Seleccione el entorno de la línea de comandos.

    Seleccione la CLI que desea usar en Cloud Shell.

3. Creación de una máquina virtual

  1. Cree un directorio de prueba denominado jenkins-get-started.

  2. Cambie al directorio de prueba.

  3. Cree un archivo llamado cloud-init-jenkins.txt.

  4. Pegue el código siguiente en el nuevo archivo:

    #cloud-config
    package_upgrade: true
    runcmd:
      - sudo apt install openjdk-17-jre -y
      - curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
      -  echo 'deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/' | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
      - sudo apt-get update && sudo apt-get install jenkins -y
      - sudo service jenkins restart
    
    
    
  5. Ejecute az group create para crear un grupo de recursos.

    az group create --name jenkins-get-started-rg --location eastus
    
  6. Ejecute az vm create para crear una máquina virtual.

    az vm create \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm \
    --image UbuntuLTS \
    --admin-username "azureuser" \
    --generate-ssh-keys \
    --public-ip-sku Standard \
    --custom-data cloud-init-jenkins.txt
    
  7. Ejecute az vm list para comprobar la creación (y el estado) de la nueva máquina virtual.

    az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
    
  8. A medida que Jenkins se ejecuta en el puerto 8080, ejecute az vm open para abrir el puerto 8080 en la nueva máquina virtual.

    az vm open-port \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm  \
    --port 8080 --priority 1010
    

4. Configuración de Jenkins

  1. Ejecute az vm show para obtener la dirección IP pública de la máquina virtual de ejemplo.

    az vm show \
    --resource-group jenkins-get-started-rg \
    --name jenkins-get-started-vm -d \
    --query [publicIps] \
    --output tsv
    

    Puntos clave:

    • El --query parámetro limita la salida a las direcciones IP públicas de la máquina virtual.
  2. Con la dirección IP recuperada en el paso anterior, accede mediante SSH a la máquina virtual. Deberá confirmar la solicitud de conexión.

    ssh azureuser@<ip_address>
    

    Puntos clave:

    • Una vez establecida la conexión, el entorno de Cloud Shell muestra el nombre de usuario y el nombre de la máquina virtual: azureuser@jenkins-get-started-vm.
  3. Compruebe que Jenkins se está ejecutando obteniendo el estado del servicio Jenkins.

    service jenkins status
    

    Puntos clave:

    • Si recibe un error con respecto al servicio no existente, es posible que tenga que esperar un par de minutos para que todo se instale e inicialice.
  4. Obtenga la contraseña de Jenkins generada automáticamente.

    sudo cat /var/lib/jenkins/secrets/initialAdminPassword
    
  5. Con la dirección IP, abra la siguiente dirección URL en un explorador: http://<ip_address>:8080

  6. Escriba la contraseña que recuperó anteriormente y seleccione Continuar.

    Página inicial para desbloquear Jenkins

  7. Seleccione Seleccionar complemento para instalar.

    Seleccione la opción para instalar complementos seleccionados.

  8. En el cuadro de filtro de la parte superior de la página, escriba github. Seleccione el complemento de GitHub y seleccione Instalar.

    Instalación de los complementos de GitHub

  9. Escriba la información del primer usuario administrador y seleccione Guardar y continuar.

    Escriba la información del primer usuario administrador.

  10. En la página Configuración de instancia, seleccione Guardar y finalizar.

    Página de confirmación para la configuración de instancia

  11. Seleccione Empezar a usar Jenkins.

    Jenkins está listo.

5. Creación del primer trabajo

  1. En la página principal de Jenkins, seleccione Crear un trabajo.

    Página principal de la consola jenkins

  2. Escriba un nombre de trabajo de mySampleApp, seleccione Proyecto freestyle y seleccione Aceptar.

    Creación de nuevos trabajos

  3. Seleccione la pestaña Administración de código fuente . Habilite Git y escriba la siguiente dirección URL para el valor de Dirección URL del repositorio : https://github.com/spring-guides/gs-spring-boot.git. A continuación, cambie el especificador de rama a */main.

    Definición del repositorio de Git

  4. Seleccione la pestaña Compilar y, a continuación, seleccione Agregar paso de compilación.

    Adición de un nuevo paso de compilación

  5. En el menú desplegable, seleccione Invocar script de Gradle.

    Seleccione la opción de script de Gradle.

  6. Seleccione Usar contenedor de Gradle y, a continuación, escriba complete en Ubicación del contenedor y build en Tareas.

    Opciones de script de Gradle

  7. Seleccione Avanzado y escriba complete en el campo Script de compilación raíz .

    Opciones avanzadas de script de Gradle

  8. Desplácese hasta la parte inferior de la página y seleccione Guardar.

6. Compilación de la aplicación Java de ejemplo

  1. Cuando se muestre la página principal del proyecto, seleccione Compilar ahora para compilar el código y empaquetar la aplicación de ejemplo.

    Página principal del proyecto

  2. Un gráfico situado debajo del encabezado Historial de compilación indica que se está compilando el trabajo.

    Compilación de trabajos en curso

  3. Cuando se complete la compilación, seleccione el vínculo Área de trabajo .

    Seleccione el vínculo del área de trabajo.

  4. Vaya a complete/build/libs para ver que el .jar archivo se ha compilado correctamente.

    La biblioteca de destino comprueba que la compilación se ha realizado correctamente.

  5. El servidor Jenkins ya está listo para crear sus propios proyectos en Azure.

Solución de problemas

Si tiene algún problema al configurar Jenkins, consulte la página de instalación de Jenkins para obtener las instrucciones más recientes y los problemas conocidos.

Pasos siguientes