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

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

Sözdizimi

# 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. Gerekli. Varsayılan değer: 3.x.

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

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

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

allowUnstable - Kararsız sürümlerin indirilmesine izin ver
boolean. Opsiyonel. disableDownloadFromRegistry = falseolduğunda kullanın. Varsayılan değer: false.

olarak ayarlanırsa true kararsız Python sürümlerini indirir.

GitHub Actions python kayıt defteriiçin GitHub belirtecini githubToken -
string. Opsiyonel. disableDownloadFromRegistry = falseolduğunda kullanın.

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

PATH'a ekle'yi addToPath -
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 - Mimarisi
string. Gerekli. İ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örevaşağıdaki çıkış değişkenlerini tanımlar. Bu değişkenleri aşağı akış adımlarında, işlerde ve aşamalarda kullanabilirsiniz.

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

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

Önkoşullar

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

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

Uyarı

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" ile çalıştırdıktan sonra, sonraki betiklerdeki python komutu, 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'de 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 ve python bu symlink'e bir symlink'tir.

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

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çinde 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çinde 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, yolu AGENT_TOOLSDIRECTORYortam değişkeni tarafından geçersiz kılınabilir. Bu dizin altında Python sürümünüzü temel alan aşağıdaki dizin yapısını oluşturun:

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

version number 1.2.3biçimini izlemelidir. platform x86 veya x64olmalıdır. tool files sıkıştırması açılmış Python sürüm dosyaları olmalıdır. {platform}.complete, x86.complete veya x64.complete gibi görünen ve aracın önbelleğe düzgün yüklendiğini gösteren 0 baytlık bir dosya olmalıdır.

Eksiksiz ve somut bir örnek olarak, x64 için Tamamlanmış Python 3.11.4 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ğihakkı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'den gelen bağlantı yapısını kullanın.

Ayrıca Python'ın eklenebilir ZIP sürümünün dahil olmak üzere pipek yapılandırma gerektirdiğini unutmayın. Mümkünse, uyumlu bir Python yüklemesi almak için pip kullanmanızı öneririz.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Aracı, DeploymentGroup
Talepleri	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Bu görev,aşağıdaki komut kısıtlamaları kullanılarak çalışır: restricted
Ayarlanabilir değişkenleri	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ç