PythonScript@0 – Python-Skript v0-Aufgabe

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um eine Python-Datei oder ein Inlineskript auszuführen.

Syntax

# Python script v0
# Run a Python file or inline script.
- task: PythonScript@0
  inputs:
    scriptSource: 'filePath' # 'filePath' | 'inline'. Required. Script source. Default: filePath.
    scriptPath: # string. Required when scriptSource = filePath. Script path. 
    #script: # string. Required when scriptSource = inline. Script. 
    #arguments: # string. Arguments. 
  # Advanced
    #pythonInterpreter: # string. Python interpreter. 
    #workingDirectory: # string. Working directory. 
    #failOnStderr: false # boolean. Fail on standard error. Default: false.

Eingänge

scriptSource - Skriptquelle
string. Erforderlich. Zulässige Werte: filePath (Dateipfad), inline. Standardwert: filePath.

Gibt an, ob das Skript eine Datei in der Quellstruktur ist oder inline in dieser Aufgabe geschrieben wird.

scriptPath - Skriptpfad
string. Erforderlich, wenn scriptSource = filePath.

Gibt den Pfad des auszuführenden Skripts an. Muss ein vollqualifizierter Pfad oder relativ zu $(System.DefaultWorkingDirectory)sein.

script - Skript-
string. Erforderlich, wenn scriptSource = inline.

Gibt das auszuführende Python-Skript an.

arguments - Argumente
string.

Gibt die Argumente an, die an die Skriptausführung übergeben werden, die über sys.argvverfügbar ist, als ob Sie sie an die Befehlszeile übergeben haben.

pythonInterpreter - Python-Dolmetscher
string.

Gibt den absoluten Pfad zum zu verwendenden Python-Interpreter an. Wenn nicht angegeben, verwendet die Aufgabe den Dolmetscher in PATH.
Führen Sie die aufgabe "Verwenden der Python-Version" aus, um eine Version von Python zu PATH hinzuzufügen.

workingDirectory - Arbeitsverzeichnis
string.

Gibt das Arbeitsverzeichnis an, in dem das Skript ausgeführt wird. Wenn nicht angegeben, wird der Wert von System.DefaultWorkingDirectory verwendet. Bei Builds wird diese Variable standardmäßig auf den Stamm des Repositorys festgelegt. Bei Versionen wird standardmäßig das Stammverzeichnis des Artefakteverzeichnisses verwendet.

failOnStderr - Fehler beim Standardfehler
boolean. Standardwert: false.

Wenn diese Aufgabe auf truefestgelegt ist, schlägt diese Aufgabe fehl, wenn Text in den stderr Datenstrom geschrieben wird.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Standardmäßig ruft diese Aufgabe python aus dem Systempfad auf. Führen Sie Verwenden Sie python Version, um die gewünschte Version im Systempfad zu platzieren.

Beispiele

Führen Sie ein Inline-Python-Skript aus.

- task: PythonScript@0
  inputs:
    scriptSource: 'inline'
    script: |
      print('Hello world 1')
      print('Hello world 2')

Führen Sie ein Inline-Python-Skript aus, das eine Umgebungsvariable verwendet.

- task: PythonScript@0
  inputs:
    scriptSource: 'inline'
    script: |
      import os
      print(f'Environment variable MY_VAR: {os.getenv("MY_VAR")}')
  env:
    MY_VAR: 'Hello, World!'

Führen Sie ein Python-Skript aus dem Arbeitsverzeichnis aus. Die Aufgabe schlägt fehl, wenn Text in den stderr Datenstrom geschrieben wird.

- task: PythonScript@0
  inputs:
    scriptSource: 'filePath'
    scriptPath: 'scripts/hello_world.py'
    workingDirectory: '$(Build.SourcesDirectory)/scripts'
    failOnStderr: true

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	Alle unterstützten Agentversionen.
Vorgangskategorie	Nützlichkeit

Freigeben über