ContainerImage Klas
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
Installatiekopieënconstructor.
Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse.
Image constructor 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
-
ContainerImage
Constructor
ContainerImage(workspace, name=None, id=None, tags=None, properties=None, version=None)Parameters
- name
- str
De naam van de afbeelding die moet worden opgehaald. Retourneert de nieuwste versie, als deze bestaat
- id
- str
De specifieke id van de afbeelding die moet worden opgehaald. (Id is ':')
- tags
- list
Filtert afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]
- properties
- list
Filtert afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]
- version
- str
Wanneer versie en naam beide zijn opgegeven, retourneert de specifieke versie van de installatiekopieën.
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 het ophalen van een installatiekopie uit een werkruimte op zowel naam als 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 binnen de webservice, evenals de specifieke omgeving en afhankelijkheden die het moet kunnen uitvoeren. |
| run |
Voer de installatiekopieën lokaal uit met de opgegeven invoergegevens. Docker moet zijn geïnstalleerd en wordt uitgevoerd om te werken. Deze methode werkt alleen op CPU, omdat de installatiekopieën met GPU alleen kunnen worden uitgevoerd op 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 binnen de webservice, evenals de specifieke omgeving en afhankelijkheden die het moet kunnen uitvoeren.
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
- execution_script
- str
Pad naar het lokale Python-bestand dat de code bevat die moet worden uitgevoerd voor de installatiekopieën. Moet zowel de functies init() als run(input_data) bevatten waarmee de modeluitvoeringsstappen voor de webservice worden gedefinieerd.
- runtime
- str
De runtime die moet worden gebruikt voor de installatiekopieën. Huidige ondersteunde runtimes zijn 'spark-py' en 'python'.
- conda_file
- str
Pad naar het lokale .yml-bestand met een Conda-omgevingsdefinitie die moet worden gebruikt voor de installatiekopie.
- docker_file
- str
Pad naar het lokale bestand met extra Docker-stappen die moeten worden uitgevoerd bij het instellen van de installatiekopie.
- schema_file
- str
Pad naar een 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.
Lijst met paden naar aanvullende bestanden/mappen die de installatiekopieën moeten uitvoeren.
- enable_gpu
- bool
Of GPU-ondersteuning al dan niet moet worden ingeschakeld in de installatiekopieën. De GPU-installatiekopieën moeten worden gebruikt voor Microsoft Azure-services zoals Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines en Azure Kubernetes Service. Standaard ingesteld op False.
Woordenlijst met sleutelwaardetags om deze afbeelding te geven.
Woordenlijst met sleutelwaarde-eigenschappen om deze afbeelding te geven. Deze eigenschappen kunnen niet worden gewijzigd na de implementatie, maar er kunnen wel nieuwe sleutelwaardeparen worden toegevoegd.
- base_image
- str
Een aangepaste installatiekopieën die als basisinstallatiekopieën moeten worden gebruikt. Als er geen basisinstallatiekopieën worden opgegeven, wordt de basisinstallatiekopieën gebruikt op basis van de opgegeven runtimeparameter.
- base_image_registry
- ContainerRegistry
Installatiekopieënregister dat de basisinstallatiekopieën bevat.
- cuda_version
- str
Versie van CUDA die moet worden geïnstalleerd voor installatiekopieën die GPU-ondersteuning nodig hebben. De GPU-installatiekopieën moeten worden gebruikt voor 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 dit standaard ingesteld op '9.1'.
Retouren
Een configuratieobject dat moet worden gebruikt bij het maken van de installatiekopieën.
Retourtype
Uitzonderingen
run
Voer de installatiekopieën lokaal uit met de opgegeven invoergegevens.
Docker moet zijn geïnstalleerd en wordt uitgevoerd om te werken. Deze methode werkt alleen op CPU, omdat de installatiekopieën met GPU alleen kunnen worden uitgevoerd op Microsoft Azure-services.
run(input_data)Parameters
- input_data
- <xref:varies>
De invoergegevens die moeten worden doorgegeven aan de installatiekopieën wanneer ze worden uitgevoerd
Retouren
De resultaten van het uitvoeren van de installatiekopieën.
Retourtype
Uitzonderingen
serialize
Converteer dit ContainerImage-object naar een geserialiseerde JSON-woordenlijst.
serialize()Retouren
De JSON-weergave van deze ContainerImage.
Retourtype
Uitzonderingen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor