CondaDependencies クラス

Azure Machine Learning 環境内のアプリケーションの依存関係を管理します。

Note

パラメーターが指定されていない場合、唯一の pip 依存関係として azureml-defaults が追加されます。

conda_dependencies_file_path パラメーターが指定されていない場合、CondaDependencies オブジェクトには、Azure Machine Learning パッケージ (azureml-defaults) のみが含まれます。 azureml-defaults 依存関係は、特定のバージョンにピン留めされず、PyPi で使用できる最新バージョンをターゲットとします。

継承
builtins.object
CondaDependencies

コンストラクター

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

パラメーター

conda_dependencies_file_path
str
既定値: None

Conda 構成ファイルへのローカル パス。 このパラメーターを使用すると、既存の Conda 環境ファイルを読み込み、編集できます。

_underlying_structure
既定値: None

注釈

既存の Conda 環境ファイルを読み込むこと、またはメモリでアプリケーションの依存関係を構成して管理することができます。 実験の送信時に、Conda 環境を作成してキャッシュする準備手順が実行されます。この Conda 環境内で実験は実行されます。

依存関係が Conda と (PyPi からの) pip の両方で利用できる場合、Conda バージョンを使用してください。これは、Conda パッケージには、インストールの信頼性を高めるビルド済みのバイナリが通常付属しているためです。 詳細については、「Conda と Pip について」を参照してください。

基本イメージの依存関係について詳しくは、リポジトリ https://github.com/Azure/AzureML-Containers を参照してください。

次の例は、add_conda_package を使用してパッケージを追加する方法を示しています。


   from azureml.core.environment import CondaDependencies

   myenv = Environment(name="myenv")
   conda_dep = CondaDependencies()
   conda_dep.add_conda_package("scikit-learn==0.22.1")

完全なサンプルは、https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb から入手できます

pip パッケージも追加できます。依存関係は Environment オブジェクトで設定されます。


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

完全なサンプルは、https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb から入手できます

メソッド

add_channel

Conda チャネルを追加します。

チャネルの一覧については、https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/ を参照してください

add_cntk_package

Microsoft Cognitive Toolkit (CNTK) パッケージを追加します。

add_conda_package

Conda パッケージを追加します。

add_pip_package

pip パッケージを追加します。

Note

既に参照されているパッケージの依存関係を追加すると、前の参照が削除され、依存関係リストの末尾に新しい参照が追加されます。 これにより、依存関係の順序が変更される可能性があります。

add_tensorflow_conda_package

Tensorflow Conda パッケージを追加します。

add_tensorflow_pip_package

Tensorflow pip パッケージを追加します。

as_dict

Conda の依存関係を返します。

create

新しい CondaDependencies オブジェクトを初期化します。

ユーザー指定の依存関係を含む CondaDependencies オブジェクトのインスタンスを返します。

Note

pip_packages が指定されていない場合、azureml-defaults が既定の依存関係として追加されます。 ユーザー指定の pip_packages 依存関係により、既定値はオーバーライドされます。

pin_sdk_version が true に設定されている場合、Azure Machine Learning Python SDK の一部として配布されるパッケージの pip 依存関係は、現在の環境にインストールされている SDK のバージョンに合わせて固定されます。

get_default_number_of_packages

パッケージの既定の数を返します。

get_python_version

Python のバージョンを返します。

merge_requirements

パッケージ要件をマージします。

remove_channel

Conda チャネルを削除します。

remove_conda_package

Conda パッケージを削除します。

remove_pip_option

pip オプションを削除します。

remove_pip_package

pip パッケージを削除します。

save

Conda 依存関係オブジェクトをファイルに保存します。

save_to_file

非推奨です。save を使用してください。

Conda 依存関係オブジェクトをファイルに保存します。

sdk_origin_url

SDK の元のインデックス URL を返します。

serialize_to_string

Conda 依存関係オブジェクトを文字列にシリアル化します。

set_pip_index_url

pip インデックス URL を設定します。

set_pip_option

pip オプションを追加します。

set_pip_requirements

Conda 依存関係の pip セクション全体を上書きします。

set_python_version

Python バージョンを設定します。

add_channel

Conda チャネルを追加します。

チャネルの一覧については、https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/ を参照してください

add_channel(channel)

パラメーター

channel
str
必須

追加する Conda チャネル。

の戻り値の型 :

add_cntk_package

Microsoft Cognitive Toolkit (CNTK) パッケージを追加します。

add_cntk_package(core_type='cpu')

パラメーター

core_type
str
既定値: cpu

'cpu' または 'gpu'。

add_conda_package

Conda パッケージを追加します。

add_conda_package(conda_package)

パラメーター

conda_package
str
必須

追加する Conda パッケージ。

add_pip_package

pip パッケージを追加します。

Note

既に参照されているパッケージの依存関係を追加すると、前の参照が削除され、依存関係リストの末尾に新しい参照が追加されます。 これにより、依存関係の順序が変更される可能性があります。

add_pip_package(pip_package)

パラメーター

pip_package
str
必須

追加する pip パッケージ。

add_tensorflow_conda_package

Tensorflow Conda パッケージを追加します。

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

パラメーター

core_type
str
既定値: cpu

'cpu' または 'gpu'。

version
str
既定値: None

パッケージのバージョンです。

add_tensorflow_pip_package

Tensorflow pip パッケージを追加します。

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

パラメーター

core_type
str
既定値: cpu

'cpu' または 'gpu'。

version
str
既定値: None

パッケージのバージョンです。

as_dict

Conda の依存関係を返します。

as_dict() -> Any

create

新しい CondaDependencies オブジェクトを初期化します。

ユーザー指定の依存関係を含む CondaDependencies オブジェクトのインスタンスを返します。

Note

pip_packages が指定されていない場合、azureml-defaults が既定の依存関係として追加されます。 ユーザー指定の pip_packages 依存関係により、既定値はオーバーライドされます。

pin_sdk_version が true に設定されている場合、Azure Machine Learning Python SDK の一部として配布されるパッケージの pip 依存関係は、現在の環境にインストールされている SDK のバージョンに合わせて固定されます。

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

パラメーター

pip_indexurl
str
既定値: None

pip インデックス URL。 指定しない場合、SDK の元のインデックス URL が使用されます。

pip_packages
list[str]
既定値: None

pip パッケージのリスト。

conda_packages
list[str]
既定値: None

Conda パッケージのリスト。

python_version
str
既定値: 3.8.13

Python のバージョン。

pin_sdk_version
bool
既定値: True

SDK パッケージをクライアント バージョンに合わせて固定するかどうかを示します。

戻り値

Conda 依存関係オブジェクト。

の戻り値の型 :

get_default_number_of_packages

パッケージの既定の数を返します。

get_default_number_of_packages()

戻り値

Conda および pip パッケージの既定の数。

の戻り値の型 :

int

get_python_version

Python のバージョンを返します。

get_python_version()

戻り値

Python のバージョン。

の戻り値の型 :

str

merge_requirements

パッケージ要件をマージします。

static merge_requirements(requirements)

パラメーター

requirements
list[str]
必須

マージするパッケージ要件のリスト。

戻り値

マージされたパッケージ要件のリスト。

の戻り値の型 :

remove_channel

Conda チャネルを削除します。

remove_channel(channel)

パラメーター

channel
str
必須

削除する Conda チャネル。

remove_conda_package

Conda パッケージを削除します。

remove_conda_package(conda_package)

パラメーター

conda_package
str
必須

削除する Conda パッケージ。

remove_pip_option

pip オプションを削除します。

remove_pip_option(pip_option)

パラメーター

pip_option
str
必須

削除する pip オプション。

remove_pip_package

pip パッケージを削除します。

remove_pip_package(pip_package)

パラメーター

pip_package
str
必須

削除する pip パッケージ。

save

Conda 依存関係オブジェクトをファイルに保存します。

save(path=None)

パラメーター

path
str
既定値: None

保存する先のファイルの完全修飾パス。

戻り値

正規化された Conda パス。

の戻り値の型 :

str

例外

依存関係の保存に問題がある場合に発生します。

save_to_file

非推奨です。save を使用してください。

Conda 依存関係オブジェクトをファイルに保存します。

save_to_file(base_directory, conda_file_path=None)

パラメーター

base_directory
str
必須

ファイルを保存するベース ディレクトリ。

conda_file_path
str
既定値: None

ファイル名。

戻り値

正規化された Conda パス。

の戻り値の型 :

str

sdk_origin_url

SDK の元のインデックス URL を返します。

static sdk_origin_url()

戻り値

SDK の元のインデックス URL を返します。

の戻り値の型 :

str

serialize_to_string

Conda 依存関係オブジェクトを文字列にシリアル化します。

serialize_to_string()

戻り値

文字列にシリアル化された Conda 依存関係オブジェクト。

の戻り値の型 :

str

set_pip_index_url

pip インデックス URL を設定します。

set_pip_index_url(index_url)

パラメーター

index_url
str
必須

使用する pip インデックス URL。

set_pip_option

pip オプションを追加します。

set_pip_option(pip_option)

パラメーター

pip_option
str
必須

追加する pip オプション。

set_pip_requirements

Conda 依存関係の pip セクション全体を上書きします。

set_pip_requirements(pip_requirements)

パラメーター

pip_requirements
list[str]
必須

pip パッケージとオプションのリスト。

set_python_version

Python バージョンを設定します。

set_python_version(version)

パラメーター

version
str
必須

追加する Python バージョン。

の戻り値の型 :

属性

conda_channels

Conda チャネルを返します。

戻り値

チャネルの依存関係を返します。 返される依存関係はコピーであり、返されたチャネルに変更を加えても、このオブジェクトの Conda チャネルは更新されません。

の戻り値の型 :

conda_packages

Conda パッケージを返します。

戻り値

パッケージの依存関係を返します。 Conda パッケージのコピーを返します。返されたリストを編集しても、このオブジェクトの Conda パッケージには反映されません。

の戻り値の型 :

pip_options

pip オプションを返します。

戻り値

pip オプションを返します。 pip オプションのコピーを返します。返されたリストを編集しても、このオブジェクトの pip オプションには反映されません。

の戻り値の型 :

pip_packages

pip の依存関係を返します。

戻り値

pip の依存関係を返します。 pip パッケージのコピーを返します。返されたリストを編集しても、このオブジェクトの pip パッケージには反映されません。

の戻り値の型 :

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0