2.5. Utiliser des stratégies de construction

Procédure

1. Définir un proxy HTTP personnalisé à utiliser lors de la construction :

   customStrategy:
   ...
     env:
       - name: "HTTP_PROXY"
         value: "http://myproxy.net:5187/"

   Copy to Clipboard Toggle word wrap

2. Pour gérer les variables d'environnement définies dans la configuration de la compilation, entrez la commande suivante :

   oc set env <enter_variables> $ oc set env <enter_variables>

   Copy to Clipboard Toggle word wrap

Procédure

1. Créer le master Jenkins :

     $ oc project <project_name>

   Copy to Clipboard Toggle word wrap

   Sélectionnez le projet que vous souhaitez utiliser ou créez un nouveau projet à l'aide de oc new-project <project_name>.

     $ oc new-app jenkins-ephemeral 

   1

   Copy to Clipboard Toggle word wrap

   Si vous souhaitez utiliser un stockage persistant, utilisez plutôt jenkins-persistent.

2. Créez un fichier nommé nodejs-sample-pipeline.yaml avec le contenu suivant :

   Note

   Cela crée un objet BuildConfig qui utilise la stratégie du pipeline Jenkins pour construire, déployer et mettre à l'échelle l'application d'exemple Node.js/MongoDB.

   kind: "BuildConfig"
   apiVersion: "v1"
   metadata:
     name: "nodejs-sample-pipeline"
   spec:
     strategy:
       jenkinsPipelineStrategy:
         jenkinsfile: <pipeline content from below>
       type: JenkinsPipeline

   Copy to Clipboard Toggle word wrap

3. Après avoir créé un objet BuildConfig à l'aide d'un objet jenkinsPipelineStrategy, vous indiquez au pipeline ce qu'il doit faire à l'aide d'un objet inline jenkinsfile:

   Note

   Cet exemple ne met pas en place un dépôt Git pour l'application.

   Le contenu suivant jenkinsfile est écrit en Groovy en utilisant le DSL OpenShift Container Platform. Pour cet exemple, incluez du contenu en ligne dans l'objet BuildConfig en utilisant le style littéral YAML, bien que l'inclusion d'un jenkinsfile dans votre référentiel source soit la méthode préférée.

   def templatePath = 'https://raw.githubusercontent.com/openshift/nodejs-ex/master/openshift/templates/nodejs-mongodb.json' 

   1

   
   def templateName = 'nodejs-mongodb-example' 

   2

   
   pipeline {
     agent {
       node {
         label 'nodejs' 

   3

   
       }
     }
     options {
       timeout(time: 20, unit: 'MINUTES') 

   4

   
     }
     stages {
       stage('preamble') {
           steps {
               script {
                   openshift.withCluster() {
                       openshift.withProject() {
                           echo "Using project: ${openshift.project()}"
                       }
                   }
               }
           }
       }
       stage('cleanup') {
         steps {
           script {
               openshift.withCluster() {
                   openshift.withProject() {
                     openshift.selector("all", [ template : templateName ]).delete() 

   5

   
                     if (openshift.selector("secrets", templateName).exists()) { 

   6

   
                       openshift.selector("secrets", templateName).delete()
                     }
                   }
               }
           }
         }
       }
       stage('create') {
         steps {
           script {
               openshift.withCluster() {
                   openshift.withProject() {
                     openshift.newApp(templatePath) 

   7

   
                   }
               }
           }
         }
       }
       stage('build') {
         steps {
           script {
               openshift.withCluster() {
                   openshift.withProject() {
                     def builds = openshift.selector("bc", templateName).related('builds')
                     timeout(5) { 

   8

   
                       builds.untilEach(1) {
                         return (it.object().status.phase == "Complete")
                       }
                     }
                   }
               }
           }
         }
       }
       stage('deploy') {
         steps {
           script {
               openshift.withCluster() {
                   openshift.withProject() {
                     def rm = openshift.selector("dc", templateName).rollout()
                     timeout(5) { 

   9

   
                       openshift.selector("dc", templateName).related('pods').untilEach(1) {
                         return (it.object().status.phase == "Running")
                       }
                     }
                   }
               }
           }
         }
       }
       stage('tag') {
         steps {
           script {
               openshift.withCluster() {
                   openshift.withProject() {
                     openshift.tag("${templateName}:latest", "${templateName}-staging:latest") 

   10

   
                   }
               }
           }
         }
       }
     }
   }

   Copy to Clipboard Toggle word wrap

   1

   Chemin du modèle à utiliser.

   1 2

   Nom du modèle qui sera créé.

   3

   Créer un pod d'agent node.js sur lequel exécuter ce build.

   4

   Définir un délai de 20 minutes pour ce pipeline.

   5

   Supprimer tout ce qui porte l'étiquette de ce modèle.

   6

   Supprimez tous les secrets portant cette étiquette de modèle.

   7

   Créez une nouvelle application à partir du site templatePath.

   8

   Attendez jusqu'à cinq minutes que la construction soit terminée.

   9

   Attendez jusqu'à cinq minutes que le déploiement soit terminé.

   10

   Si tout le reste a réussi, marquez l'image $ {templateName}:latest comme $ {templateName}-staging:latest. Une configuration de construction de pipeline pour l'environnement de mise à l'essai peut surveiller la modification de l'image $ {templateName}-staging:latest et la déployer ensuite dans l'environnement de mise à l'essai.

   Note

   L'exemple précédent a été écrit en utilisant le style de pipeline déclaratif, mais l'ancien style de pipeline scripté est également pris en charge.

4. Créez le Pipeline BuildConfig dans votre cluster OpenShift Container Platform :

   $ oc create -f nodejs-sample-pipeline.yaml

   Copy to Clipboard Toggle word wrap

   1. Si vous ne souhaitez pas créer votre propre fichier, vous pouvez utiliser l'exemple du référentiel Origin en exécutant :

      $ oc create -f https://raw.githubusercontent.com/openshift/origin/master/examples/jenkins/pipeline/nodejs-sample-pipeline.yaml

      Copy to Clipboard Toggle word wrap

5. Démarrer le pipeline :

   $ oc start-build nodejs-sample-pipeline

   Copy to Clipboard Toggle word wrap
   Note

   Vous pouvez également démarrer votre pipeline avec la console web d'OpenShift Container Platform en naviguant vers la section Builds Pipeline et en cliquant sur Start Pipeline, ou en visitant la console Jenkins, en naviguant vers le pipeline que vous avez créé et en cliquant sur Build Now.

   Une fois le pipeline lancé, vous devriez voir les actions suivantes se dérouler dans votre projet :

   • Une instance de travail est créée sur le serveur Jenkins.
   • Un module d'agent est lancé, si votre pipeline en nécessite un.

   • Le pipeline s'exécute sur le pod agent, ou sur le master si aucun agent n'est requis.

     • Toutes les ressources créées précédemment avec l'étiquette template=nodejs-mongodb-example seront supprimées.
     • Une nouvelle application et toutes ses ressources associées seront créées à partir du modèle nodejs-mongodb-example.

     • Une compilation sera lancée à l'aide de nodejs-mongodb-example BuildConfig .

       • Le pipeline attendra que la construction soit terminée pour déclencher l'étape suivante.

     • Un déploiement sera lancé à l'aide de la configuration de déploiement nodejs-mongodb-example.

       • Le pipeline attendra que le déploiement soit terminé pour déclencher l'étape suivante.
     • Si la construction et le déploiement sont réussis, l'image nodejs-mongodb-example:latest sera étiquetée comme nodejs-mongodb-example:stage.

   • Le pod de l'agent est supprimé, s'il était nécessaire pour le pipeline.

     Note

     La meilleure façon de visualiser l'exécution du pipeline est de l'afficher dans la console web d'OpenShift Container Platform. Vous pouvez visualiser vos pipelines en vous connectant à la console web et en naviguant vers Builds Pipelines.