Cara menggunakan alias versi model

Alias model adalah referensi bernama yang dapat diubah untuk versi model yang unik dalam resource model. Alias "dapat diubah" karena alias dapat dipindahkan dari satu versi model ke versi model lainnya dan "diberi nama" karena merupakan string arbitrer yang ditentukan pengguna. Alias model berguna untuk mengambil atau men-deploy versi model tertentu dengan referensi tanpa perlu mengetahui ID versi tertentu. Dengan cara ini, alias beroperasi seperti referensi Branch atau Tag Docker di Git.

Saat Anda membuat model baru di Model Registry, versi pertama akan otomatis diberi alias default. Alias default merujuk ke versi model yang digunakan jika pengguna menjalankan perintah pada model tanpa menentukan versi tertentu. Satu versi model harus membawa alias default setiap saat. Jika tidak, alias default akan berperilaku seperti alias lain yang ditentukan pengguna.

Dari konsol Google Cloud, penanda alias dapat membantu pemangku kepentingan memahami secara sekilas model mana yang merupakan versi stabil yang siap untuk deployment. Selain alias default, Anda dapat membuat dan menetapkan alias kustom Anda sendiri ke model di Model Registry.

Di Model Registry, Anda dapat melihat sekilas versi model mana yang memiliki alias default dengan melihat kolom alias.

Jika Anda memutuskan ingin menetapkan ulang alias ke versi model yang berbeda, Anda dapat dengan mudah memindahkan alias ke versi yang berbeda.

Catatan: Format alias versi yang diperlukan adalah [a-z][a-zA-Z0-9-]{0,126}[a-z0-9] untuk membedakan version_id. Alias versi default akan dibuat untuk versi pertama model, dan harus ada tepat satu alias versi default untuk sebuah model.

Beberapa pertimbangan untuk menggunakan alias:

• Alias versi Anda harus unik; dan alias hanya dapat ditetapkan ke satu versi, berdasarkan model, pada satu waktu.
• Alias versi harus non-numerik.
• Jika Anda tidak menentukan versi model untuk produksi, model default akan digunakan.
• Alias berbeda dengan label. Pelajari label model lebih lanjut di sini.
• Jika Anda menerapkan alias yang ada yang digunakan di versi model lain, alias akan dihapus dari versi tersebut.

Menetapkan versi model sebagai default

1. Di konsol Google Cloud, buka halaman Model Registry Vertex AI.

   Buka halaman Model Registry

2. Dari Model Registry, pilih nama model yang ingin Anda edit. Jendela detail model akan terbuka. Semua versi model telah tercantum. Salah satu versi model memiliki alias default.

3. Pilih tombol Tindakan untuk versi model yang ingin Anda tetapkan versi default-nya.

4. Klik Tetapkan sebagai default.

Menambahkan alias ke versi model

1. Di konsol Google Cloud, buka halaman Model Registry Vertex AI.

   Buka halaman Model Registry

2. Dari Model Registry, pilih nama model yang ingin Anda edit. Jendela detail model akan terbuka.

3. Dari halaman detail, pilih versi model yang Anda inginkan dan klik Lainnya.

4. Klik Edit alias. Pilih Tambahkan Baru.

5. Edit alias: Klik Tambahkan alias dan masukkan nama alias yang ingin Anda tambahkan ke versi model.

6. Klik Simpan.

Upload versi model baru dengan 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

Catatan: Jika tidak melihat kolom Alias, Anda mungkin perlu mengklik tombol Opsi tampilan kolom untuk memastikan Alias item kolom dipilih untuk ditampilkan.

Menghapus alias model

Saat Anda menghapus versi model yang diberi alias default, alias akan otomatis ditetapkan ke versi terbaru berikutnya.

Konsol

1. Di konsol Google Cloud, buka halaman Model Registry Vertex AI.

   Buka halaman Model Registry

2. Dari Model Registry, pilih nama model yang ingin Anda edit. Jendela detail model akan terbuka.

3. Dari halaman detail, klik tombol Tindakan pada versi model.

4. Klik Edit alias.

5. Daftar alias yang dilampirkan ke versi model akan ditampilkan. Arahkan kursor ke sebelah kanan kotak teks Alias untuk label guna menampilkan ikon hapus.

6. Klik ikon hapus untuk alias yang ingin Anda hapus.

7. Klik Save.

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
    )