CondaDependencies クラス
Azure Machine Learning 環境でのアプリケーションの依存関係を管理します。
注
パラメーターが指定されていない場合は、唯一の pip 依存関係として azureml-defaults が追加されます。
conda_dependencies_file_path パラメーターが指定されていない場合、CondaDependencies オブジェクトには Azure Machine Learning パッケージのみが含まれます (azureml-defaults)。
azureml-defaults 依存関係は特定のバージョンにピン留めされず、PyPi で使用可能な最新バージョンを対象とします。
依存関係を管理するために新しいオブジェクトを初期化します。
コンストラクター
CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)
パラメーター
| 名前 | 説明 |
|---|---|
|
conda_dependencies_file_path
|
conda 構成ファイルへのローカル パス。 このパラメーターを使用すると、既存の Conda 環境ファイルを読み込んで編集できます。 規定値: None
|
|
_underlying_structure
|
規定値: None
|
注釈
既存の conda 環境ファイルを読み込むか、メモリ内のアプリケーションの依存関係を構成して管理することを選択できます。 実験の送信中に、実験が実行される conda 環境を作成してキャッシュする準備ステップが実行されます。
依存関係が Conda と pip (PyPi) の両方で使用できる場合は、Conda バージョンを使用します。Conda パッケージには通常、インストールの信頼性を高めるために事前にビルドされたバイナリが付属しているためです。 詳細については、「 Conda と Pip について」を参照してください。
基本イメージの依存関係の詳細については、リポジトリの https://github.com/Azure/AzureML-Containers を参照してください。
次の例は、 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))
完全なサンプルは次から入手できます https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.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 パッケージを追加します。 注 既に参照されているパッケージの依存関係を追加すると、前の参照が削除され、依存関係リストの末尾に新しい参照が追加されます。 これにより、依存関係の順序が変更される可能性があります。 |
| add_tensorflow_conda_package |
Tensorflow conda パッケージを追加します。 |
| add_tensorflow_pip_package |
Tensorflow pip パッケージを追加します。 |
| as_dict |
conda の依存関係を返します。 |
| create |
新しい CondaDependencies オブジェクトを初期化します。 ユーザーが指定した依存関係を持つ CondaDependencies オブジェクトのインスタンスを返します。 注 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
必須
|
追加する conda チャネル。 |
戻り値
| 型 | 説明 |
|---|---|
add_cntk_package
Microsoft Cognitive Toolkit (CNTK) パッケージを追加します。
add_cntk_package(core_type='cpu')
パラメーター
| 名前 | 説明 |
|---|---|
|
core_type
|
'cpu' または 'gpu'。 規定値: cpu
|
add_conda_package
conda パッケージを追加します。
add_conda_package(conda_package)
パラメーター
| 名前 | 説明 |
|---|---|
|
conda_package
必須
|
追加する conda パッケージ。 |
add_pip_package
pip パッケージを追加します。
注
既に参照されているパッケージの依存関係を追加すると、前の参照が削除され、依存関係リストの末尾に新しい参照が追加されます。 これにより、依存関係の順序が変更される可能性があります。
add_pip_package(pip_package)
パラメーター
| 名前 | 説明 |
|---|---|
|
pip_package
必須
|
追加する pip パッケージ。 |
add_tensorflow_conda_package
add_tensorflow_pip_package
as_dict
conda の依存関係を返します。
as_dict() -> Any
create
新しい CondaDependencies オブジェクトを初期化します。
ユーザーが指定した依存関係を持つ CondaDependencies オブジェクトのインスタンスを返します。
注
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.9.12', pin_sdk_version=True)
パラメーター
| 名前 | 説明 |
|---|---|
|
pip_indexurl
|
pip インデックスの URL。 指定しない場合は、SDK の配信元インデックス URL が使用されます。 規定値: None
|
|
pip_packages
|
pip パッケージの一覧。 規定値: None
|
|
conda_packages
|
conda パッケージの一覧。 規定値: None
|
|
python_version
|
Python バージョン。 規定値: 3.9.12
|
|
pin_sdk_version
|
SDK パッケージをクライアント バージョンにピン留めするかどうかを示します。 規定値: True
|
戻り値
| 型 | 説明 |
|---|---|
|
conda 依存関係オブジェクト。 |
get_default_number_of_packages
get_python_version
merge_requirements
remove_channel
remove_conda_package
conda パッケージを削除します。
remove_conda_package(conda_package)
パラメーター
| 名前 | 説明 |
|---|---|
|
conda_package
必須
|
削除する conda パッケージ。 |
remove_pip_option
remove_pip_package
save
conda 依存関係オブジェクトをファイルに保存します。
save(path=None)
パラメーター
| 名前 | 説明 |
|---|---|
|
path
|
保存するファイルの完全修飾パス。 規定値: None
|
戻り値
| 型 | 説明 |
|---|---|
|
正規化された conda パス。 |
例外
| 型 | 説明 |
|---|---|
|
依存関係の保存に関する問題が発生しました。 |
save_to_file
sdk_origin_url
serialize_to_string
set_pip_index_url
pip インデックス URL を設定します。
set_pip_index_url(index_url)
パラメーター
| 名前 | 説明 |
|---|---|
|
index_url
必須
|
使用する pip インデックス URL。 |
set_pip_option
set_pip_requirements
set_python_version
属性
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