Utiliser des alias de version de modèle

Un alias de modèle est une référence nommée "mutable" à une version de modèle unique dans une ressource de modèle. Les alias sont "mutables", car ils peuvent être déplacés d'une version de modèle à une autre, et "nommés", car ils sont des chaînes arbitraires définies par l'utilisateur. Les alias de modèle sont utiles pour récupérer ou déployer une version de modèle particulière par référence sans avoir à connaître l'ID de la version spécifique. De cette manière, ils fonctionnent comme les tags Docker ou les références de branche dans Git.

Lorsque vous créez un modèle dans Model Registry, la première version se voit automatiquement attribuer l'alias par défaut. L'alias par défaut fait référence à la version du modèle qui sera utilisée si un utilisateur exécute une commande sur un modèle sans spécifier de version particulière. Une version de modèle doit être l'alias par défaut à tout moment. Pour le reste, l'alias par défaut se comporte comme n'importe quel autre alias défini par l'utilisateur.

Dans la console Google Cloud , le marqueur d'alias peut aider les utilisateurs à comprendre rapidement quel modèle est la version stable prête à être déployée. En plus de l'alias par défaut, vous pouvez créer vos propres alias personnalisés et les attribuer aux modèles dans Model Registry.

Dans Model Registry, vous pouvez identifier rapidement la version de modèle comportant l'alias par défaut en consultant la colonne des alias.

Si vous décidez de réattribuer les alias à une autre version de modèle, vous pouvez facilement les déplacer d'une version à une autre.

Remarque : Le format requis pour l'alias de version est [a-z][a-z0-9-]{0,126}[a-z0-9], afin de le distinguer du version_id. Un alias de version par défaut sera créé pour la première version du modèle, et il doit y avoir exactement un alias de version par défaut par modèle.

Voici quelques éléments à prendre en compte lors de l'utilisation d'alias :

• Vos alias de version doivent être uniques et un alias ne peut être attribué qu'à une version par modèle à la fois.
• Les alias de version ne doivent pas être numériques.
• Si vous ne spécifiez pas de version de modèle pour la production, le modèle par défaut est utilisé.
• Un alias est différent d'une étiquette. En savoir plus sur les étiquettes de modèle
• Si vous appliquez un alias existant utilisé dans une autre version de modèle, l'alias est supprimé de cette version.

Définir une version de modèle par défaut

1. Dans la console Google Cloud , accédez à la page Vertex AI Model Registry.

   Accéder à la page "Model Registry"

2. Dans Model Registry, sélectionnez le nom du modèle que vous souhaitez modifier. La fenêtre des détails du modèle s'ouvre. Toutes les versions du modèle sont référencées. L'une des versions du modèle comporte l'alias par défaut.

3. Sélectionnez le bouton Actions correspondant à la version de modèle que vous souhaitez attribuer à la version par défaut.

4. Cliquez sur Définir comme version par défaut.

Ajouter un alias à une version de modèle

1. Dans la console Google Cloud , accédez à la page Vertex AI Model Registry.

   Accéder à la page "Model Registry"

2. Dans Model Registry, sélectionnez le nom du modèle que vous souhaitez modifier. La fenêtre des détails du modèle s'ouvre.

3. Sur la page des détails, sélectionnez la version de modèle souhaitée, puis cliquez sur Plus.

4. Cliquez sur Modifier l'alias. Sélectionnez Ajouter.

5. Modifier l'alias : cliquez sur Ajouter un alias et saisissez le nom de l'alias que vous souhaitez ajouter à la version de modèle.

6. Cliquez sur Enregistrer.

Importer une nouvelle version de modèle avec alias

API

Python

from typing import List

from google.cloud import aiplatform


def upload_new_aliased_model_version_sample(
    parent_name: str,
    artifact_uri: str,
    serving_container_image: str,
    is_default_version: bool,
    version_aliases: List[str],
    version_description: str,
    project: str,
    location: str,
):
    """
    Uploads a new aliased version of a model with ID 'model_id'.
    Args:
        parent_name: The parent resource name of an existing model.
        artifact_uri: The URI of the model artifact to upload.
        serving_container_image: The name of the serving container image to use.
        is_default_version: Whether this version is the default version of the model.
        version_aliases: The aliases of the model version.
        version_description: The description of the model version.
        project: The project ID.
        location: The region name.
    Returns:
        The new version of the model.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Upload a new aliased version of the Model resource with the ID 'model_id'. The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model = aiplatform.Model.upload(
        artifact_uri=artifact_uri,
        serving_container_image=serving_container_image,
        parent_name=parent_name,
        is_default_version=is_default_version,
        version_aliases=version_aliases,
        version_description=version_description,
    )

    return model

Remarque : Si la colonne d'alias ne s'affiche pas, vous devrez peut-être cliquer sur le bouton Options d'affichage des colonnes pour vous assurer que l'élément de colonne "Alias" est sélectionné pour l'affichage.

Supprimer un alias de modèle

Lorsque vous supprimez une version de modèle attribuée à l'alias par défaut, celui-ci est automatiquement attribué à la version suivante la plus récente.

Console

1. Dans la console Google Cloud , accédez à la page Vertex AI Model Registry.

   Accéder à la page "Model Registry"

2. Dans Model Registry, sélectionnez le nom du modèle que vous souhaitez modifier. La fenêtre des détails du modèle s'ouvre.

3. Sur la page d'informations, cliquez sur le bouton Actions pour la version du modèle.

4. Cliquez sur Modifier l'alias.

5. Une liste des alias associés à la version du modèle s'affiche. Pointez à droite du champ d'alias pour que l'étiquette affiche l'icône de suppression.

6. Cliquez sur l'icône de suppression pour l'alias que vous souhaitez supprimer.

7. Cliquez sur Enregistrer.

API

Python

from typing import List

from google.cloud import aiplatform


def delete_aliases_model_version_sample(
    model_id: str,
    version_aliases: List[str],
    version_id: str,
    project: str,
    location: str,
):
    """
    Delete aliases to a model version.
    Args:
        model_id: The ID of the model.
        version_aliases: The version aliases to assign.
        version_id: The version ID of the model to assign the aliases to.
        project: The project ID.
        location: The region name.
    Returns
        None.
    """
    # Initialize the client.
    aiplatform.init(project=project, location=location)

    # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
    # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
    model_registry = aiplatform.models.ModelRegistry(model=model_id)

    # Remove the version aliases to the model version with the version 'version'.
    model_registry.remove_version_aliases(
        target_aliases=version_aliases, version=version_id
    )