ContainerImage Osztály
Tárolórendszerképet jelöl, jelenleg csak Docker-rendszerképekhez.
Ez az osztály ELAVULT. Használja inkább az Environment osztályt.
A rendszerkép a modell futtatásához szükséges függőségeket tartalmazza, többek között a következőket:
A futtatókörnyezet
Conda-fájlban megadott Python-környezetdefiníciók
GPU-támogatás engedélyezése
Egyéni Docker-fájl adott futtatási parancsokhoz
Képkonstruktor.
Ez az osztály ELAVULT. Használja inkább az Environment osztályt.
A rendszerkép-konstruktor a megadott munkaterülethez társított képobjektum felhőbeli ábrázolásának lekérésére szolgál. Egy gyermekosztály egy példányát adja vissza, amely megfelel a lekért képobjektum adott típusának.
- Öröklődés
-
ContainerImage
Konstruktor
ContainerImage(workspace, name=None, id=None, tags=None, properties=None, version=None)
Paraméterek
Name | Description |
---|---|
workspace
Kötelező
|
A lekérendő képet tartalmazó munkaterület-objektum |
name
|
A lekérni kívánt kép neve. A legújabb verziót adja vissza, ha létezik Alapértelmezett érték: None
|
id
|
A lekérni kívánt kép konkrét azonosítója. (Az azonosító :") Alapértelmezett érték: None
|
tags
|
A rendszerképek eredményeit a megadott lista alapján szűri a "key" vagy a "[key, value]" alapján. Pl. "key", "key2", "key2 value"] Alapértelmezett érték: None
|
properties
|
A rendszerképek eredményeit a megadott lista alapján szűri a "key" vagy a "[key, value]" alapján. Pl. "key", "key2", "key2 value"] Alapértelmezett érték: None
|
version
|
Ha a verzió és a név is meg van adva, a rendszerkép adott verzióját adja vissza. Alapértelmezett érték: None
|
Megjegyzések
A ContainerImage lekérése az Image osztálykonstruktor használatával történik egy korábban létrehozott ContainerImage nevének vagy azonosítójának átadásával. Az alábbi példakód egy munkaterületről származó kép lekérését mutatja be név és azonosító alapján.
container_image_from_name = Image(workspace, name="image-name")
container_image_from_id = Image(workspace, id="image-id")
Ha új rendszerkép-konfigurációt szeretne létrehozni egy üzembe helyezéshez, hozzon létre egy ContainerImageConfig objektumot az alábbi kód példában látható módon:
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"
)
Metódusok
image_configuration |
Objektum létrehozása és visszaadása ContainerImageConfig . Ez a függvény paramétereket fogad el annak meghatározásához, hogy a modell hogyan fusson a webszolgáltatáson belül, valamint azokat a környezeteket és függőségeket, amelyeket futtatnia kell. |
run |
Futtassa a képet helyileg a megadott bemeneti adatokkal. A Dockernek telepítve kell lennie, és működnie kell. Ez a módszer csak processzoron működik, mivel a GPU-kompatibilis rendszerkép csak a Microsoft Azure Servicesen futtatható. |
serialize |
Konvertálja ezt a ContainerImage objektumot JSON szerializált szótárlá. |
image_configuration
Objektum létrehozása és visszaadása ContainerImageConfig .
Ez a függvény paramétereket fogad el annak meghatározásához, hogy a modell hogyan fusson a webszolgáltatáson belül, valamint azokat a környezeteket és függőségeket, amelyeket futtatnia kell.
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)
Paraméterek
Name | Description |
---|---|
execution_script
Kötelező
|
A lemezképhez futtatandó kódot tartalmazó helyi Python-fájl elérési útja. Tartalmaznia kell az init() és a run(input_data) függvényeket is, amelyek meghatározzák a webszolgáltatás modellvégrehajtási lépéseit. |
runtime
Kötelező
|
A rendszerképhez használni kívánt futtatókörnyezet. A jelenleg támogatott futtatókörnyezetek a "spark-py" és a "python". |
conda_file
|
A lemezképhez használandó Conda-környezetdefiníciót tartalmazó helyi .yml fájl elérési útja. Alapértelmezett érték: None
|
docker_file
|
A rendszerkép beállításakor futtatandó további Docker-lépéseket tartalmazó helyi fájl elérési útja. Alapértelmezett érték: None
|
schema_file
|
A rendszerkép üzembe helyezésekor használandó webszolgáltatási sémát tartalmazó helyi fájl elérési útja. Swagger-specifikációk létrehozására szolgál egy modell üzembe helyezéséhez. Alapértelmezett érték: None
|
dependencies
|
A kép futtatásához szükséges további fájlok/mappák elérési útjainak listája. Alapértelmezett érték: None
|
enable_gpu
|
Engedélyezve van-e a GPU-támogatás a képen. A GPU-rendszerképet a Microsoft Azure Servicesben, például az Azure Container Instancesben, az Azure Machine Learning Computeben, az Azure Virtual Machinesben és az Azure Kubernetes Service-ben kell használni. Alapértelmezett érték hamis Alapértelmezett érték: None
|
tags
|
A képhez tartozó kulcsértékcímkék szótára. Alapértelmezett érték: None
|
properties
|
A kép létrehozásához használt kulcsérték-tulajdonságok szótára. Ezek a tulajdonságok az üzembe helyezés után nem módosíthatók, de új kulcsértékpárok is hozzáadhatók. Alapértelmezett érték: None
|
description
|
A kép szöveges leírása. Alapértelmezett érték: None
|
base_image
|
Alaprendszerképként használandó egyéni rendszerkép. Ha nem ad meg alaprendszerképet, a rendszer az alaprendszerképet a megadott futtatókörnyezeti paraméter alapján használja. Alapértelmezett érték: None
|
base_image_registry
|
Az alaprendszerképet tartalmazó rendszerkép-beállításjegyzék. Alapértelmezett érték: None
|
cuda_version
|
A GPU-támogatást igénylő képek telepítéséhez szükséges CUDA-verzió. A GPU-rendszerképet a Microsoft Azure Servicesben, például az Azure Container Instancesben, az Azure Machine Learning Computeben, az Azure Virtual Machinesben és az Azure Kubernetes Service-ben kell használni. A támogatott verziók a 9.0, a 9.1 és a 10.0. Ha a "enable_gpu" be van állítva, ez alapértelmezés szerint "9.1". Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
A rendszerkép létrehozásakor használandó konfigurációs objektum. |
Kivételek
Típus | Description |
---|---|
run
Futtassa a képet helyileg a megadott bemeneti adatokkal.
A Dockernek telepítve kell lennie, és működnie kell. Ez a módszer csak processzoron működik, mivel a GPU-kompatibilis rendszerkép csak a Microsoft Azure Servicesen futtatható.
run(input_data)
Paraméterek
Name | Description |
---|---|
input_data
Kötelező
|
<xref:varies>
A rendszerképnek futtatáskor továbbítandó bemeneti adatok |
Válaszok
Típus | Description |
---|---|
<xref:varies>
|
A rendszerkép futtatásának eredményei. |
Kivételek
Típus | Description |
---|---|
serialize
Konvertálja ezt a ContainerImage objektumot JSON szerializált szótárlá.
serialize()
Válaszok
Típus | Description |
---|---|
A ContainerImage JSON-ábrázolása. |
Kivételek
Típus | Description |
---|---|