Comment puis-je déclencher la construction d'un autre travail depuis le Jenkinsfile?

Je suppose que ce travail est un autre référentiel sous la même organisation github , qui a déjà son propre fichier Jenkins.

Je souhaite également le faire uniquement si le nom de la branche est master, car cela n'a pas de sens de déclencher des builds en aval de branches locales.

Mettre à jour:

stage 'test-downstream'
node {
     def job = build job: 'some-downtream-job-name'
}

Pourtant, une fois exécuté, j'obtiens une erreur

Aucun travail paramétré nommé some-downtream-job-name trouvé

Je suis sûr que ce travail existe chez jenkins et se trouve dans le même dossier d'organisation que l'actuel. C'est un autre travail qui a le sien Jenkinsfile.

Veuillez noter que cette question est spécifique au plugin d'organisation GitHub qui crée et gère automatiquement des tâches pour chaque référentiel et branche de votre organisation GitHub.

Tout d'abord, c'est un gaspillage d'un emplacement d'exécuteur pour encapsuler l' buildétape node. Votre exécuteur testamentaire en amont restera inactif sans raison.

Deuxièmement, à partir d'un projet multibranch, vous pouvez utiliser la variable d'environnement BRANCH_NAMEpour rendre la logique conditionnelle à la branche actuelle.

Troisièmement, le jobparamètre prend un nom de travail absolu ou relatif. Si vous donnez un nom sans aucune qualification de chemin, cela ferait référence à un autre travail dans le même dossier, ce qui dans le cas d'un projet multibranch signifierait une autre branche du même référentiel.

Ainsi, ce que vous vouliez écrire est probablement

if (env.BRANCH_NAME == 'master') {
    build '../other-repo/master'
}

En plus des réponses mentionnées ci-dessus: je voulais démarrer un travail avec un simple paramètre passé à un deuxième pipeline et j'ai trouvé la réponse sur https://dzone.com/refcardz/continuous-delivery-with-jenkins-workflow .

J'ai donc utilisé:

stage ('Starting ART job') {
    build job: 'RunArtInTest', parameters: [[$class: 'StringParameterValue', name: 'systemname', value: systemname]]
}

La commande builden pipeline est là pour déclencher d'autres travaux dans jenkins.

Exemple sur github

Le travail doit exister dans Jenkins et peut être paramétré. Quant à la branche, je suppose que vous pouvez la lire à partir de git

Vous pouvez utiliser l' build jobétape de Jenkins Pipeline (minimum Jenkins requis: 2.130).

Voici l'API complète pour l' buildétape: https://jenkins.io/doc/pipeline/steps/pipeline-build-step/

Comment utiliser build:

• job: Nom d'un travail en aval à générer. Peut-être un autre travail Pipeline, mais plus communément un projet freestyle ou autre.
  • Utilisez un nom simple si le travail se trouve dans le même dossier que ce travail de pipeline en amont;
  • Vous pouvez à la place utiliser des chemins relatifs comme../sister-folder/downstream
  • Ou vous pouvez utiliser des chemins absolus comme/top-level-folder/nested-folder/downstream

Déclenchez un autre travail en utilisant une branche comme paramètre

Dans mon entreprise, plusieurs de nos succursales incluent "/". Vous devez remplacer toutes les instances de "/" par "% 2F" (tel qu'il apparaît dans l'URL du travail).

Dans cet exemple, nous utilisons des chemins relatifs

    stage('Trigger Branch Build') {
        steps {
            script {
                    echo "Triggering job for branch ${env.BRANCH_NAME}"
                    BRANCH_TO_TAG=env.BRANCH_NAME.replace("/","%2F")
                    build job: "../my-relative-job/${BRANCH_TO_TAG}", wait: false
            }
        }
    }

Déclenchez un autre travail en utilisant le numéro de build comme paramètre

build job: 'your-job-name', 
    parameters: [
        string(name: 'passed_build_number_param', value: String.valueOf(BUILD_NUMBER)),
        string(name: 'complex_param', value: 'prefix-' + String.valueOf(BUILD_NUMBER))
    ]

Déclenchez de nombreux emplois en parallèle

Source: https://jenkins.io/blog/2017/01/19/converting-conditional-to-pipeline/

Plus d'informations sur Parallel ici: https://jenkins.io/doc/book/pipeline/syntax/#parallel

    stage ('Trigger Builds In Parallel') {
        steps {
            // Freestyle build trigger calls a list of jobs
            // Pipeline build() step only calls one job
            // To run all three jobs in parallel, we use "parallel" step
            // https://jenkins.io/doc/pipeline/examples/#jobs-in-parallel
            parallel (
                linux: {
                    build job: 'full-build-linux', parameters: [string(name: 'GIT_BRANCH_NAME', value: env.BRANCH_NAME)]
                },
                mac: {
                    build job: 'full-build-mac', parameters: [string(name: 'GIT_BRANCH_NAME', value: env.BRANCH_NAME)]
                },
                windows: {
                    build job: 'full-build-windows', parameters: [string(name: 'GIT_BRANCH_NAME', value: env.BRANCH_NAME)]
                },
                failFast: false)
        }
    }

Ou bien:

    stage('Build A and B') {
            failFast true
            parallel {
                stage('Build A') {
                    steps {
                            build job: "/project/A/${env.BRANCH}", wait: true
                    }
                }
                stage('Build B') {
                    steps {
                            build job: "/project/B/${env.BRANCH}", wait: true
                    }
                }
            }
    }

Utilisez le plugin de travail de construction pour cette tâche afin de déclencher d'autres travaux à partir du fichier jenkins. Vous pouvez ajouter une variété de logique à votre exécution, comme des options parallèles, des nœuds et des agents et des étapes de déclenchement de travaux externes. J'ai donné un exemple de livre de cuisine facile à lire pour cela.

1. exemple de déclenchement d'une tâche externe à partir d'un fichier jenkins avec exemple conditionnel:

if (env.BRANCH_NAME == 'master') {
  build job:'exactJobName' , parameters:[
    string(name: 'keyNameOfParam1',value: 'valueOfParam1')
    booleanParam(name: 'keyNameOfParam2',value:'valueOfParam2')
 ]
}

2. exemple de déclenchement de plusieurs tâches à partir du fichier jenkins avec exemple conditionnel:

 def jobs =[
    'job1Title'{
    if (env.BRANCH_NAME == 'master') {
      build job:'exactJobName' , parameters:[
        string(name: 'keyNameOfParam1',value: 'valueNameOfParam1')
        booleanParam(name: 'keyNameOfParam2',value:'valueNameOfParam2')
     ]
    }
},
    'job2Title'{
    if (env.GIT_COMMIT == 'someCommitHashToPerformAdditionalTest') {
      build job:'exactJobName' , parameters:[
        string(name: 'keyNameOfParam3',value: 'valueOfParam3')
        booleanParam(name: 'keyNameOfParam4',value:'valueNameOfParam4')
        booleanParam(name: 'keyNameOfParam5',value:'valueNameOfParam5')
     ]
    }
}