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