Partilhar via

Environment Classe

  • Referência

Ambiente de preparação.

Herança
azure.ai.ml.entities._assets.asset.Asset
Environment
azure.ai.ml.entities._mixins.LocalizableMixin
Environment

Construtor

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
Necessário

Nome do recurso.

version
str
Necessário

Versão do recurso.

description
str
Necessário

Descrição do recurso.

image
str
Necessário

URI de uma imagem de base personalizada.

build
BuildContext
Necessário

Contexto de compilação do Docker para criar o ambiente. Mutuamente exclusivo com "imagem"

conda_file
Union[str, PathLike]
Necessário

Caminho para o ficheiro de configuração que lista os pacotes conda a instalar.

tags
dict[str, str]
Necessário

Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas.

properties
dict[str, str]
Necessário

O dicionário da propriedade do recurso.

datastore
str
Necessário

O arquivo de dados para onde carregar o artefacto local.

kwargs
dict
Necessário

Um dicionário de parâmetros de configuração adicionais.

Exemplos

Criar um objeto de Ambiente.


   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

Despeja o conteúdo do recurso num ficheiro no formato YAML.
validate

Validar o ambiente ao verificar o respetivo nome, imagem e compilação

dump

Despeja o conteúdo do recurso num ficheiro no formato YAML.

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

Parâmetros

dest
Union[<xref:PathLike>, str, IO[AnyStr]]
Necessário

O caminho local ou o fluxo de ficheiros para o qual escrever o conteúdo YAML. Se dest for um caminho de ficheiro, será criado um novo ficheiro. Se dest for um ficheiro aberto, o ficheiro será escrito diretamente.

kwargs
dict

Argumentos adicionais para passar para o serializador YAML.

Exceções

FileExistsError

Gerado se dest é um caminho de ficheiro e o ficheiro já existe.

IOError

Gerado se o dest for um ficheiro aberto e o ficheiro não for gravável.

validate

Validar o ambiente ao verificar o respetivo nome, imagem e compilação

validate()

Exceções

FileExistsError

Gerado se dest é um caminho de ficheiro e o ficheiro já existe.

IOError

Gerado se o dest for um ficheiro aberto e o ficheiro não for gravável.

Exemplos

Validar exemplo de ambiente.


   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

O caminho base do recurso.

Devoluções

O caminho base do recurso.

Tipo de retorno

str

conda_file

Especificação do ambiente conda.

Devoluções

Dependências conda carregadas a partir de conda_file parâmetro.

Tipo de retorno

Dict

creation_context

O contexto de criação do recurso.

Devoluções

Os metadados de criação do recurso.

Tipo de retorno

Optional[SystemData]

id

O ID do recurso.

Devoluções

O ID global do recurso, um ID do Azure Resource Manager (ARM).

Tipo de retorno

Optional[str]

version

A versão do recurso.

Devoluções

A versão do recurso.

Tipo de retorno

str