Prise en main : Installer Jenkins sur une machine virtuelle Linux Azure

Cet article explique comment installer Jenkins sur une machine virtuelle Linux Ubuntu avec les outils et plug-ins configurés pour fonctionner avec Azure.

Dans cet article, vous allez apprendre à :

• Créer un fichier d’installation qui télécharge et installe Jenkins
• Créer un groupe de ressources
• Créer une machine virtuelle avec le fichier d’installation
• Ouvrez le port 8080 pour accéder à Jenkins sur la machine virtuelle
• Se connecter à la machine virtuelle via SSH
• Configurer un exemple de travail Jenkins basé sur un exemple d’application Java dans GitHub
• Créer l'exemple de tâche Jenkins

1. Configurer votre environnement

• Abonnement Azure : si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

2. Ouvrir Cloud Shell

1. Si vous disposez déjà d’une session Cloud Shell ouverte, vous pouvez passer à la section suivante.

2. Accédez au portail Azure

3. Si nécessaire, connectez-vous à votre abonnement Azure et modifiez l’annuaire Azure.

4. Ouvrez Cloud Shell.

   

5. Si vous n’avez pas déjà utilisé Cloud Shell, configurez les paramètres d’environnement et de stockage.

6. Sélectionnez l’environnement de ligne de commande.

   

3. Créer une machine virtuelle

1. Créez un répertoire de test appelé jenkins-get-started.

2. Basculez vers le répertoire de test.

3. Créez un fichier appelé cloud-init-jenkins.txt.

4. Collez le code suivant dans le nouveau fichier :

   #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. Exécutez az group create pour créer un groupe de ressources.

   az group create --name jenkins-get-started-rg --location eastus
   

6. Exécutez az vm create pour créer une machine virtuelle.

   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. Exécutez az vm list pour vérifier la création (et l’état) de la nouvelle machine virtuelle.

   az vm list -d -o table --query "[?name=='jenkins-get-started-vm']"
   

8. Lorsque Jenkins s’exécute sur le port 8080, exécutez az vm open pour ouvrir le port 8080 sur la nouvelle machine virtuelle.

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

4. Configurer Jenkins

1. Exécutez az vm show pour obtenir l’adresse IP publique de l’exemple de machine virtuelle.

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

   Points essentiels :

   • Le --query paramètre limite la sortie aux adresses IP publiques de la machine virtuelle.

2. À l’aide de l’adresse IP récupérée à l’étape précédente, connectez-vous en SSH à la machine virtuelle. Vous devez confirmer la demande de connexion.

   ssh azureuser@<ip_address>
   

   Points essentiels :

   • Une fois la connexion réussie, l’invite Cloud Shell inclut le nom d’utilisateur et le nom de la machine virtuelle : azureuser@jenkins-get-started-vm.

3. Vérifiez que Jenkins est en cours d’exécution en obtenant l’état du service Jenkins.

   service jenkins status
   

   Points essentiels :

   • Si vous recevez une erreur concernant le service non existant, vous devrez peut-être attendre quelques minutes pour que tout soit installé et initialisé.

4. Obtenez le mot de passe Jenkins généré automatiquement.

   sudo cat /var/lib/jenkins/secrets/initialAdminPassword
   

5. À l’aide de l’adresse IP, ouvrez l’URL suivante dans un navigateur : http://<ip_address>:8080

6. Entrez le mot de passe que vous avez récupéré précédemment, puis sélectionnez Continuer.

   

7. Sélectionnez Sélectionner le plug-in à installer.

   

8. Dans la zone de filtre en haut de la page, entrez github. Sélectionnez le plug-in GitHub, puis sélectionnez Installer.

   

9. Entrez les informations du premier utilisateur administrateur, puis sélectionnez Enregistrer et Continuer.

   

10. Dans la page Configuration de l’instance , sélectionnez Enregistrer et Terminer.

    

11. Sélectionnez Démarrer à l’aide de Jenkins.

    

5. Créer votre premier travail

1. Dans la page d’accueil Jenkins, sélectionnez Créer un travail.

   

2. Entrez un nom de travail , mySampleAppsélectionnez Projet Freestyle, puis sélectionnez OK.

   

3. Sélectionnez l’onglet Gestion du code source . Activez Git et entrez l’URL suivante pour la valeur de l’URL du référentiel : https://github.com/spring-guides/gs-spring-boot.git. Ensuite, remplacez le spécificateur de branche par */main.

   

4. Sélectionnez l’onglet Générer , puis sélectionnez Ajouter une étape de génération

   

5. Dans le menu déroulant, sélectionnez Appeler le script Gradle.

   

6. Sélectionnez Utiliser le Wrapper Gradle, puis entrez complete dans Emplacement du wrapper et build pour les Tâches.

   

7. Sélectionnez Avancé et entrez complete dans le champ Script de build racine.

   

8. Faites défiler vers le bas de la page, puis sélectionnez Enregistrer.

6. Générer l’exemple d’application Java

1. Lorsque la page d’accueil de votre projet s’affiche, sélectionnez Générer maintenant pour compiler le code et empaqueter l’exemple d’application.

   

2. Un graphique sous le titre Historique de compilation montre que la tâche est en cours de compilation.

   

3. Une fois la build terminée, sélectionnez le lien Espace de travail .

   

4. Naviguez jusqu'à complete/build/libs pour voir que le fichier .jar a été correctement généré.

   

5. Votre serveur Jenkins est maintenant prêt à créer vos propres projets dans Azure !

Résolution des problèmes

Si vous rencontrez des problèmes lors de la configuration de Jenkins, reportez-vous à la page d’installation jenkins pour connaître les dernières instructions et les problèmes connus.

Étapes suivantes