Dela via

ContainerImage Klass

  • Referens

Representerar en containeravbildning, för närvarande endast för Docker-avbildningar.

Den här klassen är INAKTUELL. Environment Använd klassen i stället.

Avbildningen innehåller de beroenden som krävs för att köra modellen, inklusive:

  • Körningen

  • Python-miljödefinitioner som anges i en Conda-fil

  • Möjlighet att aktivera GPU-stöd

  • Anpassad Docker-fil för specifika körningskommandon

Bildkonstruktor.

Den här klassen är INAKTUELL. Environment Använd klassen i stället.

Bildkonstruktorn används för att hämta en molnrepresentation av ett bildobjekt som är associerat med den angivna arbetsytan. Returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade bildobjektet.

Arv
Image
ContainerImage

Konstruktor

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

Parametrar

Name Description
workspace
Obligatorisk
Workspace

Arbetsyteobjektet som innehåller avbildningen som ska hämtas
name
str

Namnet på avbildningen som ska hämtas. Returnerar den senaste versionen om den finns

Standardvärde: None
id
str

Det specifika ID för avbildningen som ska hämtas. (ID är ":")

Standardvärde: None
tags
list

Filtrerar bildresultat baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". T.ex. ['key', ['key2', 'key2 value']]

Standardvärde: None
properties
list

Filtrerar bildresultat baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". T.ex. ['key', ['key2', 'key2 value']]

Standardvärde: None
version
str

När både version och namn har angetts returneras den specifika versionen av avbildningen.

Standardvärde: None

Kommentarer

En ContainerImage hämtas med hjälp Image av klasskonstruktorn genom att skicka namnet eller ID:t för en tidigare skapad ContainerImage. I följande kodexempel visas en bildhämtning från en arbetsyta med både namn och ID.


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

Skapa ett ContainerImageConfig objekt som visas i följande kodexempel för att skapa en ny avbildningskonfiguration som ska användas i en distribution:


   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"
                                                    )

Metoder

image_configuration

Skapa och returnera ett ContainerImageConfig objekt.

Den här funktionen accepterar parametrar för att definiera hur din modell ska köras inom webbtjänsten, samt den specifika miljö och de beroenden som den behöver för att kunna köras.
run

Kör avbildningen lokalt med angivna indata.

Docker måste vara installerat och körs för att fungera. Den här metoden fungerar bara på CPU eftersom den GPU-aktiverade avbildningen bara kan köras på Microsoft Azure Services.
serialize

Konvertera det här ContainerImage-objektet till en JSON-serialiserad ordlista.

image_configuration

Skapa och returnera ett ContainerImageConfig objekt.

Den här funktionen accepterar parametrar för att definiera hur din modell ska köras inom webbtjänsten, samt den specifika miljö och de beroenden som den behöver för att kunna köras.

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)

Parametrar

Name Description
execution_script
Obligatorisk
str

Sökväg till en lokal Python-fil som innehåller koden som ska köras för avbildningen. Måste innehålla funktioner för både init() och run(input_data) som definierar modellkörningsstegen för webbtjänsten.
runtime
Obligatorisk
str

Körningen som ska användas för avbildningen. Aktuella körningar som stöds är "spark-py" och "python".
conda_file
str

Sökväg till lokal .yml fil som innehåller en Conda-miljödefinition som ska användas för avbildningen.

Standardvärde: None
docker_file
str

Sökväg till lokal fil som innehåller ytterligare Docker-steg som ska köras när avbildningen konfigureras.

Standardvärde: None
schema_file
str

Sökväg till en lokal fil som innehåller ett webbtjänstschema som ska användas när avbildningen distribueras. Används för att generera Swagger-specifikationer för en modelldistribution.

Standardvärde: None
dependencies
list[str]

Lista över sökvägar till ytterligare filer/mappar som avbildningen behöver köra.

Standardvärde: None
enable_gpu
bool

Om du vill aktivera GPU-stöd i avbildningen eller inte. GPU-avbildningen måste användas på Microsoft Azure-tjänster som Azure Container Instances, Azure Mašinsko učenje Compute, Azure Virtual Machines och Azure Kubernetes Service. Standardvärdet är False

Standardvärde: None
tags
dict[str, str]

Ordlista med nyckelvärdestaggar som ska ge den här bilden.

Standardvärde: None
properties
dict[str, str]

Ordlista med nyckelvärdesegenskaper för att ge den här bilden. Dessa egenskaper kan inte ändras efter distributionen, men nya nyckelvärdepar kan läggas till.

Standardvärde: None
description
str

En textbeskrivning som ska ge den här bilden.

Standardvärde: None
base_image
str

En anpassad avbildning som ska användas som basavbildning. Om ingen basavbildning anges används basavbildningen baserat på den angivna körningsparametern.

Standardvärde: None
base_image_registry
ContainerRegistry

Avbildningsregister som innehåller basavbildningen.

Standardvärde: None
cuda_version
str

Version av CUDA som ska installeras för avbildningar som behöver GPU-stöd. GPU-avbildningen måste användas på Microsoft Azure-tjänster som Azure Container Instances, Azure Mašinsko učenje Compute, Azure Virtual Machines och Azure Kubernetes Service. Versioner som stöds är 9.0, 9.1 och 10.0. Om "enable_gpu" har angetts är standardinställningen "9.1".

Standardvärde: None

Returer

Typ Description
ContainerImageConfig

Ett konfigurationsobjekt som ska användas när avbildningen skapas.

Undantag

Typ Description
WebserviceException

run

Kör avbildningen lokalt med angivna indata.

Docker måste vara installerat och körs för att fungera. Den här metoden fungerar bara på CPU eftersom den GPU-aktiverade avbildningen bara kan köras på Microsoft Azure Services.

run(input_data)

Parametrar

Name Description
input_data
Obligatorisk
<xref:varies>

Indata som ska skickas till avbildningen vid körning

Returer

Typ Description
<xref:varies>

Resultatet av att köra avbildningen.

Undantag

Typ Description
WebserviceException

serialize

Konvertera det här ContainerImage-objektet till en JSON-serialiserad ordlista.

serialize()

Returer

Typ Description
dict

JSON-representationen av denna ContainerImage.

Undantag

Typ Description
WebserviceException