ModelPackage Classe

  • Referência

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

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

Inicialize o pacote criado com modelos e dependências.

Herança
builtins.object
ModelPackage

Construtor

ModelPackage(workspace, operation_id, environment)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O workspace do pacote existente.
operation_id
Obrigatório
str

A ID da operação de criação do pacote.
environment
Obrigatório
Environment

O ambiente no qual o modelo está sendo empacotado.
workspace
Obrigatório
Workspace

O workspace do pacote existente.
operation_id
Obrigatório
str

A ID da operação de criação do pacote.
environment
Obrigatório
Environment

O ambiente no qual o modelo está sendo empacotado.

Comentários

Para criar uma imagem do Docker para encapsular o modelo e as dependências, você poderá usar a opção de empacotamento de modelo. A imagem de saída será enviada para o ACR do workspace.

Você deve incluir um objeto Ambiente na configuração de inferência para usar o método do pacote de Modelo.


   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ê poderá gerar um Dockerfile e baixar todos os ativos necessários para compilar uma imagem no 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 criar o pacote.

Métodos

get_container_registry

Retornar um objeto ContainerRegistry que indica onde a imagem ou imagem base (pacotes Dockerfile) está armazenada.
get_logs

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

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

Isso somente poderá ser usado com um pacote de imagem do Docker.
save

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

Isso pode ser usado somente com um pacote Dockerfile.
serialize

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

Atualiza o estado atual do objeto na memória.

Esse método executa uma atualização local 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 o pacote concluir a criação.

Este método espera que a criação do pacote atinja um estado terminal. Lançará um WebserviceException se atingir um estado terminal sem êxito.

get_container_registry

Retornar um objeto ContainerRegistry que indica onde a imagem ou imagem base (pacotes Dockerfile) está armazenada.

get_container_registry()

Retornos

Tipo Description
ContainerRegistry

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

get_logs

Recupera os logs de criação do pacote.

get_logs(decode=True, offset=0)

Parâmetros

Nome Description
decode
bool

Indica se é necessário decodificar os bytes de log brutos para uma cadeia de caracteres.

Valor padrão: True
offset
int

O deslocamento de byte do qual iniciar a leitura dos logs.

Valor padrão: 0

Retornos

Tipo Description
bytes,
str

Os logs de criação do pacote.

Exceções

Tipo Description
WebserviceException

pull

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

Isso somente poderá ser usado com um pacote de imagem do Docker.

pull()

Exceções

Tipo Description
WebserviceException

save

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

Isso pode ser usado somente com um pacote 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
WebserviceException

serialize

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

serialize()

Retornos

Tipo Description
dict

A representação JSON desse ModelPackage.

update_creation_state

Atualiza o estado atual do objeto na memória.

Esse método executa uma atualização local 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 o pacote concluir a criação.

Este método espera que a criação do pacote atinja um estado terminal. Lançará um WebserviceException se atingir um estado terminal sem êxito.

wait_for_creation(show_output=False)

Parâmetros

Nome Description
show_output
bool

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

Valor padrão: False

Exceções

Tipo Description
WebserviceException