Atualizando uma implantação

Depois de criar uma implantação online ou em lote, você ainda pode atualizar os detalhes da implantação e os ativos associados a ela.

Para mais informações, veja:

Atualizar detalhes da implantação
Atualizar recursos associados a uma implantação

Atualizando detalhes da implantação

Você pode atualizar detalhes gerais da implantação, como nome, descrição, metadados e tags, usando um destes métodos:

Atualize os detalhes da implantação pela interface do usuário.
Atualize os detalhes da implantação usando o comando Patch API.

Atualizando detalhes de implantação a partir da interface do usuário

Na guia Implantações do seu espaço de implantação, clique no menu de ações da implantação e selecione Editar configurações.
Atualize os detalhes e clique em Salvar.

Dica: você também pode atualizar uma implantação a partir da ficha de informações da implantação.

Observação:

Se nos detalhes da implantação você vir um aviso ao lado da seção Proprietário da implantação, isso significa que o proprietário anterior da implantação deixou o espaço e a implantação deve ser atribuída a um novo proprietário. Nessa situação, apenas um administrador do espaço pode atribuir um novo proprietário da implantação. Consulte Funções e permissões dos colaboradores do espaço de implantação.

Para obter mais informações, consulte Atualizando detalhes de implantação usando o comando Patch API.

Atualizando detalhes de implantação usando o comando Patch API

Use o comando Patch da API do Watson Machine Learning para atualizar os detalhes da implantação.

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>"
    }
]'

Por exemplo, para atualizar uma descrição para implantação:

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>"
    },
]'

Notas:

Observação:

Para <operation type>, use "add", "remove", ou "replace".
Se você estiver atualizando o proprietário da implantação atual, poderá usar apenas a replace operação. Somente um administrador do espaço pode atualizar o proprietário atual da implantação. O novo proprietário deve ser um administrador do espaço ou um editor. Para obter mais informações, consulte Funções e permissões do colaborador do espaço de implantação.

Atualização dos recursos associados a uma implantação

Depois de criar uma implantação online ou em lote, você pode atualizar o recurso implantado a partir do mesmo ponto de acesso. Por exemplo, se você tiver um modelo de desempenho melhor, será possível substituir o modelo implementado pela versão melhorada. Quando a atualização estiver concluída, o novo modelo estará disponível no ponto final da API REST.

Antes de atualizar um ativo, certifique-se de que estas condições sejam verdadeiras:

A estrutura do novo modelo é compatível com o modelo implantado existente.
O esquema de entrada existe e corresponde ao modelo novo e implantado.

Cuidado: não seguir essas condições pode resultar em uma implementação com falha.
Para obter mais informações, consulte Atualizando um ativo a partir da interface do usuário do espaço de implantação.
Para obter mais informações, consulte Atualizando um ativo usando o comando Patch API.

Atualizando um ativo a partir da interface do usuário do espaço de implantação

Na guia Implantações do seu espaço de implantação, clique no menu de ações da implantação e selecione Editar.
Clique em Substituir ativo. Na caixa de diálogo Selecionar um ativo, selecione o ativo pelo qual deseja substituir o ativo atual e clique em Selecionar ativo.
Clique em Salvar.

Importante: certifique-se de que o novo recurso seja compatível com a implantação.

Substituindo um ativo implantado

Você pode importar um espaço ou um projeto, incluindo ativos de dados, para um espaço existente. Assim, você pode atualizar os ativos existentes. Consulte Importando espaços e projetos para espaços de implantação existentes.

Atualizando um ativo usando o comando Patch API

Use o comando Watson Machine Learning Patch API para atualizar qualquer recurso compatível, exceto aplicativos RShiny.

Use este método para aplicar uma correção a um modelo para uma implantação online.

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>"
    }
]'

Por exemplo, aplicar um patch a um modelo com ID 6f01d512-fe0f-41cd-9a52-1e200c525c84 no espaço ID 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"
      }
   }
]'

Uma resposta de saída bem-sucedida tem a seguinte aparência:

{
  "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"
  }
}

Notas:

Para <operation type>, use "add", "remove", ou "replace".
O estado inicial da saída da API PATCH é "atualizando". Continue verificando o status até que ele mude para "pronto" e, em seguida, recupere as metadados da implantação.
Apenas o atributo ASSET pode ser especificado para a correção de ativo. Alterar qualquer outro atributo resulta em um erro.
O esquema do modelo atual e do modelo que está sendo corrigido é comparado ao ativo implantado. Uma mensagem de aviso é retornada na saída da API de solicitação de patch se os dois não corresponderem.Por exemplo, se for detectada uma incompatibilidade, você poderá encontrar essa informação na resposta de saída.
```
"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."
      },
```
Para obter mais informações, consulte Atualização das especificações do software usando a API.