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
|
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
|
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
|
O deslocamento de bytes do qual começar a ler os logs. Valor padrão: 0
|
Retornos
| Tipo | Description |
|---|---|
|
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
|
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 |
|---|---|