Partilhar 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 um Dockerfile é criado.

Inicialize o pacote criado com modelo(s) e dependências.

Construtor

ModelPackage(workspace, operation_id, environment)

Parâmetros

Name Description
workspace
Necessário
Workspace

O espaço de trabalho no qual o pacote existe.
operation_id
Necessário
str

ID da operação de criação do pacote.
environment
Necessário
Environment

Ambiente no qual o modelo está sendo empacotado.
workspace
Necessário
Workspace

O espaço de trabalho no qual o pacote existe.
operation_id
Necessário
str

ID da operação de criação do pacote.
environment
Necessário
Environment

Ambiente no qual o modelo está sendo empacotado.

Observações

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 para o ACR do seu espaço de trabalho.

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 construída, 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

Name Description
azureml.core.model.ModelPackage.workspace

O espaço de trabalho no qual o pacote é criado.

Métodos

get_container_registry

Retorna um objeto ContainerRegistry indicando onde a imagem ou a imagem base (pacotes Dockerfile) está armazenada.
get_logs

Recupere os logs de criação do pacote.
pull

Puxe a saída do pacote para a máquina local.

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

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

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

Converta este 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 para atingir um estado terminal. Lançará um WebserviceException se atingir um estado terminal sem sucesso.

get_container_registry

Retorna um objeto ContainerRegistry indicando onde a imagem ou a imagem base (pacotes Dockerfile) está armazenada.

get_container_registry()

Devoluções

Tipo Description
ContainerRegistry

O endereço e as credenciais de login para o registro de contêiner.

get_logs

Recupere os logs de criação do pacote.

get_logs(decode=True, offset=0)

Parâmetros

Name Description
decode
bool

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

Default value: True
offset
int

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

Default value: 0

Devoluções

Tipo Description
bytes,
str

Os logs de criação de pacotes.

Exceções

Tipo Description
WebserviceException

pull

Puxe a saída do pacote para a máquina local.

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

pull()

Exceções

Tipo Description
WebserviceException

save

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

Isso só pode ser usado com um pacote Dockerfile.

save(output_directory)

Parâmetros

Name Description
output_directory
Necessário
str

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

Exceções

Tipo Description
WebserviceException

serialize

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

serialize()

Devoluções

Tipo Description
dict

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
WebserviceException

wait_for_creation

Aguarde até que o pacote termine de criar.

Esse método aguarda a criação do pacote para atingir um estado terminal. Lançará um WebserviceException se atingir um estado terminal sem sucesso.

wait_for_creation(show_output=False)

Parâmetros

Name Description
show_output
bool

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

Default value: False

Exceções

Tipo Description
WebserviceException