AksCompute Класс

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

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

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

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

Наследование
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 для объекта вычислений.

Возвращаемый тип

Исключения

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
значение по умолчанию: None

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

cluster_name
str
значение по умолчанию: None

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

resource_id
str
значение по умолчанию: None

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

cluster_purpose
str
значение по умолчанию: None

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

load_balancer_type
str
значение по умолчанию: None

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

load_balancer_subnet
str
значение по умолчанию: None

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

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

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

Возвращаемый тип

Исключения

delete

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

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

delete()

Исключения

deserialize

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

static deserialize(workspace, object_dict)

Параметры

workspace
Workspace
Обязательно

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

object_dict
dict
Обязательно

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

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

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

Возвращаемый тип

Исключения

Комментарии

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

detach

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

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

detach()

Исключения

get_credentials

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

get_credentials()

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

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

Возвращаемый тип

Исключения

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
значение по умолчанию: None

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

vm_size
str
значение по умолчанию: None

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

ssl_cname
str
значение по умолчанию: None

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

ssl_cert_pem_file
str
значение по умолчанию: None

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

ssl_key_pem_file
str
значение по умолчанию: None

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

location
str
значение по умолчанию: None

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

vnet_resourcegroup_name
str
значение по умолчанию: None

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

vnet_name
str
значение по умолчанию: None

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

subnet_name
str
значение по умолчанию: None

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

service_cidr
str
значение по умолчанию: None

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

dns_service_ip
str
значение по умолчанию: None

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

docker_bridge_cidr
str
значение по умолчанию: None

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

cluster_purpose
str
значение по умолчанию: None

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

load_balancer_type
str
значение по умолчанию: None

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

load_balancer_subnet
str
значение по умолчанию: None

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

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

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

Возвращаемый тип

Исключения

refresh_state

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

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

refresh_state()

Исключения

serialize

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

serialize()

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

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

Возвращаемый тип

Исключения

update

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

update(update_configuration)

Параметры

update_configuration
AksUpdateConfiguration
Обязательно

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

Исключения