Delen via

ContainerImage Klas

  • Referentie

Vertegenwoordigt een containerinstallatiekopieën, momenteel alleen voor Docker-installatiekopieën.

Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse.

De installatiekopieën bevatten de afhankelijkheden die nodig zijn om het model uit te voeren, waaronder:

  • De runtime

  • Python-omgevingsdefinities die zijn opgegeven in een Conda-bestand

  • Mogelijkheid om GPU-ondersteuning in te schakelen

  • Aangepast Docker-bestand voor specifieke uitvoeringsopdrachten

Installatiekopieënconstructor.

Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse.

Image constructor wordt gebruikt om een cloudweergave op te halen van een afbeeldingsobject dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde afbeeldingsobject.

Overname
Image
ContainerImage

Constructor

ContainerImage(workspace, name=None, id=None, tags=None, properties=None, version=None)

Parameters

Name Description
workspace
Vereist
Workspace

Het werkruimteobject met de afbeelding die moet worden opgehaald
name
str

De naam van de afbeelding die moet worden opgehaald. Retourneert de nieuwste versie, als deze bestaat

Default value: None
id
str

De specifieke id van de afbeelding die moet worden opgehaald. (Id is ":")

Default value: None
tags
list

Filtert de afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

Default value: None
properties
list

Filtert de afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

Default value: None
version
str

Wanneer versie en naam beide zijn opgegeven, retourneert de specifieke versie van de installatiekopieën.

Default value: None

Opmerkingen

Een ContainerImage wordt opgehaald met behulp van de Image klasseconstructor door de naam of id van een eerder gemaakte ContainerImage door te geven. In het volgende codevoorbeeld ziet u het ophalen van een installatiekopie uit een werkruimte op zowel de naam als de id.


   container_image_from_name = Image(workspace, name="image-name")
   container_image_from_id = Image(workspace, id="image-id")

Als u een nieuwe installatiekopieënconfiguratie wilt maken voor gebruik in een implementatie, bouwt u een ContainerImageConfig -object zoals wordt weergegeven in het volgende codevoorbeeld:


   from azureml.core.image import ContainerImage

   image_config = ContainerImage.image_configuration(execution_script="score.py",
                                                    runtime="python",
                                                    conda_file="myenv.yml",
                                                    description="image for model",
                                                    cuda_version="9.0"
                                                    )

Methoden

image_configuration

Een object maken en retourneren ContainerImageConfig .

Deze functie accepteert parameters om te definiëren hoe uw model moet worden uitgevoerd binnen de webservice, evenals de specifieke omgeving en afhankelijkheden die het moet kunnen uitvoeren.
run

Voer de installatiekopieën lokaal uit met de opgegeven invoergegevens.

Docker moet zijn geïnstalleerd en actief zijn om te kunnen werken. Deze methode werkt alleen op CPU, omdat de gpu-installatiekopieën alleen kunnen worden uitgevoerd op Microsoft Azure-services.
serialize

Converteer dit ContainerImage-object naar een geserialiseerde JSON-woordenlijst.

image_configuration

Een object maken en retourneren ContainerImageConfig .

Deze functie accepteert parameters om te definiëren hoe uw model moet worden uitgevoerd binnen de webservice, evenals de specifieke omgeving en afhankelijkheden die het moet kunnen uitvoeren.

static image_configuration(execution_script, runtime, conda_file=None, docker_file=None, schema_file=None, dependencies=None, enable_gpu=None, tags=None, properties=None, description=None, base_image=None, base_image_registry=None, cuda_version=None)

Parameters

Name Description
execution_script
Vereist
str

Pad naar het lokale Python-bestand dat de code bevat die moet worden uitgevoerd voor de installatiekopieën. Moet zowel de functies init() als run(input_data) bevatten waarmee de modeluitvoeringsstappen voor de webservice worden gedefinieerd.
runtime
Vereist
str

De runtime die moet worden gebruikt voor de installatiekopieën. Huidige ondersteunde runtimes zijn 'spark-py' en 'python'.
conda_file
str

Pad naar het lokale .yml-bestand met een Conda-omgevingsdefinitie die moet worden gebruikt voor de installatiekopie.

Default value: None
docker_file
str

Pad naar lokaal bestand met extra Docker-stappen die moeten worden uitgevoerd bij het instellen van de installatiekopie.

Default value: None
schema_file
str

Pad naar lokaal bestand met een webserviceschema dat moet worden gebruikt wanneer de installatiekopie wordt geïmplementeerd. Wordt gebruikt voor het genereren van Swagger-specificaties voor een modelimplementatie.

Default value: None
dependencies
list[str]

Lijst met paden naar aanvullende bestanden/mappen die de installatiekopieën moeten uitvoeren.

Default value: None
enable_gpu
bool

Hiermee wordt aangegeven of GPU-ondersteuning in de installatiekopieën moet worden ingeschakeld. De GPU-installatiekopieën moeten worden gebruikt voor Microsoft Azure-services, zoals Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines en Azure Kubernetes Service. Standaard ingesteld op False.

Default value: None
tags
dict[str, str]

Woordenlijst met sleutelwaardetags om deze afbeelding te geven.

Default value: None
properties
dict[str, str]

Woordenlijst met sleutelwaarde-eigenschappen om deze afbeelding te geven. Deze eigenschappen kunnen niet worden gewijzigd na de implementatie, maar er kunnen wel nieuwe sleutelwaardeparen worden toegevoegd.

Default value: None
description
str

Een tekstbeschrijving om deze afbeelding te geven.

Default value: None
base_image
str

Een aangepaste installatiekopieën die als basisinstallatiekopieën moeten worden gebruikt. Als er geen basisinstallatiekopieën worden opgegeven, wordt de basisinstallatiekopieën gebruikt op basis van de opgegeven runtimeparameter.

Default value: None
base_image_registry
ContainerRegistry

Installatiekopieënregister dat de basisinstallatiekopieën bevat.

Default value: None
cuda_version
str

Versie van CUDA die moet worden geïnstalleerd voor installatiekopieën waarvoor GPU-ondersteuning nodig is. De GPU-installatiekopieën moeten worden gebruikt voor Microsoft Azure-services, zoals Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines en Azure Kubernetes Service. Ondersteunde versies zijn 9.0, 9.1 en 10.0. Als 'enable_gpu' is ingesteld, wordt dit standaard ingesteld op '9.1'.

Default value: None

Retouren

Type Description
ContainerImageConfig

Een configuratieobject dat moet worden gebruikt bij het maken van de installatiekopieën.

Uitzonderingen

Type Description
WebserviceException

run

Voer de installatiekopieën lokaal uit met de opgegeven invoergegevens.

Docker moet zijn geïnstalleerd en actief zijn om te kunnen werken. Deze methode werkt alleen op CPU, omdat de gpu-installatiekopieën alleen kunnen worden uitgevoerd op Microsoft Azure-services.

run(input_data)

Parameters

Name Description
input_data
Vereist
<xref:varies>

De invoergegevens die moeten worden doorgegeven aan de installatiekopieën wanneer deze worden uitgevoerd

Retouren

Type Description
<xref:varies>

De resultaten van het uitvoeren van de installatiekopieën.

Uitzonderingen

Type Description
WebserviceException

serialize

Converteer dit ContainerImage-object naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type Description
dict

De JSON-weergave van deze ContainerImage.

Uitzonderingen

Type Description
WebserviceException