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

Ezzel a feladatsal letöltheti vagy kiválaszthatja a Python egy ügynökön futtatandó verzióját, és opcionálisan hozzáadhatja a PATH-hoz.

Szintaxis

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

Bemenetek

versionSpec - Verzió specifikációs
string. Szükséges. Alapértelmezett érték: 3.x.

A Használandó Python-verzió verziótartományát vagy pontos verzióját adja meg a SemVer verziótartomány-szintaxisával. További információ a SemVer .

disableDownloadFromRegistry - Kiadások letöltésének letiltása a GitHub-beállításjegyzékbő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-. Ez a logikai érték csak akkor true, ha a Python helyi telepítését használja.

allowUnstable - Instabil kiadások letöltésének engedélyezése
boolean. Opcionális. Használja a 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 truevan beállítva.

githubToken - GitHub-jogkivonat a GitHub Actions python-beállításjegyzék-
string. Opcionális. Használja a disableDownloadFromRegistry = false.

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

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

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

architecture - architektúra
string. Szükséges. 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ők é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 a Python egy ügynökön futtatandó verzióját, és opcionálisan hozzáadhatja a PATH-hoz.

Előfeltételek

• Egy Microsoft által üzemeltetett ügynök, amelyen telepítve vannak a Python egymás melletti verziói, vagy egy saját üzemeltetésű ügynök Agent.ToolsDirectory konfigurálva (lásd gyakori kérdések).
• 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 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-verziói a Microsoft által üzemeltetett Windows-ügynökökön érhetők el, linuxos vagy macOS-ügynökökön azonban nem.

A feladat 0.150-es verziójától a verzió specifikációja pypy2 vagy pypy3is elfogad.

A feladat 0.213.1-es verziójától a verzió specifikációja pypy2.x vagy pypy3.xis elfogad.

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

Miután a feladatot a "Hozzáadás a PATH-hoz" paranccsal futtatta, a python parancs a következő szkriptekben a verziós specifikációnak és architektúrának megfelelő tolmács legmagasabb rendelkezésre állású verziójára lesz.

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

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

python3 az értelmezőhöz van szimfonizálva, és python a szimlinkhez való szimlink.

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 futtathatja az x86-architektúrához lefordított végrehajtható fájlokat a WoW64 alrendszerrel. Az üzemeltetett Ubuntu és a hosted 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 ügynök _work/_tool könyvtárában található; másik lehetőségként az elérési utat felül lehet bírálni a AGENT_TOOLSDIRECTORYkörnyezeti változóval. 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 a 1.2.3formátumát kell követnie. A platformx86 vagy x64kell lennie. A tool files a nem tömörített Python-verziófájloknak kell lenniük. A {platform}.complete 0 bájtos fájlnak kell lennie, amely úgy néz ki, mint x86.complete vagy x64.complete, és 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-nek az eszközgyorsítótárban való teljes letöltése tekinthető meg:

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

További információ a eszközgyorsítótár-.

Ahhoz, hogy a szkriptek ugyanúgy működjenek, mint a Microsoft által üzemeltetett ügynököknél, 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, beleértve a pip. Ha lehetséges, javasoljuk, hogy használja a teljes telepítőtpip-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 bekapcsolva	Ügynök, DeploymentGroup
Követelmények	Egyik sem
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 jogosult a következő változók beállítására: pythonLocation, PATH
Ügynök verziója	2.182.1 vagy újabb
Tevékenységkategória	Eszköz