Python sürümü görevi kullan

Makale
11/30/2021
Okumak için 3 dakika

Azure Pipelines

Bu görevi, bir aracıda çalıştırılacak Python sürümünü seçmek ve isteğe bağlı olarak yola eklemek için kullanın.

Erişim

Hiçbiri

Önkoşullar

Python 'un yan yana sürümlerine sahip Microsoft tarafından barındırılan bir aracı veya Agent. araçları dizini yapılandırılmış şirket içinde barındırılan bir aracı (bkz. SSS).

Aracı. araçları dizininde hiçbir 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 buradabulunabilir.

Not

Python 'un x86 ve x64 sürümleri, Microsoft tarafından barındırılan Windows aracılarında bulunabilir, ancak Linux veya macos aracılarında kullanılamaz.

YAML kod parçacığı

# Use Python version
# Use the specified version of Python from the tool cache, optionally adding it to the PATH
- task: UsePythonVersion@0
  inputs:
    #versionSpec: '3.x' 
    #addToPath: true 
    #architecture: 'x64' # Options: x86, x64 (this argument applies only on Windows agents)

Bağımsız değişkenler

Bağımsız Değişken	Description
`versionSpec` Sürüm belirtimi	Istenir Kullanılacak Python sürümünün sürüm aralığı veya tam sürümü. Varsayılan değer: `3.x`
`addToPath` YOLA Ekle	Istenir Alınan Python sürümünün, çıkış değişkeni kullanılmadan sonraki görevlerde veya betiklerde kullanılabilmesini sağlamak için PATH ortam değişkenine eklenip eklenmeyeceğini belirtir. Varsayılan değer: `true`
`architecture` Mimari	Istenir Python yorumlayıcı 'nın hedef mimarisi (x86, x64). x86 yalnızca Windows desteklenir. Varsayılan değer: `x64`

Görevin sürüm 0,150 itibariyle sürüm belirtimi de kabul eder pypy2pypy3 .

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

çıkış değişkeni

Açıklamalar

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

Microsoft tarafından barındırılan Ubuntu ve macOS görüntülerinde yüklü Python sürümleri, Pep 394' de tanımlanan UNIX benzeri sistemler için symlink yapısına uyar. Örneğin, Python 3,7 için python3.7 gerçek yorumlayıcı. python3 , bu yorumlayıcı için symlindir ve python Bu oluşturmaksızın 'e yönelik bir symbağlantıdır.

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

Microsoft tarafından barındırılan aracılar için x86 yalnızca Windows desteklenir. bunun nedeni, Windows WoW64 alt sistemiyle x86 mimarisi için derlenen yürütülebilir dosyaları çalıştırabilirler. Barındırılan Ubuntu ve Hosted macOS 64 bitlik işletim sistemlerini çalıştırın ve yalnızca 64 bit Python çalıştırır.

Açık kaynak

Bu görev GitHubaçık kaynağıdır. Geribildirim ve katılımlar hoş geldiniz.

SSS

Araç yükleyicileri hakkında nereden daha fazla bilgi edinebilirim?

Araç yükleyicilerinin ve örneklerin açıklaması için bkz. araç yükleyicileri.

Bir aracıya ihtiyacım var mı?

Yapınızı veya sürümünüzü çalıştırmak için en az bir aracınız olması gerekir.

Sorun yaşıyorum. Sorunları nasıl giderebilirim?

Bkz. derleme ve yayın sorunlarını giderme.

Varsayılan bir aracı havuzu seçemiyorum ve derleme veya yayınımı sıraya alamıyorum. Bu Nasıl yaparım? düzeltilsin mi?

Bkz. Aracı havuzları.

NuGet gönderme görevi şu hata ile başarısız oluyor: "hata: yerel veren sertifikası alınamıyor". Bunu nasıl giderebilirim?

Bu, güvenilen kök sertifika eklenerek düzeltilebilir. NODE_EXTRA_CA_CERTS=fileOrtam değişkenini yapı aracıya ekleyebilir veya NODE.EXTRA.CA.CERTS=file görev değişkenini işlem hattınızda ekleyebilirsiniz. Bu değişken hakkında daha fazla bilgi için bkz. Node.js belgeleri . İşlem hattınızda değişken ayarlamaya ilişkin yönergeler için bkz. işlem hattındaki değişkenleri ayarlama .

Kendi kendine barındırılan bir aracıyı bu görevi kullanacak şekilde nasıl yapılandırabilirim?

Görevin kullanabilmesi için, istenen Python sürümünün şirket içinde barındırılan aracıda araç önbelleğine eklenmesi gerekir. Normalde araç önbelleği, aracının dizini altında bulunur _work/_tool veya yol ortam değişkeni tarafından geçersiz kılınabilir AGENT_TOOLSDIRECTORY . 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 Biçimini izlemelidir 1.2.3 . platformYa da olmalıdır x86x64 . , tool files Daraltılmış Python sürüm dosyaları olmalıdır. , {platform}.complete Veya gibi görünen 0 baytlık bir dosya olmalıdır x86.completex64.complete ve yalnızca aracın önbellekte düzgün bir şekilde yüklendiğini belirtir.

Tamamen, somut bir örnek olarak,, x64 için Python 3.6.4 'in tamamlanmış bir indirmesi araç önbelleğinde görünür:

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

Araç önbelleği hakkında daha fazla bilgi için burayabakın.

Betiklerinizin Microsoft tarafından barındırılan aracılarda olduğu gibi çalışabilmesi için, UNIX benzeri sistemlerde Pep 394 'den symlink yapısını takip etmenizi öneririz.

Ayrıca, Python 'un eklenebilir ZIP sürümünün yüklü modüller için yapılandırmak için ek çabagerektirdiğini de unutmayın . Mümkünse, uyumlu bir Python yüklemesi almak için tam yükleyiciyi kullanmanızı öneririz .