Copier un modèle dans Vertex AI Model Registry

L'entraînement de vos modèles larges et personnalisés AutoML dans Vertex AI au niveau souhaité nécessite d'y consacrer du temps et différents tests. Si vous disposez d'un modèle performant que vous souhaitez utiliser dans un autre projet ou emplacement, l'entraînement d'un nouveau modèle n'est pas la meilleure option. L'entraînement d'un modèle n'étant pas déterministe par nature, il est peu probable que vous obteniez un modèle identique à partir de données identiques. De plus, l'entraînement d'un modèle dans chaque région ou projet ne constitue pas un moyen infaillible de maintenir la cohérence du comportement des modèles d'une région à l'autre. Avec le modèle de copie Vertex AI Model Registry, vous pouvez copier un modèle depuis Vertex AI Model Registry vers un emplacement distinct du même projet ou dans un autre projet.

Lorsque vous effectuez une copie de modèle, si vous ne spécifiez pas la version du modèle à copier, c'est la version de modèle par défaut qui est copiée. Pour en savoir plus sur les modèles par défaut ou sur les alias de modèle, consultez la section Utiliser des alias de modèle.

Limites

Lorsque vous copiez un modèle, toutes les informations associées ne sont pas copiées. Le modèle copié ne conservera pas les éléments suivants :

Alias de version.
ID de modèle personnalisé. Vous pouvez spécifier un nouvel ID une fois le modèle copié.
Toute évaluation de modèle existante.
Spécifications de chiffrement. Vous devez spécifier de nouvelles spécifications lors de la copie pour votre région cible.
Déploiements et prédictions par lot.
Pour la copie inter-projets, vous pouvez copier des modèles personnalisés disposant d'une image de conteneur tierce.

Copier des modèles entre des projets

Prérequis

Pour copier un modèle entre des projets, le propriétaire du modèle source doit d'abord accorder l'autorisation d'exportation du modèle au projet de destination :

Sélectionnez votre projet dans la console Google Cloud.
Accédez à la page IAM et administration
Sur la page des autorisations IAM, cliquez sur Accorder l'accès. Une fenêtre pop-up s'affiche pour vous permettre d'ajouter un compte principal au projet source.
Obtenez le numéro de projet numérique du projet de destination et les identifiants P4SA du projet de destination.
Ajoutez les identifiants P4SA du projet de destination en tant que nouveau principal au projet source et attribuez le rôle d'agent de service Vertex AI au P4SA du projet de destination.
Une fois que vous avez cliqué sur Enregistrer, le P4SA du projet de destination est autorisé à exporter des modèles du projet source.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

DESTINATION_LOCATION : région dans laquelle vous souhaitez copier le modèle. Par exemple, us-central1.
DESTINATION_PROJECT_ID : ID ou numéro du projet dans lequel vous souhaitez copier le modèle.
SOURCE_PROJECT_ID : ID de votre projet ou numéro de projet.
SOURCE_LOCATION : région Vertex AI à partir de laquelle vous copiez un modèle.
SOURCE_MODEL_ID : source de l'ID de modèle à copier.
VERSION_ID (facultatif) : ID de la version de modèle à copier (s'il n'est pas spécifié, la version par défaut est copiée).

Méthode HTTP et URL :

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy

Corps JSON de la requête :

   {
    "sourceModel": projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/models/SOURCE_MODEL_ID
    }

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/models:copy" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

Console

Suivez les instructions ci-dessous pour copier des modèles dans un autre projet.

Dans la console Google Cloud, accédez à la page Registre de modèles de Vertex AI. Accéder à Vertex AI Model Registry
Dans Model Registry, sélectionnez le menu Autres actions pour le modèle que vous souhaitez copier.
Cliquez sur Copier le modèle.
Sélectionnez Vers un autre projet ou Vers une autre région.

Copier un modèle dans un autre projet

Sélectionnez À un autre projet.
Choisissez la version de modèle que vous souhaitez copier.
Choisissez le projet de destination dans lequel vous souhaitez effectuer la copie.
Choisissez la région de destination, par exemple us-central1.
Options avancées: vous pouvez éventuellement choisir la méthode de chiffrement à l'aide d'une clé de chiffrement gérée par Google ou d'une clé Cloud KMS.

Copier des modèles entre des emplacements

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

DESTINATION_LOCATION : région dans laquelle vous utilisez Vertex AI. Par exemple, us-central1.
SOURCE_LOCATION : région Vertex AI à partir de laquelle vous allez copier le modèle.
PROJECT_ID : ID de votre projet ou numéro de projet.
MODEL_ID : ID du modèle à copier.
VERSION_ID (facultatif) : ID de la version de modèle à copier (s'il n'est pas spécifié, la version par défaut est copiée).

Méthode HTTP et URL :

POST https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy

Corps JSON de la requête :


{"sourceModel": projects/PROJECT_ID/locations/SOURCE_LOCATION/models/MODEL_ID[@VERSION_ID]
}

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://DESTINATION_LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/models:copy" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

  {
    "name": "projects/PROJECT_ID/locations/LOCATION/models/MODEL_ID/operations/OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CopyModelOperationMetadata",
      "genericMetadata": {
        "createTime": "2022-07-01T00:10:55.621355Z",
        "updateTime": "2022-07-01T00:10:55.621355Z"
      }
    }
  }

Console

Avec une copie interrégionale, vous pouvez copier un modèle en tant que nouveau modèle dans la région cible, ou en tant que nouvelle version d'un modèle existant dans cette région.

Suivez les instructions ci-dessous pour copier des modèles.

Dans la console Google Cloud, accédez à la page Registre de modèles de Vertex AI. Accéder à la page Model Registry
Dans Model Registry, sélectionnez le menu Autres actions pour le modèle que vous souhaitez copier.
Cliquez sur Copier le modèle.
Sélectionnez Vers un autre projet ou Vers une autre région.

Copier un modèle dans une autre région

Sélectionnez Vers une autre région.
Choisissez la version de modèle que vous souhaitez copier.
Sélectionnez Copier en tant que nouveau modèle ou Copier en tant que nouvelle version.
Choisissez la région de destination.
Ajoutez le nom du modèle de destination ou l'ID du modèle. Si vous copiez un modèle pour la première fois, l'alias par défaut lui est attribué dans la nouvelle région