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

Afbeeldingsconstructor.

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

Afbeeldingsconstructor 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 afbeeldingsresultaten op basis van de opgegeven lijst, op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']]

Default value: None
properties
list

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

Default value: None
version
str

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

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 een afbeelding ophalen uit een werkruimte op naam en 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, maakt 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 in de webservice, evenals de specifieke omgeving en afhankelijkheden die moeten worden uitgevoerd.
run

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

Docker moet zijn geïnstalleerd en worden uitgevoerd om te kunnen werken. Deze methode werkt alleen op CPU, omdat de installatiekopieën met GPU alleen kunnen worden uitgevoerd in 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 in de webservice, evenals de specifieke omgeving en afhankelijkheden die moeten worden uitgevoerd.

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 init() als run(input_data) functies bevatten waarmee de modeluitvoeringsstappen voor de webservice worden gedefinieerd.
runtime
Vereist
str

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

Pad naar lokaal .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 door de installatiekopieën moeten worden uitgevoerd.

Default value: None
enable_gpu
bool

Of gpu-ondersteuning in de installatiekopieën al dan niet moet worden ingeschakeld. De GPU-installatiekopieën moeten worden gebruikt in 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 nieuwe sleutelwaardeparen kunnen 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 moeten worden gebruikt als basisinstallatiekopieën. Als er geen basisinstallatiekopieën worden gegeven, 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 is vereist. De GPU-installatiekopieën moeten worden gebruikt in 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 deze 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 worden uitgevoerd om te kunnen werken. Deze methode werkt alleen op CPU, omdat de installatiekopieën met GPU alleen kunnen worden uitgevoerd in Microsoft Azure Services.

run(input_data)

Parameters

Name Description
input_data
Vereist
<xref:varies>

De invoergegevens die moeten worden doorgegeven aan de afbeelding wanneer deze worden uitgevoerd

Retouren

Type Description
<xref:varies>

De resultaten van het uitvoeren van de afbeelding.

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