UsePythonVersion@0 – A Python 0-s verziójának használata feladat

Ezzel a feladatsal letöltheti vagy kiválaszthatja az ügynökön futtatandó Python-verziót, és igény szerint hozzáadhatja a PATH-hoz.

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.

Bevitelek

versionSpec - Verziós specifikáció
string. Kötelező. Alapértelmezett érték: 3.x.

A Használni kívánt Python-verzió verziótartományát vagy pontos verzióját adja meg a SemVer verziótartomány-szintaxisának használatával. További információ a SemVerről.

disableDownloadFromRegistry - Kiadások letöltésének letiltása a GitHub beállításjegyzékéből
boolean. Alapértelmezett érték: false.

Letiltja a hiányzó Python-verziók letöltését a Github Actions beállításjegyzékéből. Ez a logikai érték csak akkor lehet, true ha a Python helyi telepítését használja.

allowUnstable - Instabil kiadások letöltésének engedélyezése
boolean. Választható. Használja a következőt: disableDownloadFromRegistry = false. Alapértelmezett érték: false.

Instabil Python-verziókat tölt le a Github Actions Python-verzióinak beállításjegyzékéből , ha a trueértéke .

githubToken - GitHub-jogkivonat GitHub Actions Python-beállításjegyzékhez
string. Választható. Használja a következőt: disableDownloadFromRegistry = false.

Megadja azt a GitHub-jogkivonatot, amely kikényszeríti a névtelen kérelmek korlátját a Github Actions Python-verzióinak beállításjegyzékében. Az üresen hagyás letöltési hibákat okozhat. Nem szükséges, ha helyi Python-telepítést használ.

addToPath - Hozzáadás a PATH-hoz
boolean. Alapértelmezett érték: true.

A lekért Python-verziót a PATH környezeti változóra iktatja, hogy a kimeneti változó használata nélkül elérhetővé tegye azt a későbbi feladatokban vagy szkriptekben.

architecture - Építészet
string. Kötelező. Engedélyezett értékek: x86, x64. Alapértelmezett érték: x64.

A Python-értelmező célarchitektúráját (x86 vagy x64) adja meg.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

pythonLocation
A telepített Python-disztribúció könyvtára. Ezt a következő feladatokban használhatja a Python telepítésének eléréséhez.

Megjegyzések

Ezzel a feladatsal letöltheti vagy kiválaszthatja az ügynökön futtatandó Python-verziót, és igény szerint hozzáadhatja a PATH-hoz.

Előfeltételek

• Egy Microsoft által üzemeltetett ügynök , amelyen telepítve van a Python egymás melletti verziója, vagy egy konfigurált saját üzemeltetésű ügynök Agent.ToolsDirectory (lásd : GYIK).
• A Python-verziók letöltése nem támogatott a saját üzemeltetésű ügynökök esetében.

Ez a feladat sikertelen lesz, ha nem található Python-verzió a fájlban Agent.ToolsDirectory. A Microsoft által üzemeltetett ügynökökön elérhető Python-verziók itt találhatók.

Megjegyzés

A Python x86-os és x64-es verziói a Microsoft által üzemeltetett Windows-ügynökökön érhetők el, Linux- vagy macOS-ügynökökön azonban nem.

A feladat 0.150-es verziójától a verzióspecifikáció is elfogadja pypy2 a vagy pypy3a verziót.

A feladat 0.213.1-es verziójától a verzióspecifikáció a vagy pypy3.xa -t is elfogadjapypy2.x.

Ha a feladat sikeresen befejeződött, a feladat kimeneti változója tartalmazni fogja a Python-telepítés könyvtárát:

Miután futtatta ezt a feladatot a "Hozzáadás a PATH-hoz" paranccsal, a következő szkriptekben a python parancs az értelmező legmagasabb rendelkezésre álló verziójához fog futni, amely megfelel a verzióspecifikációnak és az architektúrának.

A Microsoft által üzemeltetett Ubuntu- és macOS-rendszerképekre telepített Python-verziók a PEP 394-ben meghatározott Unix-szerű rendszerek szimlinkelési struktúráját követik.

Például python3.11 a Python 3.11 tényleges értelmezője.

python3 A az értelmezőhöz van szimlinkelve, és python a szimlinkhez kapcsolódik.

A Microsoft által üzemeltetett Windows-rendszerképeken az értelmező csak python.

A Microsoft által üzemeltetett ügynökök esetében az x86 csak Windows rendszeren támogatott. Ennek az az oka, hogy a Windows képes futtatni az x86 architektúrához a WoW64 alrendszerrel lefordított végrehajtható fájlokat. Az üzemeltetett Ubuntu és a üzemeltetett macOS 64 bites operációs rendszereket futtat, és csak 64 bites Pythont futtat.

Hogyan konfigurálhatok egy saját üzemeltetésű ügynököt a feladat használatára?

Fontos

A Python-verziók letöltése nem támogatott a saját üzemeltetésű ügynökök esetében. Csak előre telepített verziókat használhat.

A kívánt Python-verziót hozzá kell adni az eszköz gyorsítótárához a saját üzemeltetésű ügynökön, hogy a feladat használni tudja. Az eszközgyorsítótár általában az _work/_tool ügynök könyvtárában található; másik lehetőségként az elérési utat felül lehet bírálni a környezeti változóval AGENT_TOOLSDIRECTORY. Ebben a könyvtárban hozza létre a következő könyvtárstruktúrát a Python-verzió alapján:

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

A version number formátumának a következőnek 1.2.3kell lennie: . A platform értéknek vagy x64értéknek kell lenniex86. A tool files fájlnak a kicsomagolt Python-verziófájloknak kell lenniük. A {platform}.complete fájlnak 0 bájtos fájlnak kell lennie, amely úgy x86.complete néz ki, vagy x64.complete csak azt jelzi, hogy az eszköz megfelelően lett telepítve a gyorsítótárban.

Teljes és konkrét példaként az x64-hez készült Python 3.11.4 befejezett letöltését mutatjuk be az eszköz gyorsítótárában:

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

További információ az eszköz gyorsítótáráról.

Ahhoz, hogy a szkriptek ugyanúgy működjenek, mint a Microsoft által üzemeltetett ügynökökön, használja a PEP 394 szimlinkelési struktúráját Unix-szerű rendszereken.

Azt is vegye figyelembe, hogy a Python beágyazható ZIP-kiadása további konfigurációt igényel a telepített modulokhoz, például a következőhöz: pip. Ha lehetséges, javasoljuk, hogy használja a teljes telepítőt egy pip-kompatibilis Python-telepítés beszerzéséhez.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Ez a feladat a következő parancskorlátozásokkal fut: korlátozott
Változók beállítása	Ez a feladat rendelkezik engedéllyel a következő változók beállításához: pythonLocation, PATH
Ügynök verziója	2.182.1 vagy újabb
Feladatkategória	Eszköz