Mengonfigurasi rekomendasi jenis mesin


Halaman ini menjelaskan cara melihat dan mengubah konfigurasi rekomendasi jenis mesin Anda. Anda dapat mengubah jenis mesin yang direkomendasikan, sehingga rekomendasi yang dihasilkan hanya menyertakan seri mesin pilihan Anda. Anda juga dapat mengubah metrik yang digunakan untuk membuat rekomendasi memori guna meningkatkan akurasi rekomendasi. Perubahan pada konfigurasi diterapkan di level project.

Untuk mengetahui informasi selengkapnya tentang rekomendasi jenis mesin, lihat Menerapkan rekomendasi jenis mesin untuk VM.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud . Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengubah rekomendasi jenis mesin, minta administrator untuk memberi Anda peran IAM Compute Recommender Admin (roles/recommender.computeAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengubah rekomendasi jenis mesin. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengubah rekomendasi jenis mesin:

  • Lihat konfigurasi rekomendasi jenis mesin: recommender.computeInstanceMachineTypeRecommenderConfig.get pada project
  • Ubah konfigurasi rekomendasi jenis mesin: recommender.computeInstanceMachineTypeRecommenderConfig.update pada project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengonfigurasi rekomendasi Anda

Untuk mengonfigurasi rekomendasi jenis mesin, lakukan langkah-langkah berikut:

  1. Mendapatkan konfigurasi saat ini untuk mendapatkan file JSON konfigurasi.
  2. Edit file konfigurasi dalam format JSON.
  3. Upload file konfigurasi baru untuk menerapkan perubahan.

Mendapatkan konfigurasi saat ini

Anda dapat memperoleh konfigurasi saat ini untuk rekomendasi jenis mesin untuk project Anda menggunakan Google Cloud CLI.

gcloud

Untuk mendapatkan parameter konfigurasi saat ini, gunakan perintah gcloud beta recommender recommender-config describe dan gunakan google.compute.instance.MachineTypeRecommender sebagai ID Rekomendasi:

gcloud beta recommender recommender-config describe google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE

Ganti kode berikut:

  • PROJECT_ID: ID project Anda.
  • ZONE: zona tempat Anda ingin mendapatkan konfigurasi saat ini.

Perintah ini menampilkan konfigurasi perekomendasikan, termasuk subkolom preferred_machine_types dan memory_metrics yang dapat diubah.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_AND_CUSTOM",
      "memory_metrics": "MONITORING_AGENT_ONLY"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-08-20T04:41:15.330351Z"
}

Jika Anda ingin menyimpan konfigurasi ke file lokal, sehingga Anda dapat mengeditnya dan menguploadnya nanti, jalankan perintah berikut:

gcloud beta recommender recommender-config describe \
  google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE > LOCAL_FILE_PATH_AND_NAME

Mengedit konfigurasi rekomendasi

Konfigurasi ini memungkinkan Anda menyesuaikan parameter berikut:

  • preferred_machine_types: Rekomendasi jenis mesin yang Anda terima.
  • memory_metrics: Cara metrik memori digunakan untuk membuat rekomendasi.

Opsi untuk rekomendasi jenis mesin

Anda dapat menentukan rekomendasi jenis mesin yang Anda dapatkan dengan mengubah setelan preferred_machine_types ke salah satu nilai berikut:

  • DEFAULT: Nilai defaultnya adalah STANDARD_AND_CUSTOM.
  • STANDARD_AND_CUSTOM: Merekomendasikan kecocokan terbaik dari jenis mesin standar dan kustom.
  • STANDARD_ONLY: Hanya merekomendasikan kecocokan terbaik dari jenis mesin standar.

Opsi untuk rekomendasi memori

Untuk metrik memori yang digunakan untuk membuat rekomendasi, Anda dapat menetapkan nilai berikut:

  • MEMORY_METRICS_DEFAULT: Menggunakan metrik default untuk membuat rekomendasi.
  • MEMORY_METRICS_ALL: Menggunakan semua metrik yang tersedia untuk membuat rekomendasi.
  • MONITORING_AGENT_ONLY: Hanya menggunakan metrik yang dikumpulkan oleh Ops Agent Cloud Monitoring.
  • Jika Anda tidak menggunakan Ops Agent, dan memilih untuk tidak menerima rekomendasi memori, gunakan nilai MEMORY_AGENT_ONLY untuk menonaktifkan rekomendasi.

Untuk mendapatkan rekomendasi yang lebih akurat tentang penggunaan memori, gunakan Agen Operasional.

Memperbarui konfigurasi untuk sebuah project

Untuk memperbarui konfigurasi rekomendasi jenis mesin, ubah nilai konfigurasi dan upload konfigurasi baru untuk project Anda. Anda dapat mengubah jenis mesin yang diinginkan, metrik memori yang digunakan untuk rekomendasi, atau kedua nilai dalam permintaan yang sama.

Setelah Anda mengupload konfigurasi baru, perlu waktu sekitar 48 jam agar konfigurasi tersebut berlaku. Hingga saatnya tiba, setiap rekomendasi yang dihasilkan akan menggunakan konfigurasi sebelumnya.

gcloud

Untuk memperbarui parameter konfigurasi, gunakan perintah gcloud beta recommender recommender-config update dan gunakan google.compute.instance.MachineTypeRecommender sebagai ID Rekomendasi:

gcloud beta recommender recommender-config update google.compute.instance.MachineTypeRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=LOCAL_FILE_PATH_AND_NAME \
  --etag=ETAG

Ganti kode berikut:

  • PROJECT_ID: ID project Anda.
  • ZONE: zona tempat Anda ingin mendapatkan konfigurasi saat ini.
  • LOCAL_FILE_PATH_AND_NAME: jalur ke file JSON dengan konfigurasi saat ini.
  • ETAG: nilai etag konfigurasi saat ini. Anda dapat menemukan nilai ini dalam output perintah sebelumnya.

Dalam file konfigurasi, tentukan hanya objek recommenderGenerationConfig dengan parameter konfigurasi yang diperbarui. Jika Anda menyimpan konfigurasi ke file lokal, pastikan Anda menyalin nilai etag, lalu menghapus semua kolom kecuali nilai recommenderGenerationConfig.

Misalnya, untuk mendapatkan rekomendasi dengan jenis mesin standar saja, gunakan file konfigurasi berikut:

{
  "params": {
    "preferred_machine_types": "STANDARD_ONLY"
  }
}

Jika berhasil, perintah ini akan menampilkan isi respons yang mirip dengan berikut, yang menampilkan konfigurasi baru dengan parameter yang baru saja Anda ubah.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_ONLY"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-08-20T05:00:05Z"
}

Langkah selanjutnya