Condividi tramite

ContainerImage Classe

  • Riferimento

Rappresenta un'immagine del contenitore, attualmente solo per le immagini Docker.

Questa classe è DEPRECATA. Utilizzare invece la classe Environment.

L'immagine contiene le dipendenze necessarie per eseguire il modello, tra cui:

  • Runtime

  • Definizioni di ambiente Python specificate in un file Conda

  • Possibilità di abilitare il supporto GPU

  • File Docker personalizzato per comandi di esecuzione specifici

Costruttore di immagine.

Questa classe è DEPRECATA. Utilizzare invece la classe Environment.

Il costruttore di immagine viene usato per recuperare una rappresentazione cloud di un oggetto Image associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Image recuperato.

Ereditarietà
Image
ContainerImage

Costruttore

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

Parametri

Nome Descrizione
workspace
Necessario
Workspace

Oggetto dell'area di lavoro contenente l'immagine da recuperare
name
str

Nome dell'immagine da recuperare. Restituisce la versione più recente, se esistente

Valore predefinito: None
id
str

ID specifico dell'immagine da recuperare. (ID è ":")

Valore predefinito: None
tags
list

Filtra i risultati dell'immagine in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

Valore predefinito: None
properties
list

Filtra i risultati dell'immagine in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

Valore predefinito: None
version
str

Quando vengono specificati sia la versione che il nome, restituirà la versione specifica dell'immagine.

Valore predefinito: None

Commenti

Un oggetto ContainerImage viene recuperato usando il costruttore della Image classe passando il nome o l'ID di un oggetto ContainerImage creato in precedenza. L'esempio di codice seguente mostra un recupero immagine da un'area di lavoro in base al nome e all'ID.


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

Per creare una nuova configurazione immagine da usare in una distribuzione, compilare un ContainerImageConfig oggetto come illustrato nell'esempio di codice seguente:


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

Metodi

image_configuration

Creare e restituire un ContainerImageConfig oggetto .

Questa funzione accetta parametri per definire il modo in cui il modello deve essere eseguito all'interno del servizio Web, nonché l'ambiente specifico e le dipendenze che deve essere in grado di eseguire.
run

Eseguire l'immagine in locale con i dati di input specificati.

È necessario che Docker sia installato e in esecuzione per funzionare. Questo metodo funzionerà solo sulla CPU, perché l'immagine abilitata per la GPU può essere eseguita solo nei servizi di Microsoft Azure.
serialize

Convertire questo oggetto ContainerImage in un dizionario serializzato JSON.

image_configuration

Creare e restituire un ContainerImageConfig oggetto .

Questa funzione accetta parametri per definire il modo in cui il modello deve essere eseguito all'interno del servizio Web, nonché l'ambiente specifico e le dipendenze che deve essere in grado di eseguire.

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)

Parametri

Nome Descrizione
execution_script
Necessario
str

Percorso del file Python locale che contiene il codice da eseguire per l'immagine. Deve includere sia funzioni init() che run(input_data) che definiscono i passaggi di esecuzione del modello per il servizio Web.
runtime
Necessario
str

Runtime da usare per l'immagine. I runtime supportati correnti sono "spark-py" e "python".
conda_file
str

Percorso del file .yml locale contenente una definizione di ambiente Conda da usare per l'immagine.

Valore predefinito: None
docker_file
str

Percorso del file locale contenente passaggi Docker aggiuntivi da eseguire durante la configurazione dell'immagine.

Valore predefinito: None
schema_file
str

Percorso del file locale contenente uno schema del servizio Web da usare quando viene distribuita l'immagine. Usato per la generazione di specifiche Swagger per una distribuzione del modello.

Valore predefinito: None
dependencies
list[str]

Elenco di percorsi per file/cartelle aggiuntivi che l'immagine deve eseguire.

Valore predefinito: None
enable_gpu
bool

Indica se abilitare o meno il supporto GPU nell'immagine. L'immagine GPU deve essere usata nei servizi di Microsoft Azure, ad esempio Istanze di Azure Container, calcolo di Azure Machine Learning, Macchine virtuali di Azure e servizio Azure Kubernetes. Il valore predefinito è False

Valore predefinito: None
tags
dict[str, str]

Dizionario dei tag chiave-valore per assegnare questa immagine.

Valore predefinito: None
properties
dict[str, str]

Dizionario delle proprietà chiave-valore per assegnare questa immagine. Queste proprietà non possono essere modificate dopo la distribuzione, ma è possibile aggiungere nuove coppie chiave-valore.

Valore predefinito: None
description
str

Descrizione di testo da assegnare a questa immagine.

Valore predefinito: None
base_image
str

Immagine personalizzata da usare come immagine di base. Se non viene specificata alcuna immagine di base, l'immagine di base verrà usata in base al parametro di runtime specificato.

Valore predefinito: None
base_image_registry
ContainerRegistry

Registro immagini che contiene l'immagine di base.

Valore predefinito: None
cuda_version
str

Versione di CUDA da installare per le immagini che necessitano del supporto GPU. L'immagine GPU deve essere usata nei servizi di Microsoft Azure, ad esempio Istanze di Azure Container, calcolo di Azure Machine Learning, Macchine virtuali di Azure e servizio Azure Kubernetes. Le versioni supportate sono 9.0, 9.1 e 10.0. Se 'enable_gpu' è impostato, il valore predefinito è '9.1'.

Valore predefinito: None

Restituisce

Tipo Descrizione
ContainerImageConfig

Oggetto di configurazione da usare durante la creazione dell'immagine.

Eccezioni

Tipo Descrizione
WebserviceException

run

Eseguire l'immagine in locale con i dati di input specificati.

È necessario che Docker sia installato e in esecuzione per funzionare. Questo metodo funzionerà solo sulla CPU, perché l'immagine abilitata per la GPU può essere eseguita solo nei servizi di Microsoft Azure.

run(input_data)

Parametri

Nome Descrizione
input_data
Necessario
<xref:varies>

Dati di input da passare all'immagine durante l'esecuzione

Restituisce

Tipo Descrizione
<xref:varies>

Risultati dell'esecuzione dell'immagine.

Eccezioni

Tipo Descrizione
WebserviceException

serialize

Convertire questo oggetto ContainerImage in un dizionario serializzato JSON.

serialize()

Restituisce

Tipo Descrizione
dict

Rappresentazione JSON di questo oggetto ContainerImage.

Eccezioni

Tipo Descrizione
WebserviceException