AksCompute Clase
Administra un destino de proceso de Azure Kubernetes Service en Azure Machine Learning.
Los destinos de Azure Kubernetes Service (AKSCompute) se usan normalmente para implementaciones de producción a gran escala, ya que proporcionan un tiempo de respuesta rápido y escalado automático del servicio implementado. Para más información, consulte ¿Qué son los destinos de proceso en Azure Machine Learning?
Constructor ComputeTarget de clase.
Recupere una representación en la nube de un objeto Compute asociado al área de trabajo proporcionada. Devuelve una instancia de una clase secundaria correspondiente al tipo específico del objeto Compute recuperado.
- Herencia
-
AksCompute
Constructor
AksCompute(workspace, name)
Parámetros
Nombre | Description |
---|---|
workspace
Requerido
|
Objeto de área de trabajo que contiene el objeto AksCompute que se recuperará. |
name
Requerido
|
Nombre del objeto AksCompute que se recuperará. |
workspace
Requerido
|
Objeto de área de trabajo que contiene el objeto Compute que se recuperará. |
name
Requerido
|
Nombre del objeto Compute que se va a recuperar. |
Comentarios
En el ejemplo siguiente se muestra cómo crear un clúster de AKS con máquinas habilitadas para 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)
Métodos
attach |
EN DESUSO. Use el método Asocia un recurso de proceso de AKS existente al área de trabajo proporcionada. |
attach_configuration |
Crea un objeto de configuración para asociar un destino de proceso de AKS. |
delete |
Quita el objeto AksCompute de su área de trabajo asociada. Si este objeto se creó mediante Azure Machine Learning, también se eliminarán los objetos basados en la nube correspondientes. Si este objeto se creó externamente y solo está asociado al área de trabajo, se genera una excepción ComputeTargetException y no cambia nada. |
deserialize |
Convierte un objeto JSON en un objeto AksCompute. |
detach |
Desasocia el objeto AksCompute de su área de trabajo asociada. Los objetos de nube subyacentes no se eliminan, solo se quita la asociación. |
get_credentials |
Recupera las credenciales del destino de AKS. |
provisioning_configuration |
Crea un objeto de configuración para aprovisionar un destino de proceso de AKS. |
refresh_state |
Realiza una actualización local de las propiedades del objeto. Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Se usa principalmente para el sondeo manual del estado de proceso. |
serialize |
Convierte este objeto AksCompute en un diccionario serializado JSON. |
update |
Actualice el objeto AksCompute mediante la configuración de actualización proporcionada. |
attach
EN DESUSO. Use el método attach_configuration
en su lugar.
Asocia un recurso de proceso de AKS existente al área de trabajo proporcionada.
static attach(workspace, name, resource_id)
Parámetros
Nombre | Description |
---|---|
workspace
Requerido
|
Objeto de área de trabajo con el que se asociará el recurso de proceso. |
name
Requerido
|
Nombre que se asociará al recurso de proceso dentro del área de trabajo proporcionada. No tiene que coincidir con el nombre del recurso de proceso que se va a asociar. |
resource_id
Requerido
|
Id. de recurso de Azure para el recurso de proceso que se asocia. |
Devoluciones
Tipo | Description |
---|---|
Representación del objeto AksCompute del objeto de proceso. |
Excepciones
Tipo | Description |
---|---|
attach_configuration
Crea un objeto de configuración para asociar un destino de proceso de AKS.
static attach_configuration(resource_group=None, cluster_name=None, resource_id=None, cluster_purpose=None, load_balancer_type=None, load_balancer_subnet=None)
Parámetros
Nombre | Description |
---|---|
resource_group
|
Nombre del grupo de recursos en el que se encuentra AKS. Valor predeterminado: None
|
cluster_name
|
Nombre del clúster de AKS. Valor predeterminado: None
|
resource_id
|
Id. de recurso de Azure para el recurso de proceso que se asocia. Valor predeterminado: None
|
cluster_purpose
|
Uso de destino del clúster. Se usa para aprovisionar componentes de Azure Machine Learning para garantizar el nivel deseado de tolerancia a errores y QoS. La clase ClusterPurpose define los valores posibles. Para más información, consulte Asociación de un clúster de AKS existente. Valor predeterminado: None
|
load_balancer_type
|
Tipo del clúster de AKS. Los valores válidos son PublicIp e InternalLoadBalancer. El valor predeterminado es PublicIp. Valor predeterminado: None
|
load_balancer_subnet
|
Subred del equilibrador de carga de AKS. Solo se puede usar cuando se usa InternalLoadBalancer como tipo de equilibrador de carga. El valor predeterminado es aks-subnet. Valor predeterminado: None
|
Devoluciones
Tipo | Description |
---|---|
Objeto de configuración que se usará al asociar un objeto Compute. |
Excepciones
Tipo | Description |
---|---|
delete
Quita el objeto AksCompute de su área de trabajo asociada.
Si este objeto se creó mediante Azure Machine Learning, también se eliminarán los objetos basados en la nube correspondientes. Si este objeto se creó externamente y solo está asociado al área de trabajo, se genera una excepción ComputeTargetException y no cambia nada.
delete()
Excepciones
Tipo | Description |
---|---|
deserialize
Convierte un objeto JSON en un objeto AksCompute.
static deserialize(workspace, object_dict)
Parámetros
Nombre | Description |
---|---|
workspace
Requerido
|
Objeto de área de trabajo al que está asociado el objeto AksCompute. |
object_dict
Requerido
|
Objeto JSON para convertir en un objeto AksCompute. |
Devoluciones
Tipo | Description |
---|---|
Representación de AksCompute del objeto JSON proporcionado. |
Excepciones
Tipo | Description |
---|---|
Comentarios
Genera una excepción ComputeTargetException si el área de trabajo proporcionada no es el área de trabajo a la que está asociado el proceso.
detach
Desasocia el objeto AksCompute de su área de trabajo asociada.
Los objetos de nube subyacentes no se eliminan, solo se quita la asociación.
detach()
Excepciones
Tipo | Description |
---|---|
get_credentials
Recupera las credenciales del destino de AKS.
get_credentials()
Devoluciones
Tipo | Description |
---|---|
Credenciales del destino de AKS. |
Excepciones
Tipo | Description |
---|---|
provisioning_configuration
Crea un objeto de configuración para aprovisionar un destino de proceso de 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)
Parámetros
Nombre | Description |
---|---|
agent_count
|
Número de agentes (máquinas virtuales) que van a hospedar contenedores. El valor predeterminado es 3. Valor predeterminado: None
|
vm_size
|
Tamaño de las máquinas virtuales de agente. Aquí encontrará una lista completa de opciones: https://aka.ms/azureml-aks-details. Adopta como valor predeterminado Standard_D3_v2. Valor predeterminado: None
|
ssl_cname
|
CName que se usará si se habilita la validación SSL en el clúster. Debe proporcionar el CName, el archivo de certificado y el archivo de clave para habilitar la validación SSL. Valor predeterminado: None
|
ssl_cert_pem_file
|
Ruta de acceso de archivo a un archivo que contiene información de certificado para la validación SSL. Debe proporcionar el CName, el archivo de certificado y el archivo de clave para habilitar la validación SSL. Valor predeterminado: None
|
ssl_key_pem_file
|
Ruta de acceso de archivo a un archivo que contiene información de clave para la validación SSL. Debe proporcionar el CName, el archivo de certificado y el archivo de clave para habilitar la validación SSL. Valor predeterminado: None
|
location
|
Ubicación en la que se debe aprovisionar el clúster. Si no se especifica, el valor predeterminado será la ubicación del área de trabajo. Las regiones disponibles para este proceso se pueden encontrar aquí: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service Valor predeterminado: None
|
vnet_resourcegroup_name
|
Nombre del grupo de recursos donde se encuentra la red virtual. Valor predeterminado: None
|
vnet_name
|
El nombre de la red virtual. Valor predeterminado: None
|
subnet_name
|
Nombre de la subred dentro de la red virtual. Valor predeterminado: None
|
service_cidr
|
Intervalo IP en notación CIDR desde el que se van a asignar las direcciones IP del clúster de servicio. Valor predeterminado: None
|
dns_service_ip
|
Dirección IP del servidor DNS de los contenedores. Valor predeterminado: None
|
docker_bridge_cidr
|
IP de notación CIDR para el puente de Docker. Valor predeterminado: None
|
cluster_purpose
|
Uso de destino del clúster. Se usa para aprovisionar componentes de Azure Machine Learning para garantizar el nivel deseado de tolerancia a errores y QoS. La clase AksCompute.ClusterPurpose se proporciona para mayor comodidad a la hora de especificar los valores disponibles. Puede encontrar información más detallada de estos valores y sus casos de uso aquí: https://aka.ms/azureml-create-attach-aks Valor predeterminado: None
|
load_balancer_type
|
Tipo de equilibrador de carga del clúster de AKS. Los valores válidos son PublicIp e InternalLoadBalancer. El valor predeterminado es PublicIp. Valor predeterminado: None
|
load_balancer_subnet
|
Subred del equilibrador de carga del clúster de AKS. Solo se puede usar cuando la instancia de Load Balancer interno se usa como tipo de equilibrador de carga. El valor predeterminado es aks-subnet. Valor predeterminado: None
|
Devoluciones
Tipo | Description |
---|---|
Objeto de configuración que se va a usar al crear un objeto Compute. |
Excepciones
Tipo | Description |
---|---|
refresh_state
Realiza una actualización local de las propiedades del objeto.
Este método actualiza las propiedades en función del estado actual del objeto de nube correspondiente. Se usa principalmente para el sondeo manual del estado de proceso.
refresh_state()
Excepciones
Tipo | Description |
---|---|
serialize
Convierte este objeto AksCompute en un diccionario serializado JSON.
serialize()
Devoluciones
Tipo | Description |
---|---|
La representación JSON de este objeto AksCompute. |
Excepciones
Tipo | Description |
---|---|
update
Actualice el objeto AksCompute mediante la configuración de actualización proporcionada.
update(update_configuration)
Parámetros
Nombre | Description |
---|---|
update_configuration
Requerido
|
Objeto de configuración de actualización de AKS. |
Excepciones
Tipo | Description |
---|---|