Aggiornamento di una distribuzione | IBM Cloud Pak for Data as a Service

Torna alla versione inglese della documentazione

Aggiornamento di una distribuzione

Ultimo aggiornamento: 21 nov 2024

Aggiornamento di una distribuzione

Dopo aver creato una distribuzione in linea o in batch, è ancora possibile aggiornare i propri dettagli di distribuzione e aggiornare gli asset associati alla propria distribuzione.

Per ulteriori informazioni, vedere:

Aggiorna dettagli di distribuzione
Aggiornare gli asset associati a una installazione

Aggiornamento dei dettagli di distribuzione

È possibile aggiornare i dettagli di distribuzione generali, ad esempio il nome della distribuzione, la descrizione, i metadati e le tag utilizzando uno dei seguenti metodi:

Aggiornare i dettagli di distribuzione dall'IU.
Aggiornare i dettagli di distribuzione utilizzando il comando Patch API.

Prima di iniziare

È necessario impostare le credenziali dell'attività generando una chiave API. Per ulteriori informazioni, vedere Gestione delle credenziali delle attività.

Aggiornamento dei dettagli di distribuzione dall'interfaccia utente

Dalla scheda Distribuzioni del tuo spazio di distribuzione, fai clic sul menu azioni per la distribuzione e scegli Modifica impostazioni.
Aggiornare i dettagli e fare clic su Salva.

Suggerimento: puoi anche aggiornare una distribuzione dal foglio delle informazioni per la distribuzione.

Aggiornamento dei dettagli di distribuzione utilizzando il comando Patch API

Utilizzare il comando watsonx.ai Runtime API Patch per aggiornare i dettagli di distribuzione.

curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment id>?space_id=<space id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    },
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    }
]'

Ad esempio, per aggiornare una descrizione per la distribuzione:

curl -X PATCH '<deployment endpoint url>/ml/v4/deployments/<deployment_id>?space_id=<space_id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "replace",
        "path": "/description",
        "value": "<new_description>"
    },
]'

Note:

Per <operation type>, utilizzare "add", "remove"o "replace".

Aggiornamento degli asset associati a una distribuzione

Dopo aver creato una distribuzione in linea o batch, è possibile aggiornare l'asset distribuito dallo stesso endpoint. Ad esempio, se si dispone di un modello con prestazioni migliori, è possibile sostituire il modello distribuito con la versione migliorata. Quando l'aggiornamento è completo, il nuovo modello è disponibile dall'endpoint API REST.

Prima di aggiornare un asset, assicurarsi che queste condizioni siano vere:

Il framework del nuovo modello è compatibile con il modello distribuito esistente.
Lo schema di input esiste e corrisponde al nuovo modello e al modello distribuito.

Attenzione: il mancato rispetto di queste condizioni può causare una mancata distribuzione.
Per ulteriori informazioni, vedi Aggiornamento di un asset dall'interfaccia utente dello spazio di distribuzione.
Per ulteriori informazioni, vedi Aggiornamento di un asset utilizzando il comando Patch API.

Aggiornamento di un asset dall'IU dello spazio di distribuzione

Dalla scheda Distribuzioni dello spazio di distribuzione, fare clic sul menu azioni per la distribuzione e scegliere Modifica.
Fare clic su Sostituisci asset. Dalla casella di dialogo Seleziona un asset , selezionare l'asset con cui si desidera sostituire l'asset corrente e fare clic su Seleziona asset.
Fare clic su Salva.

Importante: verificare che il nuovo asset sia compatibile con la distribuzione.

Sostituzione di un asset installato

Aggiornamento di un asset utilizzando il comando Patch API

Utilizzare il comando 'Patch dell'API di runtime watsonx.ai per aggiornare qualsiasi risorsa supportata.

Utilizzare questo metodo per correggere un modello per una distribuzione in linea.

curl -X PATCH '<deployment endpoint url>/ml/v4/models/<model_id>?space_id=<space_id>&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    },
    {
        "op": "<operation type>",
        "path": "<path>",
        "value": "<new value>"
    }
]'

Ad esempio, applica una patch a un modello con ID 6f01d512-fe0f-41cd-9a52-1e200c525c84 nell'ID dello spazio f2ddb8ce-7b10-4846-9ab0-62454a449802:

curl -X PATCH '<deployment endpoint url>/ml/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802&project_id=<project_id>&version=<YYYY-MM-DD>' \n--data-raw '[

   {
      "op":"replace",
      "path":"/asset",
      "value":{
         "id":"6f01d512-fe0f-41cd-9a52-1e200c525c84",
         "rev":"1"
      }
   }
]'

Una risposta di output corretta è simile alla seguente:

{
  "entity": {
    "asset": {
      "href": "/v4/models/6f01d512-fe0f-41cd-9a52-1e200c525c84?space_id=f2ddb8ce-7b10-4846-9ab0-62454a449802",
      "id": "6f01d512-fe0f-41cd-9a52-1e200c525c84"
    },
    "custom": {
    },
    "description": "Test deployments",
    "name": "test_v4_dep_online_space_hardware_spec",
    "online": {
    },
    "space": {
      "href": "/v4/spaces/f2ddb8ce-7b10-4846-9ab0-62454a449802",
      "id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
    },
    "space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802",
    "status": {
      "online_url": {
        "url": "https://example.com/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83/predictions"
      },
      "state": "updating"
    }
  },
  "metadata": {
    "created_at": "2020-06-08T16:51:08.315Z",
    "description": "Test deployments",
    "guid": "349dc1f7-9452-491b-8aa4-0777f784bd83",
    "href": "/v4/deployments/349dc1f7-9452-491b-8aa4-0777f784bd83",
    "id": "349dc1f7-9452-491b-8aa4-0777f784bd83",
    "modified_at": "2020-06-08T16:55:28.348Z",
    "name": "test_v4_dep_online_space_hardware_spec",
    "parent": {
      "href": ""
    },
    "space_id": "f2ddb8ce-7b10-4846-9ab0-62454a449802"
  }
}

Note:

Per <operation type>, utilizzare "add", "remove"o "replace".
Lo stato iniziale dell'output dell'API PATCH è "aggiornamento". Mantenere il polling dello stato fino a quando non diventa "pronto", quindi richiamare il meta di distribuzione.
Solo l'attributo ASSET può essere specificato per la patch dell'asset. La modifica di qualsiasi altro attributo causa un errore.
Lo schema del modello corrente e del modello a cui viene applicata la patch viene confrontato con l'asset distribuito. Viene restituito un messaggio di avvertenza nell'output dell'API di richiesta Patch se i due non corrispondono. Ad esempio, se viene rilevata una mancata corrispondenza, è possibile trovare queste informazioni nella risposta di output.
```
"status": {
      "message": {
        "text": "The input schema of the asset being patched does not match with the currently deployed asset. Please ensure that the score payloads are up to date as per the asset being patched."
      },
```
Per ulteriori informazioni, vedi Aggiornamento delle specifiche software utilizzando l'API.

Argomento principale: Gestione delle distribuzioni predittive