Menyalin model di Vertex AI Model Registry

Melatih AutoML, model besar, dan model kustom Anda di Vertex AI ke level yang Anda inginkan memerlukan waktu dan eksperimen. Jika Anda memiliki model beperforma baik yang ingin digunakan di project atau lokasi lain, melatih model baru bukanlah opsi terbaik. Pelatihan model bersifat non-deterministik, sehingga tidak mungkin Anda akan mendapatkan model yang identik dari data yang identik. Selain itu, melatih model di setiap region atau project bukanlah cara mudah untuk mempertahankan konsistensi perilaku model lintas region. Dengan model salinan Vertex AI Model Registry, Anda dapat menyalin model dari Vertex AI Model Registry ke lokasi terpisah dalam project yang sama atau ke project yang berbeda.

Catatan: Model penyalinan tidak mendukung penyalinan model Natural Language dan BigQuery ML AutoML.

Saat melakukan penyalinan model, jika Anda tidak menentukan versi model yang ingin disalin, versi model default akan disalin. Untuk mempelajari default model atau alias model lebih lanjut, lihat Cara menggunakan alias model.

Batasan

Saat Anda menyalin model, tidak semua informasi model akan disalin. Model yang disalin tidak akan mempertahankan hal berikut:

• Alias versi.
• ID model kustom. Anda dapat menentukan ID baru setelah model disalin.
• Semua evaluasi model yang ada.
• Spesifikasi enkripsi. Anda harus menentukan kunci enkripsi saat menyalin model untuk region target.
• Deployment dan prediksi batch.
• Model Gemini 1.5 tidak dapat disalin di seluruh project.
• Untuk penyalinan lintas project, Anda dapat menyalin model kustom yang memiliki image penampung pihak ketiga.

Menyalin model antar-project

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Prasyarat

Untuk menyalin model di seluruh project, pemilik model sumber harus terlebih dahulu memberikan izin ekspor model ke project tujuan:

1. Pilih project Anda dari konsol Google Cloud.
2. Buka halaman IAM & Admin.
3. Di halaman izin IAM, klik Berikan akses dan jendela pop-up akan muncul untuk memungkinkan Anda menambahkan akun utama baru ke project sumber.
4. Dapatkan akun layanan per produk, per project (P4SA) service-{project_number}@gcp-sa-aiplatform.iam.gserviceaccount.com dari project tujuan.
5. Tambahkan P4SA project tujuan sebagai akun utama baru ke project sumber dan tetapkan peran Agen Layanan Vertex AI ke project tersebut.
6. Setelah mengklik Simpan, P4SA project tujuan akan memiliki izin untuk mengekspor model dari project sumber.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• DESTINATION_LOCATION: Region tempat Anda ingin menyalin model. Misalnya, us-central1
• DESTINATION_PROJECT_ID: Project ID atau nomor project tempat Anda ingin menyalin model.
• SOURCE_PROJECT_ID: Project ID atau nomor project Anda.
• SOURCE_LOCATION: Region Vertex AI tempat Anda menyalin model.
• SOURCE_MODEL_ID: Sumber ID model yang akan disalin.
• VERSION_ID: (Opsional) ID versi model yang akan disalin (jika tidak diberikan, versi default akan disalin)

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON yang mirip seperti berikut:

  {
    "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"
      }
    }
  }

Konsol

Gunakan petunjuk berikut untuk menyalin model ke project lain.

1. Di konsol Google Cloud, buka halaman Vertex AI Model Registry. Buka Vertex AI Model Registry
2. Dari Model Registry, pilih menu More actions untuk model yang ingin Anda salin.
   
3. Klik Salin model.
4. Pilih Ke project lain atau Ke region lain.

Menyalin model ke project lain

1. Pilih Ke project lain.
2. Pilih versi model yang ingin Anda salin.
3. Pilih project tujuan yang ingin Anda salin.
4. Pilih region tujuan, misalnya, us-central1.
5. Opsi lanjutan: Opsional untuk memilih metode enkripsi, menggunakan kunci enkripsi yang dikelola Google atau kunci Cloud KMS.

Menyalin model antarlokasi

REST

Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:

• DESTINATION_LOCATION: Region tempat Anda menggunakan Vertex AI. Misalnya, us-central1
• SOURCE_LOCATION: Region Vertex AI tempat Anda akan menyalin model.
• PROJECT_ID: Project ID atau nomor project Anda.
• MODEL_ID:ID model yang akan disalin.
• VERSION_ID: (Opsional) ID versi model yang akan disalin (jika tidak diberikan, versi default akan disalin)

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON yang mirip seperti berikut:

  {
    "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"
      }
    }
  }

Konsol

Dengan salinan lintas region, Anda dapat menyalin model sebagai model baru dalam region target, atau sebagai versi baru dari model yang ada di region tersebut.

Gunakan petunjuk berikut untuk menyalin model.

1. Di konsol Google Cloud, buka halaman Vertex AI Model Registry. Buka Model Registry
2. Dari Model Registry, pilih menu More actions untuk model yang ingin Anda salin.
   
3. Klik Salin model
4. Pilih Ke project lain atau Ke region lain.

Menyalin model ke region yang berbeda

1. Pilih Ke region lain.
2. Pilih versi model yang ingin Anda salin.
3. Pilih Salin sebagai model baru atau Salin sebagai versi baru.
4. Pilih wilayah tujuan.
5. Tambahkan nama model atau ID model tujuan. Jika Anda menyalin model untuk pertama kalinya, model tersebut akan diberi alias default di region baru.