ModelPackage Classe

Representa um empacotamento de um ou mais modelos e as respetivas dependências numa imagem do Docker ou dockerfile.

Um objeto ModelPackage é devolvido a package partir do 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.

Herança

builtins.object

ModelPackage

Construtor

ModelPackage(workspace, operation_id, environment)

Parâmetros

workspace

Workspace

Necessário

A área de trabalho na qual o pacote existe.

operation_id

str

Necessário

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

environment

Environment

Necessário

Ambiente no qual o modelo está a ser empacotado.

workspace

Workspace

Necessário

A área de trabalho na qual o pacote existe.

operation_id

str

Necessário

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

environment

Environment

Necessário

Ambiente no qual o modelo está a ser empacotado.

Observações

Para criar uma imagem do Docker que encapsula o modelo e as respetivas dependências, pode utilizar a opção de empacotamento de modelos. A imagem de saída será enviada para o ACR da área de trabalho.

Tem de incluir um objeto Ambiente na configuração de inferência para utilizar o método de pacote 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 criada, pode gerar um Dockerfile e transferir todos os recursos necessários para criar uma imagem sobre o 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

azureml.core.model.ModelPackage.workspace

A área de trabalho na qual o pacote é criado.

Métodos

get_container_registry	Devolva um objeto ContainerRegistry que indica onde a imagem ou imagem de base (pacotes dockerfile) está armazenada.
get_logs	Obtenha os registos de criação do pacote.
pull	Extraia a saída do pacote para o computador local. Isto só pode ser utilizado com um pacote de imagem do Docker.
save	Guarde a saída do pacote num diretório local. Isto só pode ser utilizado com um pacote do Dockerfile.
serialize	Converta este ModelPackage num dicionário serializável JSON para apresentação pela CLI.
update_creation_state	Atualize o estado atual do objeto dentro da memória. Este método efetua uma atualização no local das propriedades do objeto com base no estado atual do objeto de cloud correspondente. Isto é utilizado principalmente para consulta manual do estado de criação.
wait_for_creation	Aguarde até que o pacote conclua a criação. Este método aguarda que a criação do pacote atinja um estado terminal. Emitirá um WebserviceException se atingir um estado terminal não bem-sucedido.

get_container_registry

Devolva um objeto ContainerRegistry que indica onde a imagem ou imagem de base (pacotes dockerfile) está armazenada.

get_container_registry()

Devoluções

O endereço e as credenciais de início de sessão do registo de contentor.

Tipo de retorno

ContainerRegistry

get_logs

Obtenha os registos de criação do pacote.

get_logs(decode=True, offset=0)

Parâmetros

decode

bool

valor predefinido: True

Indica se pretende descodificar os bytes de registo não processados para uma cadeia.

offset

int

valor predefinido: 0

O desvio de bytes a partir do qual começar a ler os registos.

Devoluções

Os registos de criação do pacote.

Tipo de retorno

bytes,

str

Exceções

WebserviceException

pull

Extraia a saída do pacote para o computador local.

Isto só pode ser utilizado com um pacote de imagem do Docker.

pull()

Exceções

WebserviceException

save

Guarde a saída do pacote num diretório local.

Isto só pode ser utilizado com um pacote do Dockerfile.

save(output_directory)

Parâmetros

output_directory

str

Necessário

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

Exceções

WebserviceException

serialize

Converta este ModelPackage num dicionário serializável JSON para apresentação pela CLI.

serialize()

Devoluções

A representação JSON deste ModelPackage.

Tipo de retorno

dict

update_creation_state

Atualize o estado atual do objeto dentro da memória.

Este método efetua uma atualização no local das propriedades do objeto com base no estado atual do objeto de cloud correspondente. Isto é utilizado principalmente para consulta manual do estado de criação.

update_creation_state()

Exceções

WebserviceException

wait_for_creation

Aguarde até que o pacote conclua a criação.

Este método aguarda que a criação do pacote atinja um estado terminal. Emitirá um WebserviceException se atingir um estado terminal não bem-sucedido.

wait_for_creation(show_output=False)

Parâmetros

show_output

bool

valor predefinido: False

Indica se pretende imprimir uma saída mais verbosa.

Exceções

WebserviceException