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
- workspace
- Workspace
Objeto de área de trabajo que contiene el objeto AksCompute que se recuperará.
- workspace
- Workspace
Objeto de área de trabajo que contiene el objeto Compute que se 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
- workspace
- Workspace
Objeto de área de trabajo con el que se asociará el recurso de proceso.
- name
- str
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.
Devoluciones
Representación del objeto AksCompute del objeto de proceso.
Tipo de valor devuelto
Excepciones
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
- resource_group
- str
Nombre del grupo de recursos en el que se encuentra AKS.
- resource_id
- str
Id. de recurso de Azure para el recurso de proceso que se asocia.
- cluster_purpose
- str
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.
- load_balancer_type
- str
Tipo del clúster de AKS. Los valores válidos son PublicIp e InternalLoadBalancer. El valor predeterminado es PublicIp.
- load_balancer_subnet
- str
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.
Devoluciones
Objeto de configuración que se usará al asociar un objeto Compute.
Tipo de valor devuelto
Excepciones
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
deserialize
Convierte un objeto JSON en un objeto AksCompute.
static deserialize(workspace, object_dict)
Parámetros
Devoluciones
Representación de AksCompute del objeto JSON proporcionado.
Tipo de valor devuelto
Excepciones
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
get_credentials
Recupera las credenciales del destino de AKS.
get_credentials()
Devoluciones
Credenciales del destino de AKS.
Tipo de valor devuelto
Excepciones
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
- agent_count
- int
Número de agentes (máquinas virtuales) que van a hospedar contenedores. El valor predeterminado es 3.
- vm_size
- str
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.
- ssl_cname
- str
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.
- ssl_cert_pem_file
- str
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.
- ssl_key_pem_file
- str
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.
- location
- str
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
- vnet_resourcegroup_name
- str
Nombre del grupo de recursos donde se encuentra la red virtual.
- service_cidr
- str
Intervalo IP en notación CIDR desde el que se van a asignar las direcciones IP del clúster de servicio.
- cluster_purpose
- str
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
- load_balancer_type
- str
Tipo de equilibrador de carga del clúster de AKS. Los valores válidos son PublicIp e InternalLoadBalancer. El valor predeterminado es PublicIp.
- load_balancer_subnet
- str
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.
Devoluciones
Objeto de configuración que se va a usar al crear un objeto Compute.
Tipo de valor devuelto
Excepciones
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
serialize
Convierte este objeto AksCompute en un diccionario serializado JSON.
serialize()
Devoluciones
La representación JSON de este objeto AksCompute.
Tipo de valor devuelto
Excepciones
update
Actualice el objeto AksCompute mediante la configuración de actualización proporcionada.
update(update_configuration)
Parámetros
- update_configuration
- AksUpdateConfiguration
Objeto de configuración de actualización de AKS.
Excepciones
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de