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.
# 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.
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 pypy3
a verziót.
A feladat 0.213.1-es verziójától a verzióspecifikáció a vagy pypy3.x
a -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.3
kell 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 |
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 feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | Minden támogatott ügynökverzió. |
Feladatkategória | Eszköz |