Share via


Environment Classe

Ambiente para treinamento.

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
Obrigatório

Nome do recurso.

version
str
Obrigatório

Versão do ativo.

description
str
Obrigatório

Descrição do recurso.

image
str
Obrigatório

URI de uma imagem base personalizada.

build
BuildContext
Obrigatório

Contexto de build do Docker para criar o ambiente. Mutuamente exclusivo com "image"

conda_file
Union[str, PathLike]
Obrigatório

Caminho para o arquivo de configuração listando pacotes conda a serem instalados.

tags
dict[str, str]
Obrigatório

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

properties
dict[str, str]
Obrigatório

O dicionário de propriedades do ativo.

datastore
str
Obrigatório

O armazenamento de dados para o qual carregar o artefato local.

kwargs
dict
Obrigatório

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

Exemplos

Crie um 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

Despeje o conteúdo do ativo em um arquivo no formato YAML.

validate

Validar o ambiente verificando seu nome, imagem e build

dump

Despeje o conteúdo do ativo em um arquivo no formato YAML.

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

Parâmetros

dest
Union[<xref:PathLike>, str, IO[AnyStr]]
Obrigatório

O caminho local ou fluxo de arquivos para o qual gravar o conteúdo YAML. Se dest for um caminho de arquivo, um novo arquivo será criado. Se dest for um arquivo aberto, o arquivo será gravado diretamente.

kwargs
dict

Argumentos adicionais a serem passados para o serializador YAML.

Exceções

Gerado se dest for um caminho de arquivo e o arquivo já existir.

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

validate

Validar o ambiente verificando seu nome, imagem e build

validate()

Exceções

Gerado se dest for um caminho de arquivo e o arquivo já existir.

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

Exemplos

Exemplo de ambiente de validação.


   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.

Retornos

O caminho base do recurso.

Tipo de retorno

str

conda_file

Especificação de ambiente do Conda.

Retornos

Dependências conda carregadas de conda_file parâmetro.

Tipo de retorno

creation_context

O contexto de criação do recurso.

Retornos

Os metadados de criação do recurso.

Tipo de retorno

id

A ID do recurso.

Retornos

A ID global do recurso, uma ID do ARM (Resource Manager do Azure).

Tipo de retorno

version

A versão do ativo.

Retornos

A versão do ativo.

Tipo de retorno

str