ContainerImage Classe
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 immagini.
Questa classe è DEPRECATA. Utilizzare invece la classe Environment.
Il costruttore di immagini viene usato per recuperare una rappresentazione cloud di un oggetto Image associato all'area di lavoro specificata. Restituirà un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Image recuperato.
- Ereditarietà
-
ContainerImage
Costruttore
ContainerImage(workspace, name=None, id=None, tags=None, properties=None, version=None)Parametri
- name
- str
Nome dell'immagine da recuperare. Restituirà la versione più recente, se esistente
- tags
- list
Filtra i risultati dell'immagine in base all'elenco fornito, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]
- properties
- list
Filtra i risultati dell'immagine in base all'elenco fornito, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]
- version
- str
Quando la versione e il nome sono entrambi specificati, restituirà la versione specifica dell'immagine.
Commenti
Un oggetto ContainerImage viene recuperato usando il costruttore della classe passando il nome o l'ID Image di un ContenitoreImage creato in precedenza. Nell'esempio di codice seguente viene illustrato un recupero di immagini 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 e le dipendenze specifiche che deve essere in grado di eseguire. |
| run |
Eseguire l'immagine in locale con i dati di input specificati. Deve essere installato e in esecuzione Docker per il funzionamento. 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 e le dipendenze specifiche 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
- execution_script
- str
Percorso del file Python locale contenente 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
- str
Runtime da usare per l'immagine. I runtime supportati correnti sono "spark-py" e "python".
- conda_file
- str
Percorso del file con estensione yml locale contenente una definizione di ambiente Conda da usare per l'immagine.
- docker_file
- str
Percorso del file locale contenente passaggi Docker aggiuntivi da eseguire durante la configurazione dell'immagine.
- 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.
Elenco dei percorsi di file/cartelle aggiuntivi che l'immagine deve eseguire.
- enable_gpu
- bool
Indica se abilitare il supporto della GPU nell'immagine. L'immagine GPU deve essere usata in 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
Dizionario dei tag chiave valore per assegnare questa immagine.
Dizionario delle proprietà del valore chiave per assegnare questa immagine. Queste proprietà non possono essere modificate dopo la distribuzione, ma è possibile aggiungere nuove coppie di valori chiave.
- 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.
- base_image_registry
- ContainerRegistry
Registro immagini contenente l'immagine di base.
- cuda_version
- str
Versione di CUDA da installare per le immagini che richiedono supporto GPU. L'immagine GPU deve essere usata in 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, questa impostazione predefinita viene impostata su '9.1'.
Restituisce
Oggetto di configurazione da usare durante la creazione dell'immagine.
Tipo restituito
Eccezioni
run
Eseguire l'immagine in locale con i dati di input specificati.
Deve essere installato e in esecuzione Docker per il funzionamento. 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
- input_data
- <xref:varies>
Dati di input da passare all'immagine durante l'esecuzione
Restituisce
Risultati dell'esecuzione dell'immagine.
Tipo restituito
Eccezioni
serialize
Convertire questo oggetto ContainerImage in un dizionario serializzato JSON.
serialize()Restituisce
Rappresentazione JSON di questo contenitoreImage.
Tipo restituito
Eccezioni
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per