AksCompute Класс
Управляет целевым объектом вычислений Службы Azure Kubernetes в Машинном обучении Azure.
Целевые объекты службы Azure Kubernetes (AKSCompute) обычно используются для крупномасштабных рабочих развертываний, так как они обеспечивают быстрое время отклика и автоматическое масштабирование развернутой службы. Дополнительные сведения см. в статье "Что такое целевые объекты вычислений в Машинном обучении Azure"?
Конструктор ComputeTarget класса.
Получение облачного представления объекта Вычислений, связанного с предоставленной рабочей областью. Возвращает экземпляр дочернего класса, соответствующего конкретному типу извлеченного вычислительного объекта.
Конструктор
AksCompute(workspace, name)
Параметры
| Имя | Описание |
|---|---|
|
workspace
Обязательно
|
Объект рабочей области, содержащий объект AksCompute для извлечения. |
|
name
Обязательно
|
Имя извлекаемого объекта AksCompute. |
|
workspace
Обязательно
|
Объект рабочей области, содержащий объект Compute для извлечения. |
|
name
Обязательно
|
Имя извлекаемого объекта Вычислений. |
Комментарии
В следующем примере показано, как создать кластер AKS с компьютерами с поддержкой FPGA.
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, соответствующие облачные объекты также будут удалены. Если этот объект был создан внешне и подключен только к рабочей области, этот метод вызывает и 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
Обязательно
|
Объект рабочей области для связывания вычислительного ресурса с. |
|
name
Обязательно
|
Имя для связывания с вычислительным ресурсом в предоставленной рабочей области. Не обязательно соответствовать имени присоединенного вычислительного ресурса. |
|
resource_id
Обязательно
|
Идентификатор ресурса 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
|
Имя группы ресурсов, в которой находится AKS. Default value: None
|
|
cluster_name
|
Имя кластера AKS. Default value: None
|
|
resource_id
|
Идентификатор ресурса Azure для присоединенного вычислительного ресурса. Default value: None
|
|
cluster_purpose
|
Целевое использование кластера. Это используется для подготовки компонентов Машинного обучения Azure для обеспечения требуемого уровня отказоустойчивости и качества обслуживания. Класс ClusterPurpose определяет возможные значения. Дополнительные сведения см. в разделе "Присоединение существующего кластера AKS". Default value: None
|
|
load_balancer_type
|
Тип кластера AKS. Допустимые значения: PublicIp и InternalLoadBalancer. Значением по умолчанию является PublicIp. Default value: None
|
|
load_balancer_subnet
|
Подсеть подсистемы балансировки нагрузки AKS. Его можно использовать только в том случае, если InternalLoadBalancer используется в качестве типа подсистемы балансировки нагрузки. Значение по умолчанию — aks-subnet. Default value: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Объект конфигурации, используемый при присоединении вычислительного объекта. |
delete
Удалите объект AksCompute из связанной рабочей области.
Если этот объект был создан с помощью Машинного обучения Azure, соответствующие облачные объекты также будут удалены. Если этот объект был создан внешне и подключен только к рабочей области, этот метод вызывает и ComputeTargetException ничего не изменится.
delete()
Исключения
| Тип | Описание |
|---|---|
deserialize
Преобразуйте объект JSON в объект AksCompute.
static deserialize(workspace, object_dict)
Параметры
| Имя | Описание |
|---|---|
|
workspace
Обязательно
|
Объект рабочей области, с которым связан объект AksCompute. |
|
object_dict
Обязательно
|
Объект JSON для преобразования в объект AksCompute. |
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Представление предоставленного объекта JSON в AksCompute. |
Исключения
| Тип | Описание |
|---|---|
Комментарии
Вызывает, 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
|
Количество агентов (виртуальных машин) для размещения контейнеров. Значение по умолчанию — 3. Default value: None
|
|
vm_size
|
Размер виртуальных машин агента. Полный список параметров можно найти здесь: https://aka.ms/azureml-aks-details По умолчанию используется Standard_D3_v2. Default value: None
|
|
ssl_cname
|
Значение CName, используемое при включении проверки SSL в кластере. Должен предоставить все три файла CName, cert и файл ключа, чтобы включить проверку SSL. Default value: None
|
|
ssl_cert_pem_file
|
Путь к файлу, содержащий сведения о сертификате для проверки SSL. Должен предоставить все три файла CName, cert и файл ключа, чтобы включить проверку SSL. Default value: None
|
|
ssl_key_pem_file
|
Путь к файлу, содержащий ключевые сведения для проверки SSL. Должен предоставить все три файла CName, cert и файл ключа, чтобы включить проверку SSL. Default value: None
|
|
location
|
Расположение для подготовки кластера. Если этот параметр не указан, по умолчанию используется расположение рабочей области. Доступные регионы для этого вычисления можно найти здесь:https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service Default value: None
|
|
vnet_resourcegroup_name
|
Имя группы ресурсов, в которой находится виртуальная сеть. Default value: None
|
|
vnet_name
|
Имя виртуальной сети. Default value: None
|
|
subnet_name
|
Имя подсети внутри виртуальной сети. Default value: None
|
|
service_cidr
|
Диапазон IP-адресов нотации CIDR, из которого следует назначать IP-адреса кластера служб. Default value: None
|
|
dns_service_ip
|
IP-адрес DNS-сервера контейнеров. Default value: None
|
|
docker_bridge_cidr
|
IP-адрес нотации CIDR для моста Docker. Default value: None
|
|
cluster_purpose
|
Целевое использование кластера. Это используется для подготовки компонентов Машинного обучения Azure для обеспечения требуемого уровня отказоустойчивости и качества обслуживания. Класс AksCompute.ClusterPurpose предоставляется для удобства указания доступных значений. Дополнительные сведения об этих значениях и их вариантах использования см. здесь: https://aka.ms/azureml-create-attach-aks Default value: None
|
|
load_balancer_type
|
Тип подсистемы балансировки нагрузки кластера AKS. Допустимые значения: PublicIp и InternalLoadBalancer. Значением по умолчанию является PublicIp. Default value: None
|
|
load_balancer_subnet
|
Подсеть подсистемы балансировки нагрузки кластера AKS. Его можно использовать только в том случае, если внутренняя подсистема балансировки нагрузки используется в качестве типа подсистемы балансировки нагрузки. Значение по умолчанию — aks-subnet. Default value: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Объект конфигурации, используемый при создании объекта Compute |
Исключения
| Тип | Описание |
|---|---|
refresh_state
Выполните обновление на месте свойств объекта.
Этот метод обновляет свойства на основе текущего состояния соответствующего облачного объекта. Это в основном используется для ручного опроса состояния вычислений.
refresh_state()
serialize
Преобразуйте этот объект AksCompute в сериализованный словарь json.
serialize()
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Представление JSON этого объекта AksCompute. |
update
Обновите объект AksCompute с помощью предоставленной конфигурации обновления.
update(update_configuration)
Параметры
| Имя | Описание |
|---|---|
|
update_configuration
Обязательно
|
Объект конфигурации обновления AKS. |
Исключения
| Тип | Описание |
|---|---|