KubernetesCompute 类

注释

这是一个实验类,随时可能会更改。 有关详细信息,请参阅 https://aka.ms/azuremlexperimental

KubernetesCompute (预览版)是由群集管理员附加到工作区的客户管理的 K8s 群集。

用户授予对计算的访问权限和配额可以轻松地将单节点或分布式多节点 ML 工作负荷提交到计算。 计算在容器化环境中执行,并将模型依赖项打包在 docker 容器中。 有关详细信息,请参阅 什么是 Azure 机器学习中的计算目标? https://docs.microsoft.com/azure/machine-learning/concept-compute-target

类 ComputeTarget 构造函数。

检索与提供的工作区关联的计算对象的云表示形式。 返回与检索的计算对象的特定类型对应的子类的实例。

构造函数

KubernetesCompute(workspace, name)

参数

名称 说明
workspace
必需

包含要检索的 KubernetesCompute 对象的工作区对象。

name
必需
str

要检索的 KubernetesCompute 对象的名称。

workspace
必需

包含要检索的 Compute 对象的工作区对象。

name
必需
str

要检索的 Compute 对象的名称。

注解

在以下示例中,将创建由 <xref:azureml.contrib.core.compute.KubernetesCompute.KubernetesCompute> 其预配的持久性计算目标。 此示例中的参数的类型 的子类

方法

attach_configuration

创建用于附加计算目标的配置对象。

delete

KubernetesCompute 对象不支持删除。 请改用 detach

deserialize

将 JSON 对象转换为 KubernetesCompute 对象。

detach

从其关联的工作区中分离 KubernetesCompute 对象。

基础云对象不会被删除,只会删除关联。

get

将 GET 计算对象请求发送到 mlc。

get_status

检索 KubernetesCompute 群集的当前详细状态。

refresh_state

对对象的属性执行就地更新。

此方法根据相应云对象的当前状态更新属性。 这主要用于手动轮询计算状态。

serialize

将此 KubernetesCompute 对象转换为 JSON 序列化字典。

wait_for_completion

等待 KubernetesCompute 群集完成预配。

attach_configuration

创建用于附加计算目标的配置对象。

static attach_configuration(resource_id=None, namespace=None, identity_type=None, identity_ids=None)

参数

名称 说明
resource_id
str

资源 ID。

默认值: None
namespace
str

要由提交到计算目标的工作负荷使用的 Kubernetes 命名空间。

默认值: None
identity_type

标识类型。

默认值: None
identity_ids

用户分配标识的资源 ID 列表。 例如 ['/subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<id>']

默认值: None

返回

类型 说明
<xref:azureml.contrib.core.compute.KubernetesCompute.KubernetesComputeAttachConfiguration>

附加 KubernetesCompute 对象时要使用的配置对象。

delete

KubernetesCompute 对象不支持删除。 请改用 detach

delete()

例外

类型 说明

deserialize

将 JSON 对象转换为 KubernetesCompute 对象。

static deserialize(workspace, object_dict)

参数

名称 说明
workspace
必需

与 KubernetesCompute 对象关联的工作区对象。

object_dict
必需

要转换为 KubernetesCompute 对象的 JSON 对象。

返回

类型 说明
<xref:azureml.contrib.core.compute.KubernetesCompute.KubernetesCompute>

提供的 JSON 对象的 KubernetesCompute 表示形式。

例外

类型 说明

注解

如果提供的工作区不是计算与之关联的工作区,则引发该 ComputeTargetException 工作区。

detach

从其关联的工作区中分离 KubernetesCompute 对象。

基础云对象不会被删除,只会删除关联。

detach()

例外

类型 说明

get

将 GET 计算对象请求发送到 mlc。

get()

get_status

检索 KubernetesCompute 群集的当前详细状态。

get_status()

返回

类型 说明

群集的详细状态对象

refresh_state

对对象的属性执行就地更新。

此方法根据相应云对象的当前状态更新属性。 这主要用于手动轮询计算状态。

refresh_state()

serialize

将此 KubernetesCompute 对象转换为 JSON 序列化字典。

serialize()

返回

类型 说明

此 KubernetesCompute 对象的 JSON 表示形式。

wait_for_completion

等待 KubernetesCompute 群集完成预配。

wait_for_completion(show_output=False, is_delete_operation=False)

参数

名称 说明
show_output

用于提供更详细输出的布尔值。

默认值: False
is_delete_operation

指示作是否用于删除。

默认值: False

例外

类型 说明