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.

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

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

   Accéder à la page "Registre de modèles"

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 default.

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

4. Cliquer sur Définir comme modèle par défaut.

Ajouter un alias à une version de modèle

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

   Accéder à la page "Registre de modèles"

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 Save (Enregistrer).

Importer une nouvelle version de modèle avec alias

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.

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
    )