resources.pipelines.pipeline definition

Se si dispone di un oggetto Azure Pipeline che produce artefatti, la pipeline può usare gli artefatti definendo una risorsa della pipeline. In Azure DevOps Server 2020 e versioni successive è anche possibile abilitare i trigger di completamento della pipeline usando una risorsa della pipeline.

pipelines:
- pipeline: string # Required as first property. ID of the pipeline resource.
  project: string # Project for the source; defaults to current project.
  source: string # Name of the pipeline that produces the artifact.
  version: string # The pipeline run number to pick the artifact, defaults to latest pipeline successful across all stages; used only for manual or scheduled triggers.
  branch: string # Branch to pick the artifact. Optional; defaults to all branches, used only for manual or scheduled triggers.
  tags: [ string ] # List of tags required on the pipeline to pickup default artifacts. Optional; used only for manual or scheduled triggers.
  trigger:  # Specify none to disable, true to include all branches, or use the full syntax as described in the following examples.
    enabled: boolean # Whether the trigger is enabled; defaults to true.
    branches: branches # Branches to include or exclude for triggering a run.
    stages: [ string ] # List of stages that when matched will trigger the pipeline.
    tags: [ string ] # List of tags that when matched will trigger the pipeline.

pipelines:
- pipeline: string # Required as first property. ID of the pipeline resource.
  project: string # Project for the source; defaults to current project.
  source: string # Name of the pipeline that produces the artifact.
  version: string # The pipeline run number to pick the artifact, defaults to latest pipeline successful across all stages; used only for manual or scheduled triggers.
  branch: string # Branch to pick the artifact. Optional; defaults to all branches, used only for manual or scheduled triggers.
  tags: [ string ] # List of tags required on the pipeline to pickup default artifacts. Optional; used only for manual or scheduled triggers.
  trigger:  # Specify none to disable, true to include all branches, or use the full syntax as described in the following examples.
    enabled: boolean # Whether the trigger is enabled; defaults to true.
    branches: branches # Branches to include or exclude for triggering a run.

pipelines:
- pipeline: string # Required as first property. ID of the pipeline resource.
  project: string # Project for the source; defaults to current project.
  source: string # Name of the pipeline that produces the artifact.
  version: string # The pipeline run number to pick the artifact, defaults to latest pipeline successful across all stages; used only for manual or scheduled triggers.
  branch: string # Branch to pick the artifact. Optional; defaults to all branches, used only for manual or scheduled triggers.

Definizioni che fanno riferimento a questa definizione: resources.pipelines

pipeline Stringa. Obbligatorio come prima proprietà.
ID della risorsa della pipeline. Valori accettabili: [-_A-Za-z0-9]*.

project Stringa.
Progetto per l'origine; impostazione predefinita per il progetto corrente.

source Stringa.
Nome della pipeline che produce l'artefatto. Se la pipeline è contenuta in una cartella, includere il nome della cartella, incluso l'elemento iniziale \, ad esempio \security pipelines\security-lib-ci. Questa proprietà non è distinzione tra maiuscole e minuscole e non richiede virgolette se il nome include spazi. Il percorso della cartella deve essere specificato se sono presenti più pipeline con lo stesso nome.

version Stringa.
Numero di esecuzione della pipeline per selezionare l'artefatto, impostazione predefinita per la pipeline più recente riuscita in tutte le fasi; usato solo per trigger manuali o pianificati.

branch Stringa.
Ramo per selezionare l'artefatto. Opzionale; impostazione predefinita per tutti i rami, usata solo per i trigger manuali o pianificati.

tags elenco di stringhe.
Elenco di tag necessari nella pipeline per recuperare gli artefatti predefiniti. Opzionale; usato solo per trigger manuali o pianificati.

triggerresources.pipelines.pipeline.trigger.
Specificare nessuno per disabilitare, true per includere tutti i rami o usare la sintassi completa come descritto negli esempi seguenti.

Per altre informazioni su stages e tags nel trigger di risorse della pipeline, vedere trigger di completamento della pipeline.

Per altre informazioni sui trigger delle risorse della pipeline, vedere trigger di completamento della pipeline.

Sintassi del trigger di risorse della pipeline

Esistono diversi modi per definire i trigger in una risorsa della pipeline. Per attivare un'esecuzione quando viene completata qualsiasi esecuzione della pipeline a cui si fa riferimento, usare trigger: true.

resources:
  pipelines:
  - pipeline: source-pipeline
    source: TriggeringPipeline
    trigger: true

Per disabilitare il trigger della risorsa della pipeline, specificare un valore di none.

resources:
  pipelines:
  - pipeline: source-pipeline
    source: TriggeringPipeline
    trigger: none

Per configurare i filtri di ramo, usare la sintassi completa. I filtri ramo possono essere specificati come elenco di rami da includere o come elenco di rami da includere in combinazione con un elenco di rami da escludere.

Per specificare un elenco di rami da includere ed escludere, usare la sintassi seguente trigger .

resources:
  pipelines:
  - pipeline: source-pipeline
    source: TriggeringPipeline
    trigger:
      branches:
        include:
        - main
        - develop
        - features/*
        exclude:
        - features/experimental/*

Per specificare un elenco di rami da includere, senza escludere, omettere il exclude valore o usare la sintassi seguente per specificare l'elenco di rami da includere direttamente in seguito branches.

resources:
  pipelines:
  - pipeline: source-pipeline
    source: TriggeringPipeline
    trigger:
      branches:
      - main
      - develop

Per filtrare in base a fasi o tag, usare la sintassi seguente trigger .

resources:
  pipelines:
  - pipeline: source-pipeline
    source: TriggeringPipeline
    trigger:
      branches: # Branches to include
      tags: # List of tags that when matched will trigger the pipeline. 
      - release25
      stages: # List of stages that when complete will trigger the pipeline. 
      - build

Per altre informazioni, vedere Trigger di completamento della pipeline.

Metadati delle risorse della pipeline come variabili predefinite

In ogni esecuzione i metadati per una risorsa della pipeline sono disponibili per tutti i processi come variabili predefinite seguenti. Queste variabili sono disponibili per la pipeline in fase di esecuzione e pertanto non possono essere usate nelle espressioni di modello, valutate in fase di compilazione della pipeline.

resources.pipeline.<Alias>.projectName
resources.pipeline.<Alias>.projectID
resources.pipeline.<Alias>.pipelineName
resources.pipeline.<Alias>.pipelineID
resources.pipeline.<Alias>.runName
resources.pipeline.<Alias>.runID
resources.pipeline.<Alias>.runURI
resources.pipeline.<Alias>.sourceBranch
resources.pipeline.<Alias>.sourceCommit
resources.pipeline.<Alias>.sourceProvider
resources.pipeline.<Alias>.requestedFor
resources.pipeline.<Alias>.requestedForID

Sostituire <Alias> con l'ID della risorsa della pipeline. Per la risorsa pipeline seguente, la variabile da accedere runID è resources.pipeline.source-pipeline.runID.

resources:
  pipelines:
  - pipeline: source-pipeline
    source: TriggeringPipeline

Quando una pipeline viene attivata da una delle relative risorse della pipeline, le variabili seguenti vengono impostate oltre alle variabili nell'elenco precedente.

Nell'esempio seguente sono disponibili due risorse della pipeline.

resources:
 pipelines:
   - pipeline: source-pipeline
     source: PipelineTriggerSource
     project: FabrikamFiber
     trigger: true
   - pipeline: other-project-pipeline
     source: PipelineTriggerFromOtherProject
     project: FabrikamRepo
     trigger: true

trigger: none # Only trigger with pipeline resource trigger

pool:
  vmImage: ubuntu-latest

- bash: echo $(resources.pipeline.source-pipeline.projectName)
- bash: printenv | sort

Whe questa pipeline viene eseguita, la prima bash attività restituisce l'oggetto projectName della risorsa della pipeline denominata source-pipeline, ovvero FabrikamFiber.

La seconda bash attività restituisce tutte le variabili di ambiente disponibili per l'attività, incluse le variabili di risorsa della pipeline descritte in questa sezione. La presentazione delle variabili di ambiente non viene in genere eseguita in una pipeline di produzione, ma può essere utile per la risoluzione dei problemi. In questo esempio sono presenti due risorse della pipeline e l'output contiene le due righe seguenti.

RESOURCES_PIPELINE_OTHER-PROJECT-PIPELINE_PROJECTNAME=FabrikamRepo
RESOURCES_PIPELINE_SOURCE-PIPELINE_PROJECTNAME=FabrikamFiber