Share via


Environment Classe

Environnement pour l’entraînement.

Héritage
azure.ai.ml.entities._assets.asset.Asset
Environment
azure.ai.ml.entities._mixins.LocalizableMixin
Environment

Constructeur

Environment(*, name: str | None = None, version: str | None = None, description: str | None = None, image: str | None = None, build: BuildContext | None = None, conda_file: str | PathLike | None = None, tags: Dict | None = None, properties: Dict | None = None, datastore: str | None = None, **kwargs)

Paramètres

name
str
Obligatoire

Nom de la ressource.

version
str
Obligatoire

Version de la ressource.

description
str
Obligatoire

Description de la ressource.

image
str
Obligatoire

URI d’une image de base personnalisée.

build
BuildContext
Obligatoire

Contexte de build Docker pour créer l’environnement. Mutuellement exclusif avec « image »

conda_file
Union[str, PathLike]
Obligatoire

Chemin d’accès au fichier de configuration répertoriant les packages conda à installer.

tags
dict[str, str]
Obligatoire

Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour.

properties
dict[str, str]
Obligatoire

Dictionnaire de propriétés de ressource.

datastore
str
Obligatoire

Magasin de données dans lequel charger l’artefact local.

kwargs
dict
Obligatoire

Dictionnaire des paramètres de configuration supplémentaires.

Exemples

Créez un objet Environment.


   from azure.ai.ml.entities._assets.environment import Environment

   environment = Environment(
       name="env-name",
       version="2.0",
       description="env-description",
       image="env-image",
       conda_file="./sdk/ml/azure-ai-ml/tests/test_configs/deployments/model-1/environment/conda.yml",
       tags={"tag1": "value1", "tag2": "value2"},
       properties={"prop1": "value1", "prop2": "value2"},
       datastore="datastore",
   )

Méthodes

dump

Videz le contenu de la ressource dans un fichier au format YAML.

validate

Valider l’environnement en vérifiant son nom, son image et sa build

dump

Videz le contenu de la ressource dans un fichier au format YAML.

dump(dest: str | PathLike | IO, **kwargs) -> None

Paramètres

dest
Union[<xref:PathLike>, str, IO[AnyStr]]
Obligatoire

Chemin d’accès local ou flux de fichiers dans lequel écrire le contenu YAML. Si dest est un chemin de fichier, un nouveau fichier est créé. Si dest est un fichier ouvert, le fichier est écrit directement dans.

kwargs
dict

Arguments supplémentaires à passer au sérialiseur YAML.

Exceptions

Déclenché si dest est un chemin de fichier et que le fichier existe déjà.

Déclenché si dest est un fichier ouvert et que le fichier n’est pas accessible en écriture.

validate

Valider l’environnement en vérifiant son nom, son image et sa build

validate()

Exceptions

Déclenché si dest est un chemin de fichier et que le fichier existe déjà.

Déclenché si dest est un fichier ouvert et que le fichier n’est pas accessible en écriture.

Exemples

Exemple d’environnement de validation.


   from azure.ai.ml.entities import BuildContext, Environment

   env_docker_context = Environment(
       build=BuildContext(
           path="./sdk/ml/azure-ai-ml/tests/test_configs/environment/environment_files",
           dockerfile_path="DockerfileNonDefault",
       ),
       name="create-environment",
       version="2.0",
       description="Environment created from a Docker context.",
   )

   env_docker_context.validate()

Attributs

base_path

Chemin d’accès de base de la ressource.

Retours

Chemin d’accès de base de la ressource.

Type de retour

str

conda_file

Spécification de l’environnement Conda.

Retours

Dépendances Conda chargées à partir de conda_file param.

Type de retour

creation_context

Contexte de création de la ressource.

Retours

Métadonnées de création pour la ressource.

Type de retour

id

ID de la ressource.

Retours

ID global de la ressource, id Azure Resource Manager (ARM).

Type de retour

version

Version de la ressource.

Retours

Version de la ressource.

Type de retour

str