UsePythonVersion@0 – použití úlohy Python verze v0

Tuto úlohu použijte ke stažení nebo výběru verze Pythonu, která se má spustit v agentu, a volitelně ji přidejte do path.

Syntaxe

# 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.

Vstupy

versionSpec - specifikace verze
string. Povinné. Výchozí hodnota: 3.x.

Určuje rozsah verzí nebo přesnou verzi verze Pythonu, která se má použít, pomocí syntaxe rozsahu verzí SemVeru. Přečtěte si další informace o SemVer.

disableDownloadFromRegistry - Zakázání stahování verzí z registru GitHubu
boolean. Výchozí hodnota: false.

Zakáže stahování chybějících verzí Pythonu z registru GitHub Actions. Tato logická hodnota by měla být true pouze v případě, že používáte místní instalaci Pythonu.

allowUnstable - Povolit stahování nestabilních verzí
boolean. Volitelný. Používá se při disableDownloadFromRegistry = false. Výchozí hodnota: false.

Stáhne nestabilní verze Pythonu z registru Registru verzí Pythonu GitHub Actions pokud je nastavená na true.

githubToken - token GitHubu pro registr Pythonu GitHub Actions
string. Volitelný. Používá se při disableDownloadFromRegistry = false.

Určuje token GitHubu, který vynucuje omezení anonymních požadavků v registru registru verzí Pythonu GitHub Actions. Ponechání tohoto prázdného může způsobit selhání stahování. Není potřeba, pokud používáte místní instalaci Pythonu.

addToPath - Přidat do PATH
boolean. Výchozí hodnota: true.

Předpendá načtenou verzi Pythonu do proměnné prostředí PATH, aby byla k dispozici v následných úlohách nebo skriptech bez použití výstupní proměnné.

architektury architecture -
string. Povinné. Povolené hodnoty: x86, x64. Výchozí hodnota: x64.

Určuje cílovou architekturu (x86 nebo x64) interpreta Pythonu.

Možnosti ovládání úloh

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

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

pythonLocation
Adresář nainstalované distribuce Pythonu. Tento postup použijte v dalších úlohách pro přístup k této instalaci Pythonu.

Poznámky

Tuto úlohu použijte ke stažení nebo výběru verze Pythonu, která se má spustit v agentu, a volitelně ji přidejte do path.

Požadavky

• agenta hostovaného Microsoftem s nainstalovanými souběžnými verzemi Pythonu nebo s nakonfigurovaným agentem Agent.ToolsDirectory v místním prostředí (viz nejčastější dotazy).
• Stahování verzí Pythonu není podporováno u agentů v místním prostředí.

Tato úloha selže, pokud se v Agent.ToolsDirectorynenajdou žádné verze Pythonu . Dostupné verze Pythonu na agentech hostovaných Microsoftem najdete zde.

Poznámka:

Verze x86 a x64 Pythonu jsou k dispozici na agentech Windows hostovaných Microsoftem, ale ne v agentech pro Linux nebo macOS.

Od verze 0.150 úlohy bude specifikace verze také přijímat pypy2 nebo pypy3.

Od verze 0.213.1 úlohy bude specifikace verze také přijímat pypy2.x nebo pypy3.x.

Pokud se úloha úspěšně dokončí, výstupní proměnná úlohy bude obsahovat adresář instalace Pythonu:

Po spuštění této úlohy s příkazem Přidat do cesty bude příkaz python v dalších skriptech určen pro nejvyšší dostupnou verzi interpreta odpovídající specifikaci verze a architektuře.

Verze Pythonu nainstalované na imagích Ubuntu a macOS hostovaných Microsoftem se řídí strukturou symlinkingu pro systémy podobné unixovým systémům definovaným v PEP 394.

Například python3.11 je skutečný interpret pythonu 3.11.

python3 se symlinkuje s tímto interpretem a python je symlink na tento symlink.

Na imagích Windows hostovaných Microsoftem je interpret jen python.

U agentů hostovaných Microsoftem se x86 podporuje jenom ve Windows. Důvodem je to, že Systém Windows může spouštět spustitelné soubory kompilované pro architekturu x86 s subsystémem WoW64. Hostované Ubuntu a hostované macOS spouštějí 64bitové operační systémy a používají pouze 64bitovou verzi Pythonu.

Jak můžu nakonfigurovat agenta v místním prostředí pro použití této úlohy?

Důležité

Stahování verzí Pythonu není podporováno u agentů v místním prostředí. Můžete používat jenom předinstalované verze.

Požadovaná verze Pythonu se musí přidat do mezipaměti nástrojů v místním agentu, aby ji úloha mohl používat. Mezipaměť nástrojů se obvykle nachází pod _work/_tool adresářem agenta; případně lze cestu přepsat proměnnou prostředí AGENT_TOOLSDIRECTORY. V tomto adresáři vytvořte následující adresářovou strukturu založenou na vaší verzi Pythonu:

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

version number by měl odpovídat formátu 1.2.3. platform by měl být x86 nebo x64. tool files by měly být rozbalené soubory verzí Pythonu. {platform}.complete by měl být 0 bajtový soubor, který vypadá jako x86.complete nebo x64.complete a jenom podepisuje, že je nástroj správně nainstalovaný v mezipaměti.

Kompletní a konkrétní příklad ukazuje, jak by dokončené stahování Pythonu 3.11.4 pro x64 vypadalo v mezipaměti nástrojů:

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

Přečtěte si další informace o mezipaměti nástrojů.

Pokud chcete, aby vaše skripty fungovaly stejně jako u agentů hostovaných Microsoftem, použijte strukturu symlinkingu z PEP 394 v systémech podobných unixům.

Všimněte si také, že vložená verze ZIP Pythonu vyžaduje další konfiguraci nainstalovaných modulů, včetně pip. Pokud je to možné, doporučujeme použít úplný instalační program k získání pipkompatibilní instalace Pythonu.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Žádný
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Tato úloha se spouští s následujícími omezeními příkazů : omezeno:
nastavitelné proměnné	Tato úloha má oprávnění k nastavit následující proměnné: pythonLocation, PATH
Verze agenta	2.182.1 nebo vyšší
Kategorie úkolu	Nástroj