JenkinsQueueJob@2 - Attività del processo di coda Jenkins v2

Usare questa attività per accodare un processo in un server Jenkins.

Sintassi

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #isMultibranchJob: false # boolean. Job is of multibranch pipeline type. Default: false.
    #multibranchPipelineBranch: # string. Required when isMultibranchJob = true. Multibranch pipeline branch. 
    #captureConsole: true # boolean. Capture console output and wait for completion. Default: true.
    #capturePipeline: true # boolean. Optional. Use when captureConsole = true. Capture pipeline output and wait for pipeline completion. Default: true.
  # Advanced
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

Input

serverEndpoint - Connessione al servizio Jenkins
string. Obbligatorio.

Specifica la connessione al servizio per l'istanza di Jenkins. Fare clic sul collegamento Gestisci per creare una nuova connessione al servizio Jenkins.

jobName - Nome processo
string. Obbligatorio.

Nome del processo Jenkins in coda. Deve corrispondere esattamente al nome del processo nel server Jenkins.

isMultibranchJob - Il processo è di tipo pipeline multibranch
boolean. Valore predefinito: false.

Questo processo è una pipeline multibranch. Se specificato, aggiungere il nome del ramo appropriato. Questo input richiede il plug-in Team Foundation Server per Jenkins v5.3.4 o versione successiva.

multibranchPipelineBranch - Ramo della pipeline multibranch
string. Obbligatorio quando isMultibranchJob = true.

Accoda questo processo della pipeline multibranch nel ramo specificato. Questo input richiede il plug-in Team Foundation Server per Jenkins v5.3.4 o versione successiva.

captureConsole - Acquisire l'output della console e attendere il completamento
boolean. Valore predefinito: true.

Se specificato, questo input acquisisce l'output della console di compilazione Jenkins, attende il completamento della compilazione Jenkins e non riesce in base al risultato della compilazione Jenkins. In caso contrario, dopo aver completato le code dei processi Jenkins, questa attività viene completata senza attendere l'esecuzione della compilazione Jenkins.

capturePipeline - Acquisire l'output della pipeline e attendere il completamento della pipeline
boolean. facoltativo. Usare quando captureConsole = true. Valore predefinito: true.

Se specificato, questa attività acquisisce l'output completo della console della pipeline di compilazione Jenkins, attende il completamento della pipeline di compilazione Jenkins completa e non riesce in base al risultato della pipeline di compilazione Jenkins. In caso contrario, una volta completato il primo processo Jenkins, questa attività viene completata senza attendere l'esecuzione della pipeline di compilazione Jenkins completa.

isParameterizedJob - Processo con parametri
Alias di input: parameterizedJob. boolean. Valore predefinito: false.

Specifica se il processo Jenkins accetta parametri. Usare questo input anche se vengono usati tutti i valori dei parametri predefiniti e non vengono effettivamente specificati parametri.

jobParameters - Parametri del processo
string. facoltativo. Usare quando parameterizedJob = true.

Specifica i parametri del processo, con una per riga, nel formato di <parameterName>=<parameterValue>.

Per impostare un parametro su un valore vuoto, utile per eseguire l'override di un valore predefinito, lasciare disattivato il valore del parametro. Ad esempio, specificare parameterName=.

Le variabili sono supportate. Per impostare un commitId valore di parametro sull'ID commit Git della compilazione, ad esempio, è possibile usare: commitId=$(Build.SourceVersion). Per altre informazioni, vedere la documentazione sulle variabili.

I tipi di parametri Jenkins supportati sono:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Esito negativo sul risultato instabile
boolean. Valore predefinito: false.

Specifica la rigidità di una definizione di esito positivo o se considerare l'instabile come errore o meno. Il false valore è per una versione non rigorosa e per true una versione rigorosa. Se impostato su true, un risultato di compilazione instabile viene considerato come errore. In caso contrario, un risultato instabile viene considerato come esito positivo.

retryCount - Numero di tentativi per la connessione non riuscita
string. Valore predefinito: 3.

Specifica la quantità di tentativi di connessione quando si verifica un errore o un errore di connessione.

delayBetweenRetries - Tempo tra tentativi
string. Valore predefinito: 60.

Specifica la quantità di tempo tra tentativi di connessione quando si verifica un errore. Il valore è espresso in secondi.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Questa attività definisce le variabili di output seguenti, che è possibile usare nei passaggi, nei processi e nelle fasi downstream.

JENKINS_JOB_ID
ID dell'istanza del processo Jenkins accodata da questa attività. Usare questa variabile nell'attività Jenkins Download Artifacts per scaricare gli artefatti per questa particolare istanza del processo.

Commenti

Usare questa attività per accodare un processo in un server Jenkins.

Team Foundation Server Plug-in

È possibile usare il plug-in di Team Foundation Server (versione 5.2.0 o successiva) per raccogliere automaticamente i file dall'area di lavoro Jenkins e scaricarli nella compilazione.

Per configurarlo:

1. Installare il plug-in Team Foundation Server nel server Jenkins.

2. Nel server Jenkins, per ogni processo da cui si desidera raccogliere i risultati, aggiungere i risultati raccogliere i risultati per l'azione post-compilazione di Azure Pipelines/TFS e quindi configurarla con una o più coppie di tipo di risultato e includere il modello di file.

3. Nel processo di coda Jenkins, l'attività di compilazione abilita l'output della console di acquisizione e attende il completamento per raccogliere i risultati dal processo a livello radice oppure l'output della pipeline di acquisizione e attendere il completamento della pipeline per raccogliere i risultati da tutti i processi della pipeline.

I risultati verranno scaricati in $(Build.StagingDirectory)/jenkinsResults/Nome processo/team-results.zip ed estratti in questa posizione. Ogni set di tipi di risultati raccolti dal plug-in sarà nella directory dei risultati del team, $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Si tratta della directory in cui è possibile pubblicare i risultati della compilazione da attività downstream, ad esempio Pubblica risultati test e Pubblica risultati code coverage.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.144.0 o versione successiva
Categoria attività	Compilazione