UsePythonVersion@0 - Use a tarefa Python versão v0

Use esta tarefa para baixar ou selecionar uma versão do Python para ser executada em um agente e, opcionalmente, adicioná-la ao PATH.

Sintaxe

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

Insumos

versionSpec - Especificações da versão
string. Obrigatório. Valor padrão: 3.x.

Especifica o intervalo de versões ou a versão exata de uma versão do Python a ser usada, usando a sintaxe do intervalo de versões do SemVer. Saiba mais sobre SemVer.

disableDownloadFromRegistry - Desative o download de versões do de registro do GitHub
boolean. Valor padrão: false.

Desabilita o download de versões ausentes do Python do de registroGithub Actions . Este booleano só deve ser true se estiver usando uma instalação local do Python.

allowUnstable - Permitir o download de versões instáveis
boolean. Opcional. Use quando disableDownloadFromRegistry = false. Valor padrão: false.

Baixa versões instáveis do Python do Registro de versões do Python do Github Actions se definido como true.

githubToken - token GitHub para de registro python do GitHub Actions
string. Opcional. Use quando disableDownloadFromRegistry = false.

Especifica o token do GitHub que impõe o limite de solicitações anônimas no de registro de versões python doGithub Actions. Deixar isso vazio pode causar falhas de download. Não é necessário se estiver usando uma instalação local do Python.

addToPath - Adicionar ao PATH
boolean. Valor padrão: true.

Anexa a versão recuperada do Python à variável de ambiente PATH para disponibilizá-la em tarefas ou scripts subsequentes sem usar a variável de saída.

architecture - Arquitetura
string. Obrigatório. Valores permitidos: x86, x64. Valor padrão: x64.

Especifica a arquitetura de destino (x86 ou x64) do interpretador Python.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída , que você pode consumir em etapas, trabalhos e estágios downstream.

pythonLocation
O diretório da distribuição Python instalada. Use isso em tarefas subsequentes para acessar esta instalação do Python.

Observações

Use esta tarefa para baixar ou selecionar uma versão do Python para ser executada em um agente e, opcionalmente, adicioná-la ao PATH.

Pré-requisitos

• Um agente hospedado pela Microsoft com versões lado a lado do Python instaladas ou um agente auto-hospedado com Agent.ToolsDirectory configurado (consulte de perguntas frequentes ).
• O download de versões python não é suportado em agentes auto-hospedados.

Esta tarefa falhará se nenhuma versão do Python for encontrada no Agent.ToolsDirectory. As versões Python disponíveis em agentes hospedados pela Microsoft podem ser encontradas aqui.

Observação

As versões x86 e x64 do Python estão disponíveis em agentes Windows hospedados pela Microsoft, mas não em agentes Linux ou macOS.

A partir da versão 0.150 da tarefa, as especificações da versão também aceitarão pypy2 ou pypy3.

A partir da versão 0.213.1 da tarefa, as especificações da versão também aceitarão pypy2.x ou pypy3.x.

Se a tarefa for concluída com êxito, a variável de saída da tarefa conterá o diretório da instalação do Python:

Depois de executar esta tarefa com "Adicionar ao PATH", o comando python nos scripts subsequentes será para a versão mais alta disponível do interpretador correspondente à especificação e arquitetura da versão.

As versões do Python instaladas nas imagens do Ubuntu e macOS hospedadas pela Microsoft seguem a estrutura de vinculação simbólica para sistemas Unix que são definidos em PEP 394.

Por exemplo, python3.11 é o interpretador real para Python 3.11.

python3 é um link simbólico para esse intérprete, e python é um link simbólico para esse link simbólico.

Nas imagens do Windows hospedadas pela Microsoft, o intérprete é apenas python.

Para agentes hospedados pela Microsoft, o x86 é suportado apenas no Windows. Isso ocorre porque o Windows pode executar executáveis compilados para a arquitetura x86 com o subsistema WoW64. O Ubuntu hospedado e o macOS hospedado executam sistemas operacionais de 64 bits e executam apenas Python de 64 bits.

Como posso configurar um agente auto-hospedado para usar essa tarefa?

Importante

O download de versões python não é suportado em agentes auto-hospedados. Você só pode usar versões pré-instaladas.

A versão desejada do Python precisa ser adicionada ao cache da ferramenta no agente auto-hospedado para que a tarefa possa usá-la. Normalmente, o cache da ferramenta está localizado sob o diretório _work/_tool do agente; Como alternativa, o caminho pode ser substituído pela variável de ambiente AGENT_TOOLSDIRECTORY. Nesse diretório, crie a seguinte estrutura de diretórios com base na sua versão do Python:

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

O version number deve seguir o formato de 1.2.3. O platform deve ser x86 ou x64. O tool files deve ser os arquivos de versão do Python descompactados. O {platform}.complete deve ser um arquivo de 0 byte que se parece com x86.complete ou x64.complete e apenas significa que a ferramenta foi instalada no cache corretamente.

Como um exemplo completo e concreto, aqui está como um download concluído do Python 3.11.4 para x64 ficaria no cache de ferramentas:

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

Saiba mais sobre o cache da ferramenta .

Para fazer com que seus scripts funcionem como em agentes hospedados pela Microsoft, use a estrutura de vinculação simbólica de PEP 394 em sistemas Unix-like.

Observe também que a versão ZIP incorporável do Python requer configuração extra para módulos instalados, incluindo pip. Se possível, recomendamos usar o completo do instalador para obter uma instalação Python compatível com pip.

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Esta tarefa é executada usando as seguintes restrições de comando : restrito
Variáveis configuráveis	Esta tarefa tem permissão para definir as seguintes variáveis: pythonLocation, PATH
Versão do agente	2.182.1 ou superior
Categoria de tarefa	Ferramenta