Поделиться через

AksCompute Класс

  • Ссылка

Управляет целевым объектом вычислений Службы Azure Kubernetes в Машинном обучении Azure.

Целевые объекты Службы Azure Kubernetes (AKSCompute) обычно используются для крупномасштабных рабочих развертываний, так как они обеспечивают быстрое время отклика и автоматическое масштабирование развернутой службы. Дополнительные сведения см. в статье Целевые объекты вычислений в Машинном обучении Microsoft Azure.

Конструктор Класса ComputeTarget.

Получение облачного представления объекта вычислений, связанного с предоставленной рабочей областью. Возвращает экземпляр дочернего класса, соответствующего конкретному типу полученного объекта Compute.

Наследование
ComputeTarget
AksCompute

Конструктор

AksCompute(workspace, name)

Параметры

Имя Описание
workspace
Обязательно
Workspace

Объект рабочей области, содержащий извлекаемый объект AksCompute.
name
Обязательно
str

Имя извлекаемого объекта AksCompute.
workspace
Обязательно
Workspace

Объект рабочей области, содержащий извлекаемый объект вычислений.
name
Обязательно
str

Имя извлекаемого объекта Compute.

Комментарии

В следующем примере показано, как создать кластер 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

НЕ РЕКОМЕНДУЕТСЯ. Вместо этого рекомендуется использовать метод attach_configuration.

Связывание существующего вычислительного ресурса AKS с указанной рабочей областью.
attach_configuration

Создание объекта конфигурации для подключения целевого объекта вычислений AKS.
delete

Удаление объекта AksCompute из связанной с ним рабочей области.

Если этот объект был создан с помощью Машинного обучения Azure, будут удалены и соответствующие облачные объекты. Если этот объект был создан во внешней среде и просто подключен к рабочей области, данный метод генерирует 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)

Параметры

Имя Описание
workspace
Обязательно
Workspace

Объект рабочей области, с которым нужно связать вычислительный ресурс.
name
Обязательно
str

Имя, которое нужно связать с вычислительным ресурсом в указанной рабочей области. Не обязательно должно совпадать с именем подключаемого вычислительного ресурса.
resource_id
Обязательно
str

Идентификатор ресурса Azure для подключаемого вычислительного ресурса.

Возвращаемое значение

Тип Описание
AksCompute

Представление объекта AksCompute для объекта вычислений.

Исключения

Тип Описание
ComputeTargetException

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)

Параметры

Имя Описание
resource_group
str

Имя группы ресурсов, в которой находится AKS.

Default value: None
cluster_name
str

Имя кластера AKS.

Default value: None
resource_id
str

Идентификатор ресурса Azure для подключаемого вычислительного ресурса.

Default value: None
cluster_purpose
str

Целевое использование кластера. Это позволяет подготовить к работе компоненты Машинного обучения Azure, чтобы обеспечить требуемый уровень отказоустойчивости и качества обслуживания. Класс ClusterPurpose определяет возможные значения. Дополнительные сведения см. в статье Подключение существующего кластера AKS.

Default value: None
load_balancer_type
str

Тип кластера AKS. Допустимые значения: PublicIp и InternalLoadBalancer. Значение по умолчанию — PublicIp.

Default value: None
load_balancer_subnet
str

Подсеть подсистемы балансировки нагрузки AKS. Ее можно использовать, только если в качестве типа подсистемы балансировки нагрузки используется InternalLoadBalancer. Значение по умолчанию — aks-subnet.

Default value: None

Возвращаемое значение

Тип Описание
AksAttachConfiguration

Объект конфигурации, который нужно использовать при подключении объекта вычислений.

Исключения

Тип Описание
ComputeTargetException

delete

Удаление объекта AksCompute из связанной с ним рабочей области.

Если этот объект был создан с помощью Машинного обучения Azure, будут удалены и соответствующие облачные объекты. Если этот объект был создан во внешней среде и просто подключен к рабочей области, данный метод генерирует ComputeTargetException, ничего не изменяя.

delete()

Исключения

Тип Описание
ComputeTargetException

deserialize

Преобразование объекта JSON в объект AksCompute.

static deserialize(workspace, object_dict)

Параметры

Имя Описание
workspace
Обязательно
Workspace

Объект рабочей области, с которым связан объект AksCompute.
object_dict
Обязательно
dict

Объект JSON для преобразования в объект AksCompute.

Возвращаемое значение

Тип Описание
AksCompute

Представление AksCompute указанного объекта JSON.

Исключения

Тип Описание
ComputeTargetException

Комментарии

Генерирует ComputeTargetException, если указана не та рабочая область, с которой связано вычисление.

detach

Отсоединение объекта AksCompute от связанной с ним рабочей области.

Базовые облачные объекты при этом сохраняются, удаляется только связь.

detach()

Исключения

Тип Описание
ComputeTargetException

get_credentials

Получение учетных данных для целевого объекта AKS.

get_credentials()

Возвращаемое значение

Тип Описание
dict

Учетные данные для целевого объекта AKS.

Исключения

Тип Описание
ComputeTargetException

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)

Параметры

Имя Описание
agent_count
int

Количество агентов (виртуальных машин) для размещения контейнеров. Значение по умолчанию — 3.

Default value: None
vm_size
str

Размер виртуальных машин агента. Полный список параметров можно найти здесь: https://aka.ms/azureml-aks-details. Значение по умолчанию — Standard_D3_v2.

Default value: None
ssl_cname
str

Запись CName, используемая при включении проверки SSL в кластере. Для включения проверки SSL необходимо предоставить все три объекта: запись CName, файл сертификата и файл ключа.

Default value: None
ssl_cert_pem_file
str

Путь к файлу, содержащему сведения о сертификате для проверки SSL. Для включения проверки SSL необходимо предоставить все три объекта: запись CName, файл сертификата и файл ключа.

Default value: None
ssl_key_pem_file
str

Путь к файлу, содержащему сведения о ключе для проверки SSL. Для включения проверки SSL необходимо предоставить все три объекта: запись CName, файл сертификата и файл ключа.

Default value: None
location
str

Расположение, в котором будет подготавливаться кластер. Если не указано иное, по умолчанию будет задано расположение рабочей области. Доступные регионы для этого вычисления можно найти здесь: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

Default value: None
vnet_resourcegroup_name
str

Имя группы ресурсов, в которой находится виртуальная сеть.

Default value: None
vnet_name
str

Имя виртуальной сети.

Default value: None
subnet_name
str

Имя подсети в виртуальной сети.

Default value: None
service_cidr
str

Диапазон IP-адресов нотации CIDR, из которого назначаются IP-адреса кластера службы.

Default value: None
dns_service_ip
str

IP-адрес DNS-сервера контейнеров.

Default value: None
docker_bridge_cidr
str

IP-адрес в нотации CIDR для моста Docker.

Default value: None
cluster_purpose
str

Целевое использование кластера. Это позволяет подготовить к работе компоненты Машинного обучения Azure, чтобы обеспечить требуемый уровень отказоустойчивости и качества обслуживания. Класс AksCompute.ClusterPurpose предоставляется, чтобы можно было легко указать доступные значения. Более подробные сведения об этих значениях и вариантах их использования можно найти здесь: https://aka.ms/azureml-create-attach-aks

Default value: None
load_balancer_type
str

Тип подсистемы балансировки нагрузки кластера AKS. Допустимые значения: PublicIp и InternalLoadBalancer. Значение по умолчанию — PublicIp.

Default value: None
load_balancer_subnet
str

Подсеть подсистемы балансировки нагрузки кластера AKS. Ее можно использовать, только если в качестве типа подсистемы балансировки нагрузки используется внутренняя Load Balancer. Значение по умолчанию — aks-subnet.

Default value: None

Возвращаемое значение

Тип Описание
AksProvisioningConfiguration

Объект конфигурации, который нужно использовать при создании объекта вычислений

Исключения

Тип Описание
ComputeTargetException

refresh_state

Выполнение обновлений свойств объекта на месте.

Этот метод обновляет свойства согласно текущему состоянию соответствующего облачного объекта. В основном используется для опроса состояния вычислений вручную.

refresh_state()

Исключения

Тип Описание
ComputeTargetException

serialize

Преобразование этого объекта AksCompute в сериализованный словарь JSON.

serialize()

Возвращаемое значение

Тип Описание
dict

Представление JSON этого объекта AksCompute.

Исключения

Тип Описание
ComputeTargetException

update

Обновление объекта AksCompute с помощью предоставленной конфигурации обновления.

update(update_configuration)

Параметры

Имя Описание
update_configuration
Обязательно
AksUpdateConfiguration

Объект конфигурации обновления AKS.

Исключения

Тип Описание
ComputeTargetException