Compartilhar via


ModelPackage Classe

Representa um empacotamento de um ou mais modelos e suas dependências em uma imagem do Docker ou dockerfile.

Um objeto ModelPackage é retornado do package método da classe Model. O generate_dockerfile parâmetro do método de pacote determina se uma imagem do Docker ou Dockerfile é criada.

Inicialize o pacote criado com modelos e dependências.

Construtor

ModelPackage(workspace, operation_id, environment)

Parâmetros

Nome Description
workspace
Obrigatório

O workspace no qual o pacote existe.

operation_id
Obrigatório
str

ID da operação de criação de pacote.

environment
Obrigatório

Ambiente no qual o modelo está sendo empacotado.

workspace
Obrigatório

O workspace no qual o pacote existe.

operation_id
Obrigatório
str

ID da operação de criação de pacote.

environment
Obrigatório

Ambiente no qual o modelo está sendo empacotado.

Comentários

Para criar uma imagem do Docker que encapsula seu modelo e suas dependências, você pode usar a opção de empacotamento de modelo. A imagem de saída será enviada por push para o ACR do seu workspace.

Você deve incluir um objeto Environment em sua configuração de inferência para usar o método de pacote model.


   package = Model.package(ws, [model], inference_config)
   package.wait_for_creation(show_output=True)  # Or show_output=False to hide the Docker build logs.
   package.pull()

Em vez de uma imagem totalmente compilada, você pode gerar um Dockerfile e baixar todos os ativos necessários para criar uma imagem sobre seu Ambiente.


   package = Model.package(ws, [model], inference_config, generate_dockerfile=True)
   package.wait_for_creation(show_output=True)
   package.save("./local_context_dir")

Variáveis

Nome Description
azureml.core.model.ModelPackage.workspace

O workspace no qual o pacote é criado.

Métodos

get_container_registry

Retorne um objeto ContainerRegistry indicando onde a imagem ou a imagem base (pacotes dockerfile) é armazenada.

get_logs

Recupere os logs de criação do pacote.

pull

Efetue pull da saída do pacote para o computador local.

Isso só pode ser usado com um pacote de imagem do Docker.

save

Salve a saída do pacote em um diretório local.

Isso só pode ser usado com um pacote do Dockerfile.

serialize

Converta esse ModelPackage em um dicionário serializável JSON para exibição pela CLI.

update_creation_state

Atualize o estado atual do objeto na memória.

Esse método executa uma atualização in-loco das propriedades do objeto com base no estado atual do objeto de nuvem correspondente. Isso é usado principalmente para sondagem manual do estado de criação.

wait_for_creation

Aguarde até que o pacote termine de criar.

Esse método aguarda a criação do pacote atingir um estado terminal. Gerará um WebserviceException se atingir um estado terminal não bem-sucedido.

get_container_registry

Retorne um objeto ContainerRegistry indicando onde a imagem ou a imagem base (pacotes dockerfile) é armazenada.

get_container_registry()

Retornos

Tipo Description

O endereço e as credenciais de logon do registro de contêiner.

get_logs

Recupere os logs de criação do pacote.

get_logs(decode=True, offset=0)

Parâmetros

Nome Description
decode

Indica se os bytes brutos de log devem ser decodificados em uma cadeia de caracteres.

Valor padrão: True
offset
int

O deslocamento de bytes do qual começar a ler os logs.

Valor padrão: 0

Retornos

Tipo Description
str

Os logs de criação do pacote.

Exceções

Tipo Description

pull

Efetue pull da saída do pacote para o computador local.

Isso só pode ser usado com um pacote de imagem do Docker.

pull()

Exceções

Tipo Description

save

Salve a saída do pacote em um diretório local.

Isso só pode ser usado com um pacote do Dockerfile.

save(output_directory)

Parâmetros

Nome Description
output_directory
Obrigatório
str

O diretório local que será criado para conter o conteúdo do pacote.

Exceções

Tipo Description

serialize

Converta esse ModelPackage em um dicionário serializável JSON para exibição pela CLI.

serialize()

Retornos

Tipo Description

A representação JSON deste ModelPackage.

update_creation_state

Atualize o estado atual do objeto na memória.

Esse método executa uma atualização in-loco das propriedades do objeto com base no estado atual do objeto de nuvem correspondente. Isso é usado principalmente para sondagem manual do estado de criação.

update_creation_state()

Exceções

Tipo Description

wait_for_creation

Aguarde até que o pacote termine de criar.

Esse método aguarda a criação do pacote atingir um estado terminal. Gerará um WebserviceException se atingir um estado terminal não bem-sucedido.

wait_for_creation(show_output=False)

Parâmetros

Nome Description
show_output

Indica se a saída mais detalhada deve ser impressa.

Valor padrão: False

Exceções

Tipo Description