UsePythonVersion@0 – Använda python version v0-uppgift

Artikel
07/02/2024

Använd den här uppgiften för att ladda ned eller välja en version av Python som ska köras på en agent och du kan också lägga till den i PATH.

Syntax

# Use Python version v0
# Use the specified version of Python from the tool cache, optionally adding it to the PATH.
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x' # string. Required. Version spec. Default: 3.x.
    #disableDownloadFromRegistry: false # boolean. Disable downloading releases from the GitHub registry. Default: false.
    #allowUnstable: false # boolean. Optional. Use when disableDownloadFromRegistry = false. Allow downloading unstable releases. Default: false.
    #githubToken: # string. Optional. Use when disableDownloadFromRegistry = false. GitHub token for GitHub Actions python registry. 
    #addToPath: true # boolean. Add to PATH. Default: true.
  # Advanced
    architecture: 'x64' # 'x86' | 'x64'. Required. Architecture. Default: x64.

# Use Python version v0
# Use the specified version of Python from the tool cache, optionally adding it to the PATH.
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x' # string. Required. Version spec. Default: 3.x.
    #addToPath: true # boolean. Add to PATH. Default: true.
  # Advanced
    architecture: 'x64' # 'x86' | 'x64'. Required. Architecture. Default: x64.

# Use Python Version v0
# Retrieves the specified version of Python from the tool cache. Optionally add it to PATH.
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x' # string. Required. Version spec. Default: 3.x.
    #addToPath: true # boolean. Add to PATH. Default: true.
  # Advanced
    architecture: 'x64' # 'x86' | 'x64'. Required. Architecture. Default: x64.

Indata

versionSpec - Versionsspecifikation
string. Krävs. Standardvärde: 3.x.

Anger versionsintervallet eller den exakta versionen av en Python-version som ska användas med hjälp av SemVers versionsintervallsyntax. Läs mer om SemVer.

disableDownloadFromRegistry - Inaktivera nedladdning av versioner från GitHub-registret
boolean. Standardvärde: false.

Inaktiverar nedladdning av saknade Python-versioner från Github Actions-registret. Det här booleska värdet ska bara vara true om du använder en lokal installation av Python.

allowUnstable - Tillåt nedladdning av instabila versioner
boolean. Valfritt. Använd när disableDownloadFromRegistry = false. Standardvärde: false.

Laddar ned instabila Python-versioner från Github Actions Python-versionsregistret om det är inställt på true.

githubToken - GitHub-token för GitHub Actions Python-register
string. Valfritt. Använd när disableDownloadFromRegistry = false.

Anger den GitHub-token som tillämpar gränsen för anonyma begäranden i Python-versionsregistret för Github Actions. Om du lämnar den här tom kan det orsaka nedladdningsfel. Behövs inte om du använder en lokal installation av Python.

addToPath - Lägg till i PATH
boolean. Standardvärde: true.

Förbereder den hämtade Python-versionen till path-miljövariabeln för att göra den tillgänglig i efterföljande uppgifter eller skript utan att använda utdatavariabeln.

architecture - Arkitekturen
string. Krävs. Tillåtna värden: x86, x64. Standardvärde: x64.

Anger målarkitekturen (x86 eller x64) för Python-tolken.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

pythonLocation
Katalogen för den installerade Python-distributionen. Använd detta i efterföljande uppgifter för att komma åt den här installationen av Python.

Kommentarer

Använd den här uppgiften för att ladda ned eller välja en version av Python som ska köras på en agent och du kan också lägga till den i PATH.

Förutsättningar

En Microsoft-värdbaserad agent med sida vid sida-versioner av Python installerat eller en lokalt installerad agent med Agent.ToolsDirectory konfigurerad (se Vanliga frågor och svar).
Nedladdning av Python-versioner stöds inte på lokalt installerade agenter.

Den här uppgiften misslyckas om inga Python-versioner hittas i Agent.ToolsDirectory. Tillgängliga Python-versioner på Microsoft-värdbaserade agenter finns här.

Anteckning

x86- och x64-versioner av Python är tillgängliga på Microsoft-värdbaserade Windows-agenter, men inte på Linux- eller macOS-agenter.

Från och med version 0.150 av uppgiften accepterar pypy2 även versionsspecifikationen eller pypy3.

Från och med version 0.213.1 av uppgiften accepterar pypy2.x även versionsspecifikationen eller pypy3.x.

Om uppgiften har slutförts innehåller aktivitetens utdatavariabel katalogen för Python-installationen:

Skärmbild av utdatavariabeln.

När du har kört den här uppgiften med "Lägg till i SÖKVÄG" python kommer kommandot i efterföljande skript att vara för den högsta tillgängliga versionen av tolken som matchar versionsspecifikationen och arkitekturen.

Versionerna av Python som är installerade på De Microsoft-värdbaserade Ubuntu- och macOS-avbildningarna följer symlinking-strukturen för Unix-liknande system som definieras i PEP 394.

Är till exempel python3.11 den faktiska tolken för Python 3.11.

python3 är symlinkad till tolken och python är en symlink till den symlinken.

På Microsoft-värdbaserade Windows-avbildningar är tolken bara python.

För Microsoft-värdbaserade agenter stöds x86 endast i Windows. Det beror på att Windows kan köra körbara filer som kompilerats för x86-arkitekturen med Undersystemet WoW64. Värdbaserade Ubuntu- och värdbaserade macOS kör 64-bitars operativsystem och kör endast 64-bitars Python.

Hur konfigurerar jag en lokalt installerad agent för att använda den här uppgiften?

Viktigt

Nedladdning av Python-versioner stöds inte på lokalt installerade agenter. Du får bara använda förinstallerade versioner.

Den önskade Python-versionen måste läggas till i verktygscacheminnet på den lokalt installerade agenten så att uppgiften kan använda den. Normalt finns verktygscacheminnet under _work/_tool agentens katalog. Alternativt kan sökvägen åsidosättas av miljövariabeln AGENT_TOOLSDIRECTORY. Under den katalogen skapar du följande katalogstruktur baserat på din Python-version:

$AGENT_TOOLSDIRECTORY/
    Python/
        {version number}/
            {platform}/
                {tool files}
            {platform}.complete

version number Bör följa formatet 1.2.3för . platform Ska antingen vara x86 eller x64. tool files Bör vara de uppackade Python-versionsfilerna. {platform}.complete Ska vara en 0 byte-fil som ser ut som x86.complete eller x64.complete bara betyder att verktyget har installerats i cachen korrekt.

Ett komplett och konkret exempel är hur en slutförd nedladdning av Python 3.11.4 för x64 skulle se ut i verktygscacheminnet:

$AGENT_TOOLSDIRECTORY/
    Python/
        3.11.4/
            x64/
                {tool files}
            x64.complete

Läs mer om verktygets cacheminne.

Använd symlinkingstrukturen från PEP 394 på Unix-liknande system för att få dina skript att fungera som de skulle göra på Microsoft-värdbaserade agenter.

Observera också att den inbäddningsbara ZIP-versionen av Python kräver extra konfiguration för installerade moduler, inklusive pip. Om möjligt rekommenderar vi att du använder det fullständiga installationsprogrammet för att få en pip-kompatibel Python-installation.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här uppgiften körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler	Den här uppgiften har behörighet att ange följande variabler: pythonLocation, PATH
Agentversion	2.182.1 eller senare
Uppgiftskategori	Verktyg

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	Alla agentversioner som stöds.
Uppgiftskategori	Verktyg

Dela via