UsePythonVersion@0 - Python sürüm v0 görevini kullanma

Bir aracıda çalıştırılacak Python sürümünü indirmek veya seçmek ve isteğe bağlı olarak PATH'e eklemek için bu görevi kullanın.

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.

Girişler

versionSpec - Sürüm belirtimi
string. Gereklidir. Varsayılan değer: 3.x.

SemVer'in sürüm aralığı söz dizimini kullanarak bir Python sürümünün sürüm aralığını veya tam sürümünü belirtir. SemVer hakkında daha fazla bilgi edinin.

disableDownloadFromRegistry - GitHub kayıt defterinden sürümleri indirmeyi devre dışı bırakma
boolean. Varsayılan değer: false.

Github Actions kayıt defterinden eksik Python sürümlerini indirmeyi devre dışı bırakır. Bu boole yalnızca yerel bir Python yüklemesi kullanılıyorsa olmalıdır true .

allowUnstable - Kararsız sürümlerin indirilmesine izin ver
boolean. İsteğe bağlı. when disableDownloadFromRegistry = falsekullanın. Varsayılan değer: false.

olarak ayarlanırsa trueGithub Actions Python sürümleri kayıt defterinden kararsız Python sürümlerini indirir.

githubToken - GitHub Actions python kayıt defteri için GitHub belirteci
string. İsteğe bağlı. when disableDownloadFromRegistry = falsekullanın.

GitHub Actions python sürümleri kayıt defterinde anonim istek sınırını zorlayan GitHub belirtecini belirtir. Bunu boş bırakmak indirme hatalarına neden olabilir. Python'ın yerel yüklemesini kullanıyorsanız gerekli değildir.

addToPath - PATH'e ekle
boolean. Varsayılan değer: true.

Alınan Python sürümünü, çıkış değişkenini kullanmadan sonraki görevlerde veya betiklerde kullanılabilir hale getirmek için PATH ortam değişkenine ekler.

architecture - Mimari
string. Gereklidir. İzin verilen değerler: x86, x64. Varsayılan değer: x64.

Python yorumlayıcısının hedef mimarisini (x86 veya x64) belirtir.

Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

pythonLocation
Yüklü Python dağıtımının dizini. Python'ın bu yüklemesine erişmek için bunu sonraki görevlerde kullanın.

Açıklamalar

Bir aracıda çalıştırılacak Python sürümünü indirmek veya seçmek ve isteğe bağlı olarak PATH'e eklemek için bu görevi kullanın.

Önkoşullar

• Python'ın yan yana sürümlerinin yüklü olduğu Microsoft tarafından barındırılan bir aracı veya yapılandırılmış şirket içinde barındırılan bir aracı Agent.ToolsDirectory (bkz. SSS).
• Python sürümlerinin indirilmesi şirket içi barındırılan aracılarda desteklenmez.

içinde Agent.ToolsDirectoryPython sürümü bulunmazsa bu görev başarısız olur. Microsoft tarafından barındırılan aracılarda kullanılabilen Python sürümleri burada bulunabilir.

Not

Python'ın x86 ve x64 sürümleri Microsoft tarafından barındırılan Windows aracılarında kullanılabilir ancak Linux veya macOS aracılarında kullanılamaz.

Görevin 0.150 sürümünden itibaren sürüm belirtimi de pypy2 veya pypy3kabul eder.

Görevin 0.213.1 sürümünden itibaren sürüm belirtimi de pypy2.x veya pypy3.xkabul eder.

Görev başarıyla tamamlanırsa, görevin çıkış değişkeni Python yüklemesinin dizinini içerir:

Bu görevi "PATH'e Ekle" python ile çalıştırdıktan sonra, sonraki betiklerdeki komut, yorumlayıcının sürüm belirtimi ve mimarisiyle eşleşen en yüksek kullanılabilir sürümüne yönelik olacaktır.

Microsoft tarafından barındırılan Ubuntu ve macOS görüntülerine yüklenen Python sürümleri , PEP 394'te tanımlanan Unix benzeri sistemler için symlinking yapısını izler.

Örneğin, python3.11 Python 3.11 için gerçek yorumlayıcıdır.

python3 bu yorumlayıcıya symlinked ve python bu symlink için bir symlink olduğunu.

Microsoft tarafından barındırılan Windows görüntülerinde yorumlayıcı yalnızca pythonşeklindedir.

Microsoft tarafından barındırılan aracılar için x86 yalnızca Windows'ta desteklenir. Bunun nedeni, Windows'un WoW64 alt sistemiyle x86 mimarisi için derlenmiş yürütülebilir dosyaları çalıştırabilmesidir. Barındırılan Ubuntu ve Barındırılan macOS 64 bit işletim sistemlerini ve yalnızca 64 bit Python'ı çalıştırır.

Şirket içinde barındırılan bir aracıyı bu görevi kullanacak şekilde nasıl yapılandırabilirim?

Önemli

Python sürümlerinin indirilmesi şirket içi barındırılan aracılarda desteklenmez. Yalnızca önceden yüklenmiş sürümleri kullanabilirsiniz.

Görevin kullanabilmesi için istenen Python sürümünün şirket içi barındırılan aracıdaki araç önbelleğine eklenmesi gerekir. Normalde, araç önbelleği aracının _work/_tool dizini altında bulunur; alternatif olarak, yol ortam değişkeni AGENT_TOOLSDIRECTORYtarafından geçersiz kılınabilir. Bu dizin altında Python sürümünüzden yola çıkarak aşağıdaki dizin yapısını oluşturun:

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

biçimine version number1.2.3uygun olmalıdır. platform veya x64olmalıdırx86. sıkıştırması tool files açılmış Python sürüm dosyaları olmalıdır. veya {platform}.complete gibi x86.completex64.complete görünen ve aracın önbelleğe düzgün şekilde yüklendiğini gösteren 0 baytlık bir dosya olmalıdır.

Tam ve somut bir örnek olarak, x64 için Python 3.11.4'ün tamamlanmış indirmesinin araç önbelleğinde nasıl görüneceği aşağıda verilmiştir:

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

Araç önbelleği hakkında daha fazla bilgi edinin.

Betiklerinizin Microsoft tarafından barındırılan aracılarda olduğu gibi çalışmasını sağlamak için Unix benzeri sistemlerde PEP 394'ün eş bağlantı yapısını kullanın.

Ayrıca Python'ın eklenebilir ZIP sürümünün, dahil olmak üzere pipyüklü modüller için ek yapılandırma gerektirdiğini unutmayın. Mümkünse uyumlu bir pipPython yüklemesi almak için tam yükleyiciyi kullanmanızı öneririz.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Bu görev aşağıdaki komut kısıtlamaları kullanılarak çalıştırılır: kısıtlı
Ayarlanabilir değişkenler	Bu görevin şu değişkenleri ayarlama izni var: pythonLocation, PATH
Aracı sürümü	2.182.1 veya üzeri
Görev kategorisi	Araç