Utiliser des alias de version de modèle

Un alias de modèle est une référence modifiable à une version nommée de modèle unique dans une ressource de modèle. Un alias est "mutable", car les alias 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 d'un modèle est requise pour porter l'alias par défaut à tout moment. Sinon, 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 parties prenantes à 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 et attribuer vos propres alias personnalisés 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.

La colonne Alias et le tag d'alias par défaut.

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

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'un libellé. En savoir plus sur les libellés 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

Dans la console Google Cloud, accédez à la page Registre de modèles de Vertex AI.

Accéder à la page "Registre de modèles"
Dans le registre de modèles, 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 default.
Sélectionnez le bouton Actions correspondant à la version de modèle que vous souhaitez attribuer à la version par défaut.
Cliquer sur Définir comme modèle par défaut.

Ajouter un alias à une version de modèle

Dans la console Google Cloud, accédez à la page Registre de modèles de Vertex AI.

Accéder à la page "Registre de modèles"
Dans le registre de modèles, sélectionnez le nom du modèle que vous souhaitez modifier. La fenêtre des détails du modèle s'ouvre.
Sur la page des détails, sélectionnez la version de modèle souhaitée, puis cliquez sur Plus.
Cliquez sur Modifier l'alias. Sélectionnez Ajouter.
Modifier l'alias : cliquez sur Ajouter un alias et saisissez le nom de l'alias que vous souhaitez ajouter à la version de modèle.
Cliquez sur Save (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

Supprimer un alias de modèle

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

Console

Dans la console Google Cloud, accédez à la page Registre de modèles de Vertex AI.

Accéder à la page "Registre de modèles"
Dans le registre de modèles, sélectionnez le nom du modèle que vous souhaitez modifier. La fenêtre des détails du modèle s'ouvre.
Sur la page d'informations, cliquez sur le bouton Actions dans la version du modèle.
Cliquez sur Modifier l'alias.
Une liste des alias associés à la version du modèle s'affiche. Placez le curseur à droite de la zone de texte d'alias pour que l'étiquette affiche l'icône de suppression.
Cliquez sur l'icône de suppression de l'alias que vous souhaitez supprimer.
Cliquez sur Save (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
    )