Delen via


definitie van pipeline.parameters.parameter

Een parameter vertegenwoordigt een waarde die is doorgegeven aan een pijplijn.

parameters:
- name: string # Required as first property.
  displayName: string # Human-readable name for the parameter.
  type: string
  default: string | parameters | [ parameters ]
  values: [ string ]

Definities die naar deze definitie verwijzen: parameters

Eigenschappen

name Tekenreeks. Vereist als eerste eigenschap.

displayName Tekenreeks.
Door mensen leesbare naam voor de parameter.

type Tekenreeks.
Zie typen.

type Tekenreeks.
booleaanse | implementatie | deploymentList | omgeving | filePath | taak | jobList | getal | object | pool | secureFile | serviceConnection | fase | stageList | stap | stepList | Tekenreeks.

default Parameters.

values tekenreekslijst.

Opmerkingen

De type- en naamvelden zijn vereist bij het definiëren van parameters. Bekijk alle parametergegevenstypen.

parameters:
- name: string          # name of the parameter; required
  type: enum            # see the enum data types in the following section
  default: any          # default value; if no default, then the parameter MUST be given by the user at runtime
  values: [ string ]    # allowed list of values (for some data types)

Typen

De type waarde moet een van de enum leden uit de volgende tabel zijn.

Gegevenstype Notities
string tekenreeks
number kan worden beperkt tot values:, anders wordt elke getalachtige tekenreeks geaccepteerd
boolean true of false
object elke YAML-structuur
step één stap
stepList reeks stappen
job één taak
jobList reeks taken
deployment één implementatietaak
deploymentList volgorde van implementatietaken
stage één fase
stageList opeenvolging van fasen

De gegevenstypen step, stepList, job, jobList, deploymentList, stage en stageList gebruiken allemaal de standaard YAML-schema-indeling. Dit voorbeeld omvat tekenreeks, getal, booleaanse waarde, object, stap en stepList.

parameters:
- name: myString
  type: string
  default: a string
- name: myMultiString
  type: string
  default: default
  values:
  - default
  - ubuntu
- name: myNumber
  type: number
  default: 2
  values:
  - 1
  - 2
  - 4
  - 8
  - 16
- name: myBoolean
  type: boolean
  default: true
- name: myObject
  type: object
  default:
    foo: FOO
    bar: BAR
    things:
    - one
    - two
    - three
    nested:
      one: apple
      two: pear
      count: 3
- name: myStep
  type: step
  default:
    script: echo my step
- name: mySteplist
  type: stepList
  default:
    - script: echo step one
    - script: echo step two

trigger: none

jobs: 
- job: stepList
  steps: ${{ parameters.mySteplist }}
- job: myStep
  steps:
    - ${{ parameters.myStep }}

Voorbeelden

# File: azure-pipelines.yml
parameters:
- name: image
  displayName: Pool Image
  type: string
  default: ubuntu-latest
  values:
  - windows-latest
  - ubuntu-latest
  - macOS-latest

trigger: none

jobs:
- job: build
  displayName: build
  pool: 
    vmImage: ${{ parameters.image }}
  steps:
  - script: echo The image parameter is ${{ parameters.image }}```

U kunt parameters gebruiken om een sjabloon uit te breiden. In dit voorbeeld levert de pijplijn met behulp van de sjabloon de waarden die in de sjabloon moeten worden ingevuld.

# File: simple-param.yml
parameters:
- name: yesNo # name of the parameter; required
  type: boolean # data type of the parameter; required
  default: false

steps:
- script: echo ${{ parameters.yesNo }}
# File: azure-pipelines.yml
trigger:
- main

extends:
    template: simple-param.yml
    parameters:
        yesNo: false # set to a non-boolean value to have the build fail

Zie ook

Zie sjablonen voor meer informatie over het werken met sjablonen.