Environment Clase

  • Referencia

Entorno para el entrenamiento.

Herencia
azure.ai.ml.entities._assets.asset.Asset
Environment
azure.ai.ml.entities._mixins.LocalizableMixin
Environment

Constructor

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)

Parámetros

name
str
Requerido

Nombre del recurso.

version
str
Requerido

Versión del recurso.

description
str
Requerido

Descripción del recurso.

image
str
Requerido

URI de una imagen base personalizada.

build
BuildContext
Requerido

Contexto de compilación de Docker para crear el entorno. Mutuamente excluyente con "imagen"

conda_file
Union[str, PathLike]
Requerido

Ruta de acceso al archivo de configuración que enumera los paquetes de Conda que se van a instalar.

tags
dict[str, str]
Requerido

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

properties
dict[str, str]
Requerido

Diccionario de propiedades de recurso.

datastore
str
Requerido

Almacén de datos en el que se va a cargar el artefacto local.

kwargs
dict
Requerido

Diccionario de parámetros de configuración adicionales.

Ejemplos

Cree un objeto 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étodos

dump

Volque el contenido del recurso en un archivo en formato YAML.
validate

Valide el entorno comprobando su nombre, imagen y compilación

dump

Volque el contenido del recurso en un archivo en formato YAML.

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

Parámetros

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

Ruta de acceso local o secuencia de archivos en la que se va a escribir el contenido de YAML. Si dest es una ruta de acceso de archivo, se creará un nuevo archivo. Si dest es un archivo abierto, el archivo se escribirá directamente.

kwargs
dict

Argumentos adicionales para pasar al serializador YAML.

Excepciones

FileExistsError

Se genera si dest es una ruta de acceso de archivo y el archivo ya existe.

IOError

Se genera si dest es un archivo abierto y el archivo no se puede escribir.

validate

Valide el entorno comprobando su nombre, imagen y compilación

validate()

Excepciones

FileExistsError

Se genera si dest es una ruta de acceso de archivo y el archivo ya existe.

IOError

Se genera si dest es un archivo abierto y el archivo no se puede escribir.

Ejemplos

Ejemplo de validación del entorno.


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

Atributos

base_path

Ruta de acceso base del recurso.

Devoluciones

Ruta de acceso base del recurso.

Tipo de valor devuelto

str

conda_file

Especificación del entorno de Conda.

Devoluciones

Dependencias de Conda cargadas desde conda_file parámetro.

Tipo de valor devuelto

Dict

creation_context

Contexto de creación del recurso.

Devoluciones

Metadatos de creación del recurso.

Tipo de valor devuelto

Optional[SystemData]

id

El identificador del recurso.

Devoluciones

Identificador global del recurso, un identificador de Azure Resource Manager (ARM).

Tipo de valor devuelto

Optional[str]

version

La versión del recurso.

Devoluciones

La versión del recurso.

Tipo de valor devuelto

str