Sdílet prostřednictvím


JenkinsQueueJob@1 – Úloha fronty Jenkinse v1

Pomocí této úlohy můžete zařadit úlohu do fronty na server Jenkinse.

Syntax

# Jenkins Queue Job v1
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@1
  inputs:
    serverEndpoint: # string. Required. Jenkins service endpoint. 
    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
    #parameterizedJob: false # boolean. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters.

Vstupy

serverEndpoint - Koncový bod služby Jenkins
string. Povinná hodnota.

Určuje koncový bod služby pro vaši instanci Jenkinse. Kliknutím na odkaz Spravovat (při použití asistent úlohy) vytvořte nový koncový bod služby Jenkinse.


jobName - Název úlohy
string. Povinná hodnota.

Název úlohy Jenkinse, která se má zařadit do fronty. Musí přesně odpovídat názvu úlohy na serveru Jenkins.


isMultibranchJob - Úloha je typu Víceoborový kanál.
boolean. Výchozí hodnota: false.

Tato úloha je víceoborový kanál. Pokud je zadaný, přidejte odpovídající název větve. Tento vstup vyžaduje modul plug-in Team Foundation Serveru pro Jenkins verze 5.3.4 nebo novější.


multibranchPipelineBranch - Vícebranová větev kanálu
string. Vyžaduje se, když isMultibranchJob = true.

Zařadí tuto úlohu kanálu s více obory do fronty v zadané větvi. Tento vstup vyžaduje modul plug-in Team Foundation Serveru pro Jenkins verze 5.3.4 nebo novější.


captureConsole - Zachytávání výstupu konzoly a čekání na dokončení
boolean. Výchozí hodnota: true.

Pokud je zadaný, tento vstup zaznamená výstup konzoly sestavení Jenkinse, počká na dokončení sestavení Jenkinse a na základě výsledku sestavení Jenkinse dojde k úspěšnému/selhání. V opačném případě se po frontě úlohy Jenkinse tento krok úspěšně dokončí bez čekání na spuštění sestavení Jenkinse.


capturePipeline - Výstup kanálu zachycení a čekání na dokončení kanálu
boolean. Nepovinný parametr. Použijte, když captureConsole = true. Výchozí hodnota: true.

Pokud je zadaný, tento vstup zaznamená úplný výstup konzoly kanálu sestavení Jenkinse, čeká na dokončení úplného kanálu sestavení Jenkinse a na základě výsledku kanálu sestavení Jenkinse dojde k úspěšnému nebo selhání. V opačném případě se po dokončení první úlohy Jenkinse tento vstup úspěšně dokončí bez čekání na spuštění celého kanálu sestavení Jenkinse.


parameterizedJob - Parametrizovaná úloha
boolean. Výchozí hodnota: false.

Určuje, jestli úloha Jenkinse přijímá parametry. Tento vstup použijte i v případě, že jsou použity všechny výchozí hodnoty parametrů a nejsou ve skutečnosti zadány žádné parametry.


jobParameters - Parametry úlohy
string. Nepovinný parametr. Použijte, když parameterizedJob = true.

Určuje parametry úlohy s jedním na řádek, například : <parameterName>=<parameterValue>.

Chcete-li nastavit parametr na prázdnou hodnotu, což je užitečné pro přepsání výchozí hodnoty, ponechte hodnotu parametru. Zadejte <parameterName>=například .

Proměnné jsou podporovány. Pokud chcete například nastavit commitId hodnotu parametru na ID potvrzení Gitu sestavení, můžete použít: commitId=$(Build.SourceVersion). Další informace najdete v dokumentaci k proměnným.

Podporované typy parametrů Jenkinse jsou:

  • Boolean
  • Choice
  • Password
  • String

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta Všechny podporované verze agenta.
Kategorie úloh Sestavení