Partilhar via

CondaDependencies Classe

  • Referência

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

Name Description
conda_dependencies_file_path
str

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.

Default value: None
_underlying_structure
Default value: 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

Name Description
channel
Necessário
str

O canal conda a adicionar.

Devoluções

Tipo Description
None

add_cntk_package

Adicione um pacote Microsoft Cognitive Toolkit (CNTK).

add_cntk_package(core_type='cpu')

Parâmetros

Name Description
core_type
str

"cpu" ou "gpu".

Default value: cpu

add_conda_package

Adicione um pacote conda.

add_conda_package(conda_package)

Parâmetros

Name Description
conda_package
Necessário
str

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

Name Description
pip_package
Necessário
str

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

Name Description
core_type
str

"cpu" ou "gpu".

Default value: cpu
version
str

A versão do pacote.

Default value: None

add_tensorflow_pip_package

Adicione um pacote pip do Tensorflow.

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

Parâmetros

Name Description
core_type
str

"cpu" ou "gpu".

Default value: cpu
version
str

A versão do pacote.

Default value: None

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.9.12', pin_sdk_version=True)

Parâmetros

Name Description
pip_indexurl
str

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

Default value: None
pip_packages
list[str]

Uma lista de pacotes pip.

Default value: None
conda_packages
list[str]

Uma lista de pacotes conda.

Default value: None
python_version
str

A versão do Python.

Default value: 3.9.12
pin_sdk_version
bool

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

Default value: True

Devoluções

Tipo Description
CondaDependencies

Um objeto de dependência conda.

get_default_number_of_packages

Devolver o número predefinido de pacotes.

get_default_number_of_packages()

Devoluções

Tipo Description
int

O número predefinido de pacotes conda e pip.

get_python_version

Devolver a versão do Python.

get_python_version()

Devoluções

Tipo Description
str

A versão do Python.

merge_requirements

Requisitos de pacote de intercalação.

static merge_requirements(requirements)

Parâmetros

Name Description
requirements
Necessário
list[str]

Uma lista de requisitos de pacotes para intercalar.

Devoluções

Tipo Description
list[str]

Uma lista de requisitos de pacotes intercalados.

remove_channel

Remover um canal conda.

remove_channel(channel)

Parâmetros

Name Description
channel
Necessário
str

O canal de conada a remover.

remove_conda_package

Remova um pacote conda.

remove_conda_package(conda_package)

Parâmetros

Name Description
conda_package
Necessário
str

O pacote conda a remover.

remove_pip_option

Remover uma opção pip.

remove_pip_option(pip_option)

Parâmetros

Name Description
pip_option
Necessário
str

A opção pip a remover.

remove_pip_package

Remova um pacote pip.

remove_pip_package(pip_package)

Parâmetros

Name Description
pip_package
Necessário
str

O pacote pip a remover.

save

Guarde o objeto conda dependencies no ficheiro.

save(path=None)

Parâmetros

Name Description
path
str

O caminho completamente qualificado do ficheiro no qual pretende guardar.

Default value: None

Devoluções

Tipo Description
str

O caminho conda normalizado.

Exceções

Tipo Description
UserErrorException

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

Name Description
base_directory
Necessário
str

O diretório base para guardar o ficheiro.
conda_file_path
str

O nome do ficheiro.

Default value: None

Devoluções

Tipo Description
str

O caminho conda normalizado.

sdk_origin_url

Devolver o URL do índice de origem do SDK.

static sdk_origin_url()

Devoluções

Tipo Description
str

Devolve o URL do índice de origem do SDK.

serialize_to_string

Serialize o objeto de dependências conda numa cadeia.

serialize_to_string()

Devoluções

Tipo Description
str

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

set_pip_index_url

Defina o URL do índice pip.

set_pip_index_url(index_url)

Parâmetros

Name Description
index_url
Necessário
str

O URL do índice pip a utilizar.

set_pip_option

Adicione uma opção pip.

set_pip_option(pip_option)

Parâmetros

Name Description
pip_option
Necessário
str

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

Name Description
pip_requirements
Necessário
list[str]

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

set_python_version

Defina a versão do Python.

set_python_version(version)

Parâmetros

Name Description
version
Necessário
str

A versão do Python a adicionar.

Devoluções

Tipo Description
None

Atributos

conda_channels

Devolver canais conda.

Devoluções

Tipo Description
iter

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.

conda_packages

Devolver pacotes conda.

Devoluções

Tipo Description
iter

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.

pip_options

Devolver opções de pip.

Devoluções

Tipo Description
iter

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.

pip_packages

Devolver dependências do pip.

Devoluções

Tipo Description
iter

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.

DEFAULT_NUMBER_OF_CONDA_PACKAGES 

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES 

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0