AksCompute クラス
Azure Machine Learning 内で Azure Kubernetes Service のコンピューティング先を管理します。
Azure Kubernetes Service (AKSCompute) のターゲットは、デプロイされたサービスの高速な応答時間と自動スケールを実現できるため、通常は大規模な運用環境のデプロイに使用されます。 詳細については、Azure Machine Learning でのコンピューティング先 に関する記事をご覧ください。
ComputeTarget クラスコンストラクター。
指定されたワークスペースに関連付けられている Compute オブジェクトのクラウド表現を取得します。 取得した Compute オブジェクトの特定の型に対応する子クラスのインスタンスを返します。
- 継承
-
AksCompute
コンストラクター
AksCompute(workspace, name)
パラメーター
注釈
次のサンプルは、FPGA 対応マシンで AKS クラスターを作成する方法を示しています。
from azureml.core.compute import AksCompute, ComputeTarget
# Uses the specific FPGA enabled VM (sku: Standard_PB6s)
# Standard_PB6s are available in: eastus, westus2, westeurope, southeastasia
prov_config = AksCompute.provisioning_configuration(vm_size = "Standard_PB6s",
agent_count = 1,
location = "eastus")
aks_name = 'my-aks-pb6'
# Create the cluster
aks_target = ComputeTarget.create(workspace = ws,
name = aks_name,
provisioning_configuration = prov_config)
メソッド
attach |
非推奨。 代わりに、 既存の AKS コンピューティング リソースを、指定されたワークスペースに関連付けます。 |
attach_configuration |
AKS コンピューティング先をアタッチするための構成オブジェクトを作成します。 |
delete |
AksCompute オブジェクトを、それが関連付けられているワークスペースから削除します。 このオブジェクトが Azure Machine Learning によって作成された場合は、対応するクラウド ベースのオブジェクトも削除されます。 このオブジェクトが外部で作成され、ワークスペースにアタッチされているだけの場合、このメソッドによって ComputeTargetException が発生し、何も変更されません。 |
deserialize |
JSON オブジェクトを AksCompute オブジェクトに変換します。 |
detach |
AksCompute オブジェクトを、それが関連付けられているワークスペースからデタッチします。 基になるクラウド オブジェクトは削除されず、関連付けだけが削除されます。 |
get_credentials |
AKS ターゲットの資格情報を取得します。 |
provisioning_configuration |
AKS コンピューティング先をプロビジョニングするための構成オブジェクトを作成します。 |
refresh_state |
オブジェクトのプロパティのインプレース更新を実行します。 このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいてプロパティを更新します。 これは主に、コンピューティング状態の手動ポーリングに使用されます。 |
serialize |
この AksCompute オブジェクトを、JSON でシリアル化された辞書に変換します。 |
update |
指定された更新構成を使用して AksCompute オブジェクトを更新します。 |
attach
非推奨。 代わりに、attach_configuration
メソッドを使用してください。
既存の AKS コンピューティング リソースを、指定されたワークスペースに関連付けます。
static attach(workspace, name, resource_id)
パラメーター
戻り値
コンピューティング オブジェクトの AksCompute オブジェクト表現。
の戻り値の型 :
例外
attach_configuration
AKS コンピューティング先をアタッチするための構成オブジェクトを作成します。
static attach_configuration(resource_group=None, cluster_name=None, resource_id=None, cluster_purpose=None, load_balancer_type=None, load_balancer_subnet=None)
パラメーター
- cluster_purpose
- str
クラスターの目的とする使用方法。 これは、Azure Machine Learning コンポーネントをプロビジョニングして必要なレベルのフォールト トレランスと QoS を確保するために使用されます。 ClusterPurpose クラスは、指定できる値を定義します。 詳細については、「既存の AKS クラスターをアタッチする」を参照してください。
- load_balancer_type
- str
AKS クラスターの種類。 有効な値は、PublicIp と InternalLoadBalancer です。 既定値は PublicIp です。
- load_balancer_subnet
- str
AKS ロード バランサー サブネット。 これは、ロード バランサーの種類として InternalLoadBalancer を使用する場合にのみ使用できます。 既定値は aks-subnet です。
戻り値
コンピューティング オブジェクトをアタッチするときに使用する構成オブジェクト。
の戻り値の型 :
例外
delete
AksCompute オブジェクトを、それが関連付けられているワークスペースから削除します。
このオブジェクトが Azure Machine Learning によって作成された場合は、対応するクラウド ベースのオブジェクトも削除されます。 このオブジェクトが外部で作成され、ワークスペースにアタッチされているだけの場合、このメソッドによって ComputeTargetException が発生し、何も変更されません。
delete()
例外
deserialize
JSON オブジェクトを AksCompute オブジェクトに変換します。
static deserialize(workspace, object_dict)
パラメーター
戻り値
指定された JSON オブジェクトの AksCompute 表現。
の戻り値の型 :
例外
注釈
指定されたワークスペースが、Compute が関連付けられているワークスペースでない場合、ComputeTargetException を発生させます。
detach
AksCompute オブジェクトを、それが関連付けられているワークスペースからデタッチします。
基になるクラウド オブジェクトは削除されず、関連付けだけが削除されます。
detach()
例外
get_credentials
provisioning_configuration
AKS コンピューティング先をプロビジョニングするための構成オブジェクトを作成します。
static provisioning_configuration(agent_count=None, vm_size=None, ssl_cname=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, location=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, service_cidr=None, dns_service_ip=None, docker_bridge_cidr=None, cluster_purpose=None, load_balancer_type=None, load_balancer_subnet=None)
パラメーター
- vm_size
- str
エージェント VM のサイズ。 オプションの完全なリストについては、https://aka.ms/azureml-aks-details を参照してください。 既定値は Standard_D3_v2 です。
- ssl_cname
- str
クラスター上で SSL 検証を有効にする場合に使用する CName。 SSL 検証を有効にするには、CName、証明書ファイル、キー ファイルの 3 つすべてを指定する必要があります。
- ssl_cert_pem_file
- str
SSL 検証用の証明書情報が含まれているファイルへのファイル パス。 SSL 検証を有効にするには、CName、証明書ファイル、キー ファイルの 3 つすべてを指定する必要があります。
- ssl_key_pem_file
- str
SSL 検証用のキー情報が含まれているファイルへのファイル パス。 SSL 検証を有効にするには、CName、証明書ファイル、キー ファイルの 3 つすべてを指定する必要があります。
- location
- str
クラスターをプロビジョニングする場所。 指定されていない場合は、既定のワークスペースの場所になります。 このコンピューティングで使用可能なリージョンは、次の場所にあります。https://azure.microsoft.com/global-infrastructure/services/?regions=all&products=kubernetes-service
- cluster_purpose
- str
クラスターの目的とする使用方法。 これは、Azure Machine Learning コンポーネントをプロビジョニングして必要なレベルのフォールト トレランスと QoS を確保するために使用されます。 使用可能な値を簡単に指定できるように、AksCompute.ClusterPurpose クラスが用意されています。 これらの値とそのユース ケースの詳細については、https://aka.ms/azureml-create-attach-aks を参照してください。
- load_balancer_type
- str
AKS クラスターのロード バランサーの種類。 有効な値は、PublicIp と InternalLoadBalancer です。 既定値は PublicIp です。
- load_balancer_subnet
- str
AKS クラスターのロード バランサー サブネット。 これは、内部ロード バランサーがロード バランサーの種類として使用されている場合にのみ使用できます。 既定値は aks-subnet です。
戻り値
コンピューティング オブジェクトの作成時に使用される構成オブジェクト
の戻り値の型 :
例外
refresh_state
オブジェクトのプロパティのインプレース更新を実行します。
このメソッドは、対応するクラウド オブジェクトの現在の状態に基づいてプロパティを更新します。 これは主に、コンピューティング状態の手動ポーリングに使用されます。
refresh_state()
例外
serialize
この AksCompute オブジェクトを、JSON でシリアル化された辞書に変換します。
serialize()
戻り値
この AksCompute オブジェクトの JSON 表現。
の戻り値の型 :
例外
update
指定された更新構成を使用して AksCompute オブジェクトを更新します。
update(update_configuration)
パラメーター
例外
フィードバック
https://aka.ms/ContentUserFeedback。
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください:フィードバックの送信と表示