CondaDependencies Classe

Gere dependências de aplicações num ambiente do Azure Machine Learning.

Nota

Se não forem especificados parâmetros, azureml-defaults é adicionado como a única dependência pip.

Se o conda_dependencies_file_path parâmetro não for especificado, o objeto CondaDependencies contém apenas os pacotes do Azure Machine Learning (predefinições azureml). A dependência azureml-defaults não será afixada a uma versão específica e terá como destino a versão mais recente disponível no PyPi.

Inicialize um novo objeto para gerir dependências.

Herança
builtins.object
CondaDependencies

Construtor

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Parâmetros

conda_dependencies_file_path
str
valor predefinido: None

Um caminho local para um ficheiro de configuração conda. A utilização deste parâmetro permite o carregamento e edição de um ficheiro de ambiente Conda existente.

_underlying_structure
valor predefinido: None

Observações

Pode carregar um ficheiro de ambiente conda existente ou optar por configurar e gerir as dependências da aplicação na memória. Durante a submissão da experimentação, é executado um passo de preparação que cria e coloca em cache um ambiente conda no qual a experimentação é executada.

Se a dependência estiver disponível através do Conda e do pip (do PyPi), utilize a versão conda, uma vez que os pacotes Conda são normalmente fornecidos com binários pré-criados que tornam a instalação mais fiável. Para obter mais informações, veja Understanding Conda and Pip (Compreender o Conda e o Pip).

Veja o repositório https://github.com/Azure/AzureML-Containers para obter detalhes sobre as dependências de imagem de base.

O exemplo seguinte mostra como adicionar um pacote com o add_conda_package.


   from azureml.core.authentication import MsiAuthentication

   msi_auth = MsiAuthentication()

   ws = Workspace(subscription_id="my-subscription-id",
                  resource_group="my-ml-rg",
                  workspace_name="my-ml-workspace",
                  auth=msi_auth)

   print("Found workspace {} at location {}".format(ws.name, ws.location))

O exemplo completo está disponível a partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Um pacote pip também pode ser adicionado e as dependências definidas no Environment objeto.


   conda_dep.add_pip_package("pillow==6.2.1")
   myenv.python.conda_dependencies=conda_dep

O exemplo completo está disponível a partir de https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb

Métodos

add_channel

Adicione um canal conda.

Pode encontrar uma lista de canais em https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_cntk_package

Adicione um pacote Microsoft Cognitive Toolkit (CNTK).

add_conda_package

Adicione um pacote conda.

add_pip_package

Adicione um pacote pip.

Nota

Adicionar uma dependência de um pacote já referenciado removerá a referência anterior e adicionará uma nova referência ao fim da lista de dependências. Isto pode alterar a ordem das dependências.

add_tensorflow_conda_package

Adicione um pacote conda do Tensorflow.

add_tensorflow_pip_package

Adicione um pacote pip do Tensorflow.

as_dict

Devolver dependências conda.

create

Inicialize um novo objeto CondaDependencies.

Devolve uma instância de um objeto CondaDependencies com dependências especificadas pelo utilizador.

Nota

Se pip_packages não for especificado, as predefinições azureml serão adicionadas como dependências predefinidas. O utilizador especificou pip_packages dependências substituirão os valores predefinidos.

Se pin_sdk_version estiver definido como verdadeiro, as dependências pip dos pacotes distribuídos como parte do SDK Python do Azure Machine Learning serão afixadas à versão do SDK instalada no ambiente atual.

get_default_number_of_packages

Devolver o número predefinido de pacotes.

get_python_version

Devolver a versão do Python.

merge_requirements

Requisitos de pacote de intercalação.

remove_channel

Remover um canal conda.

remove_conda_package

Remova um pacote conda.

remove_pip_option

Remover uma opção pip.

remove_pip_package

Remova um pacote pip.

save

Guarde o objeto conda dependencies no ficheiro.

save_to_file

PRETERIDO, utilize save.

Guarde o objeto conda dependencies no ficheiro.

sdk_origin_url

Devolver o URL do índice de origem do SDK.

serialize_to_string

Serialize o objeto de dependências conda numa cadeia.

set_pip_index_url

Defina o URL do índice pip.

set_pip_option

Adicione uma opção pip.

set_pip_requirements

Substitua toda a secção pip de dependências conda.

set_python_version

Defina a versão do Python.

add_channel

Adicione um canal conda.

Pode encontrar uma lista de canais em https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_channel(channel)

Parâmetros

channel
str
Necessário

O canal conda a adicionar.

Tipo de retorno

add_cntk_package

Adicione um pacote Microsoft Cognitive Toolkit (CNTK).

add_cntk_package(core_type='cpu')

Parâmetros

core_type
str
valor predefinido: cpu

"cpu" ou "gpu".

add_conda_package

Adicione um pacote conda.

add_conda_package(conda_package)

Parâmetros

conda_package
str
Necessário

O pacote conda a adicionar.

add_pip_package

Adicione um pacote pip.

Nota

Adicionar uma dependência de um pacote já referenciado removerá a referência anterior e adicionará uma nova referência ao fim da lista de dependências. Isto pode alterar a ordem das dependências.

add_pip_package(pip_package)

Parâmetros

pip_package
str
Necessário

O pacote pip a adicionar.

add_tensorflow_conda_package

Adicione um pacote conda do Tensorflow.

add_tensorflow_conda_package(core_type='cpu', version=None)

Parâmetros

core_type
str
valor predefinido: cpu

"cpu" ou "gpu".

version
str
valor predefinido: None

A versão do pacote.

add_tensorflow_pip_package

Adicione um pacote pip do Tensorflow.

add_tensorflow_pip_package(core_type='cpu', version=None)

Parâmetros

core_type
str
valor predefinido: cpu

"cpu" ou "gpu".

version
str
valor predefinido: None

A versão do pacote.

as_dict

Devolver dependências conda.

as_dict() -> Any

create

Inicialize um novo objeto CondaDependencies.

Devolve uma instância de um objeto CondaDependencies com dependências especificadas pelo utilizador.

Nota

Se pip_packages não for especificado, as predefinições azureml serão adicionadas como dependências predefinidas. O utilizador especificou pip_packages dependências substituirão os valores predefinidos.

Se pin_sdk_version estiver definido como verdadeiro, as dependências pip dos pacotes distribuídos como parte do SDK Python do Azure Machine Learning serão afixadas à versão do SDK instalada no ambiente atual.

static create(pip_indexurl=None, pip_packages=None, conda_packages=None, python_version='3.8.13', pin_sdk_version=True)

Parâmetros

pip_indexurl
str
valor predefinido: None

O URL do índice pip. Se não for especificado, será utilizado o URL do índice de origem do SDK.

pip_packages
list[str]
valor predefinido: None

Uma lista de pacotes pip.

conda_packages
list[str]
valor predefinido: None

Uma lista de pacotes conda.

python_version
str
valor predefinido: 3.8.13

A versão do Python.

pin_sdk_version
bool
valor predefinido: True

Indica se deve afixar pacotes SDK à versão do cliente.

Devoluções

Um objeto de dependência conda.

Tipo de retorno

get_default_number_of_packages

Devolver o número predefinido de pacotes.

get_default_number_of_packages()

Devoluções

O número predefinido de pacotes conda e pip.

Tipo de retorno

int

get_python_version

Devolver a versão do Python.

get_python_version()

Devoluções

A versão do Python.

Tipo de retorno

str

merge_requirements

Requisitos de pacote de intercalação.

static merge_requirements(requirements)

Parâmetros

requirements
list[str]
Necessário

Uma lista de requisitos de pacotes para intercalar.

Devoluções

Uma lista de requisitos de pacotes intercalados.

Tipo de retorno

remove_channel

Remover um canal conda.

remove_channel(channel)

Parâmetros

channel
str
Necessário

O canal de conada a remover.

remove_conda_package

Remova um pacote conda.

remove_conda_package(conda_package)

Parâmetros

conda_package
str
Necessário

O pacote conda a remover.

remove_pip_option

Remover uma opção pip.

remove_pip_option(pip_option)

Parâmetros

pip_option
str
Necessário

A opção pip a remover.

remove_pip_package

Remova um pacote pip.

remove_pip_package(pip_package)

Parâmetros

pip_package
str
Necessário

O pacote pip a remover.

save

Guarde o objeto conda dependencies no ficheiro.

save(path=None)

Parâmetros

path
str
valor predefinido: None

O caminho completamente qualificado do ficheiro no qual pretende guardar.

Devoluções

O caminho conda normalizado.

Tipo de retorno

str

Exceções

Gerado para problemas ao guardar as dependências.

save_to_file

PRETERIDO, utilize save.

Guarde o objeto conda dependencies no ficheiro.

save_to_file(base_directory, conda_file_path=None)

Parâmetros

base_directory
str
Necessário

O diretório base para guardar o ficheiro.

conda_file_path
str
valor predefinido: None

O nome do ficheiro.

Devoluções

O caminho conda normalizado.

Tipo de retorno

str

sdk_origin_url

Devolver o URL do índice de origem do SDK.

static sdk_origin_url()

Devoluções

Devolve o URL do índice de origem do SDK.

Tipo de retorno

str

serialize_to_string

Serialize o objeto de dependências conda numa cadeia.

serialize_to_string()

Devoluções

O objeto de dependências conda foi serializado numa cadeia.

Tipo de retorno

str

set_pip_index_url

Defina o URL do índice pip.

set_pip_index_url(index_url)

Parâmetros

index_url
str
Necessário

O URL do índice pip a utilizar.

set_pip_option

Adicione uma opção pip.

set_pip_option(pip_option)

Parâmetros

pip_option
str
Necessário

A opção pip a adicionar.

set_pip_requirements

Substitua toda a secção pip de dependências conda.

set_pip_requirements(pip_requirements)

Parâmetros

pip_requirements
list[str]
Necessário

A lista de pacotes e opções de pip.

set_python_version

Defina a versão do Python.

set_python_version(version)

Parâmetros

version
str
Necessário

A versão do Python a adicionar.

Tipo de retorno

Atributos

conda_channels

Devolver canais conda.

Devoluções

Devolve as dependências do canal. As dependências devolvidas são uma cópia e quaisquer alterações aos canais devolvidos não atualizarão os canais conda neste objeto.

Tipo de retorno

conda_packages

Devolver pacotes conda.

Devoluções

Devolve as dependências do pacote. Devolve uma cópia dos pacotes conda e quaisquer edições à lista devolvida não serão refletidas nos pacotes conda deste objeto.

Tipo de retorno

pip_options

Devolver opções de pip.

Devoluções

Devolve as opções de pip. Devolve uma cópia das opções de pip e quaisquer edições à lista devolvida não serão refletidas nas opções de pip deste objeto.

Tipo de retorno

pip_packages

Devolver dependências do pip.

Devoluções

Devolve as dependências do pip. Devolve uma cópia dos pacotes pip e quaisquer edições à lista devolvida não serão refletidas nos pacotes pip deste objeto.

Tipo de retorno

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0