diff --git a/README.md b/README.md index c43538b7013e35d68c831a249c4325d0adc18b45..1cd275bf80ad192a81831fd5dff651f07e2bae5a 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,7 @@ - [Installation de Jenkins](#installation-de-jenkins) - [Configuration de base Jenkins et de GitLab](#configuration-de-base-jenkins-et-de-gitlab) - [Liaison de Jenkins et de GitLab](#liaison-de-jenkins-et-de-gitlab) + - [Intégration de Jenkins dans Gitlab](#intégration-de-jenkins-dans-gitlab) - [Technologies utilisées](#technologies-utilisées) - [Sources](#sources) @@ -87,12 +88,12 @@ This message shows that your installation appears to be working correctly. ### Installation de Jenkins -Dans un premier temps, on cherche une image ubuntu (TODO ???) +Dans un premier temps, on cherche une image ubuntu ```shell sudo docker search ubuntu ``` -Ensuite on télécharge l'image de jenkins (TODO ???) +Ensuite on télécharge l'image de jenkins ```shell sudo docker pull jenkins ``` @@ -184,13 +185,13 @@ Dans le cadre de notre tutoriel, Nous allons reprendre ce projet (JenkinsGit) Av Copiez le lien de votre projet : -![5](img/5_ProjectLink.png) +![5](img/linkGit.png) Sur l'interface graphique de jenkins au moment de la configuration d'un projet. Allez sur "Gestion de code source" et cliquez sur "Git" Puis collez le lien git sur "Repository URL" -![6](img/6_PasterProjectLink.png) +![6](/img/lien2Git.png) Plus bas dans le formulaire, dans la section "Build", selectionner l'option "Ajouter un script shell" puis ajoutez vos tests. Dans notre cas (un simple test de compilation java) le script est @@ -204,8 +205,80 @@ Puis confirmer le formulaire Allez ensuite sur Projet > Espace de travail > Lancer un build -*TODO* continue - +### Intégration de Jenkins dans Gitlab + +#### Plugin Requis + +- Jenkins GitLab Plugin +- Jenkins Git Plugin +- Jenkins GitLab Hook plugin + +Premièrement, nous devons créer un utilisateur qui permettras a jenkins d'interagir avec l'api gitlab. +Cet utilisateur doit avoir les permissions admin sur le projet. + +Ouvrir gitlab et aller dans "Setting" + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_5887647780067.png) + +Ensuite, cliquer sur "Access Token" et créer un "token jenkins API" + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_5887659c22e47-768x382.png) + +Sauvegarder et copier "API token". + +#### Configurer le serveur Jenkins + +Aller sur Jenkins et installer "Jenkins Gitlab Plugin" et "Jenkins Git Plugin". + +Aller dans "Manage Jenkins -> Configure System" et descendre dans la section GitLab. + +Ecrire l'URL du serveur GitLab et l'ajouter. + +Puis remplir les champs obligatoires comme sur l'image ci-dessous. + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_588767665356d.png) + +Selectioner "API Token credential" et cliquer sur test, un message succés devrait s'afficher. + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_588737bc65552-1024x268.png) + +#### Créer et configurer un projet Jenkins + +Créer un nouveau projet et cliquer sur configurer. + +Donnez lui un nom, selectionner "Discard old builds" et ecrire "3" pour “Max # of builds to keep“. +Pour le champs “GitLab connection” selectionner "predefined connection" qui a été crée avec le plugin GitLab. +Pour Gitlab Repository Name” ecrire “/“. + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_58873b96ecb71-1024x267.png) + +Puis aller dans "Credentials –> System –> “Add domain”" et cliquer sur "Add credentials". + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_5887400703fc1.png) + +Puis ajouter votre id et mots de passe GitLab. + +Ensuite sélectionner Git comme "Source Code Management" et remplire les champs comme sur l'image. + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_58874682d686d-1024x451.png) + +#### Build Triggers +Pour la partis build trigers vous pouvez faire comme sur l'image. + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_5888b78b783a0-800x453.png) + +Et enfin nous devrions ajouter “Publish build status to GitLab commit” pour accéder à des feedbacks. + +![alt text](https://www.swtestacademy.com/wp-content/uploads/2017/01/img_5888b85218b82.png) + +Pour l'integration aller sur votre projet GitLab -> Setting -> intégrations. +Ajouter votre lien Jenkins. +Vous pouvez maintenant faire un test de connection. + + +Malheuresement l'intégration n'est possible que pour un serveur non Local nous n'avons +donc pas pu réaliser cette partie. + ## Technologies utilisées - [Docker](https://www.docker.com/)