Dokumen ini menjelaskan cara mengurangi latensi jaringan di antara instance Compute Engine dengan membuat dan menerapkan kebijakan penempatan yang ringkas pada instance tersebut. Untuk mempelajari lebih lanjut kebijakan penempatan, termasuk seri mesin yang didukung, batasan, dan harganya, lihat Ringkasan kebijakan penempatan.
Kebijakan penempatan rapat menentukan bahwa instance Anda harus ditempatkan lebih dekat satu sama lain secara fisik. Hal ini dapat membantu meningkatkan performa dan mengurangi latensi jaringan di antara instance Anda saat, misalnya, Anda menjalankan komputasi berperforma tinggi (HPC), machine learning (ML), atau workload server database.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API.
Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
Select the tab for how you plan to use the samples on this page:
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
- Set a default region and zone.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk membuat dan menerapkan kebijakan penempatan yang ringkas ke instance komputasi, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:
-
Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) -
Untuk membuat reservasi:
Compute Admin (
roles/compute.admin
)
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk membuat dan menerapkan kebijakan penempatan yang ringkas ke instance komputasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat dan menerapkan kebijakan penempatan rapat ke instance komputasi:
-
Untuk membuat kebijakan penempatan:
compute.resourcePolicies.create
pada project -
Untuk menerapkan kebijakan penempatan ke instance yang ada:
compute.instances.addResourcePolicies
pada project -
Untuk membuat instance:
compute.instances.create
pada project- Untuk menggunakan image kustom guna membuat VM:
compute.images.useReadOnly
pada image - Untuk menggunakan snapshot untuk membuat VM:
compute.snapshots.useReadOnly
pada snapshot - Untuk menggunakan template instance guna membuat VM:
compute.instanceTemplates.useReadOnly
di template instance - Untuk menetapkan jaringan lama ke VM:
compute.networks.use
di project - Untuk menentukan alamat IP statis untuk VM:
compute.addresses.use
di project - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama:
compute.networks.useExternalIp
di project - Untuk menentukan subnet bagi VM:
compute.subnetworks.use
pada project atau pada subnet yang dipilih - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC:
compute.subnetworks.useExternalIp
di project atau di subnet yang dipilih - Untuk menetapkan metadata instance VM untuk VM:
compute.instances.setMetadata
di project - Untuk menyetel tag untuk VM:
compute.instances.setTags
di VM - Untuk menyetel label VM:
compute.instances.setLabels
di VM - Untuk menyetel akun layanan yang akan digunakan VM:
compute.instances.setServiceAccount
di VM - Untuk membuat disk baru untuk VM:
compute.disks.create
di project - Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis:
compute.disks.use
pada disk - Untuk memasang disk yang ada dalam mode hanya baca:
compute.disks.useReadOnly
pada disk
-
Untuk membuat pemesanan:
compute.reservations.create
pada project -
Untuk membuat template instance:
compute.instanceTemplates.create
pada project -
Untuk membuat grup instance terkelola (MIG):
compute.instanceGroupManagers.create
pada project -
Untuk melihat detail instance:
compute.instances.get
di project
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Membuat kebijakan penempatan rapat.
Sebelum Anda membuat kebijakan penempatan rapat, pertimbangkan hal berikut:
Jika Anda ingin menerapkan kebijakan penempatan rapat ke instance komputasi selain N2 atau N2D, sebaiknya tentukan nilai jarak maksimum.
Anda hanya dapat menerapkan kebijakan penempatan yang ringkas ke instance A4 atau A3 Ultra yang di-deploy menggunakan fitur yang disediakan oleh Cluster Director. Untuk mengetahui informasi selengkapnya, lihat Cluster Director di dokumentasi AI Hypercomputer.
Secara default, Anda tidak dapat menerapkan kebijakan penempatan rapat dengan nilai jarak maksimum ke instance A3 Mega, A3 High, atau A3 Edge. Untuk meminta akses ke fitur ini, hubungi Manajer Akun Teknis (TAM) yang ditugaskan atau tim Penjualan.
Untuk membuat kebijakan penempatan rapat, pilih salah satu opsi berikut:
gcloud
Untuk menerapkan kebijakan penempatan ringkas ke instance N2 atau N2D, buat kebijakan menggunakan perintah
gcloud compute resource-policies create group-placement
dengan flag--collocation=collocated
.gcloud compute resource-policies create group-placement POLICY_NAME \ --collocation=collocated \ --region=REGION
Ganti kode berikut:
POLICY_NAME
: nama kebijakan penempatan ringkas.REGION
: region tempat membuat kebijakan penempatan.
Untuk menerapkan kebijakan penempatan ringkas ke instance lain yang didukung, buat kebijakan menggunakan perintah
gcloud beta compute resource-policies create group-placement
dengan flag--collocation=collocated
dan--max-distance
.gcloud beta compute resource-policies create group-placement POLICY_NAME \ --collocation=collocated \ --max-distance=MAX_DISTANCE \ --region=REGION
Ganti kode berikut:
POLICY_NAME
: nama kebijakan penempatan ringkas.MAX_DISTANCE
: konfigurasi jarak maksimum untuk instance Anda. Nilainya harus antara1
, yang menentukan untuk menempatkan instance di rak yang sama untuk latensi jaringan serendah mungkin, dan3
, yang menentukan untuk menempatkan instance di cluster yang berdekatan. Jika Anda ingin menerapkan kebijakan penempatan rapat ke pemesanan, atau ke instance Ultra A4 atau A3, Anda tidak dapat menentukan nilai1
.REGION
: region tempat membuat kebijakan penempatan.
REST
Untuk menerapkan kebijakan penempatan ringkas ke instance N2 atau N2D, buat kebijakan dengan membuat permintaan
POST
ke metoderesourcePolicies.insert
. Dalam isi permintaan, sertakan kolomcollocation
dan tetapkan keCOLLOCATED
.POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies { "name": "POLICY_NAME", "groupPlacementPolicy": { "collocation": "COLLOCATED" } }
Ganti kode berikut:
PROJECT_ID
: ID project tempat Anda ingin membuat kebijakan penempatan.REGION
: region tempat membuat kebijakan penempatan.POLICY_NAME
: nama kebijakan penempatan ringkas.
Untuk menerapkan kebijakan penempatan ringkas ke instance lain yang didukung, buat kebijakan dengan membuat permintaan
POST
ke metodebeta.resourcePolicies.insert
. Dalam isi permintaan, sertakan hal berikut:Kolom
collocation
ditetapkan keCOLLOCATED
.Kolom
maxDistance
.
POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies { "name": "POLICY_NAME", "groupPlacementPolicy": { "collocation": "COLLOCATED", "maxDistance": MAX_DISTANCE } }
Ganti kode berikut:
PROJECT_ID
: ID project tempat Anda ingin membuat kebijakan penempatan.REGION
: region tempat membuat kebijakan penempatan.POLICY_NAME
: nama kebijakan penempatan ringkas.MAX_DISTANCE
: konfigurasi jarak maksimum untuk instance Anda. Nilainya harus antara1
, yang menentukan untuk menempatkan instance di rak yang sama untuk latensi jaringan serendah mungkin, dan3
, yang menentukan untuk menempatkan instance di cluster yang berdekatan. Jika Anda ingin menerapkan kebijakan penempatan rapat ke pemesanan, atau ke instance Ultra A4 atau A3, Anda tidak dapat menentukan nilai1
.
Menerapkan kebijakan penempatan rapat
Anda dapat menerapkan kebijakan penempatan ringkas ke instance komputasi atau grup instance terkelola (MIG) yang ada, atau saat membuat instance, template instance, MIG, atau reservasi instance.
Untuk menerapkan kebijakan penempatan rapat ke resource Compute Engine, pilih salah satu metode berikut:
- Terapkan kebijakan ke instance yang ada.
- Terapkan kebijakan saat membuat instance.
- Terapkan kebijakan saat membuat reservasi.
- Terapkan kebijakan saat membuat template instance.
- Terapkan kebijakan ke instance di MIG.
Setelah menerapkan kebijakan penempatan yang ringkas ke instance, Anda dapat memverifikasi lokasi fisik instance sehubungan dengan instance lain yang menentukan kebijakan penempatan yang sama.
Menerapkan kebijakan ke instance yang ada
Sebelum menerapkan kebijakan penempatan rapat ke instance komputasi yang ada, pastikan hal berikut:
Instance dan kebijakan penempatan rapat harus berada di region yang sama. Misalnya, jika kebijakan penempatan berada di region
us-central1
, instance harus berada di zona dius-central1
. Jika Anda perlu memigrasikan instance ke region lain, lihat Memindahkan instance antar-zona atau region.Instance harus menggunakan seri mesin dan kebijakan pemeliharaan host yang didukung. Jika Anda perlu melakukan perubahan pada instance, lakukan salah satu atau kedua hal berikut:
Jika tidak, penerapan kebijakan penempatan rapat ke instance akan gagal. Jika instance sudah menentukan kebijakan penempatan dan Anda ingin menggantinya, lihat Mengganti kebijakan penempatan di instance.
Untuk menerapkan kebijakan penempatan rapat ke instance yang ada, pilih salah satu opsi berikut:
gcloud
Untuk menerapkan kebijakan penempatan yang ringkas ke instance yang ada, gunakan perintah
gcloud compute instances add-resource-policies
.gcloud compute instances add-resource-policies INSTANCE_NAME \ --resource-policies=POLICY_NAME \ --zone=ZONE
Ganti kode berikut:
INSTANCE_NAME
: nama instance yang ada.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.ZONE
: zona tempat instance berada.
REST
Untuk menerapkan kebijakan penempatan yang ringkas ke instance yang ada, buat permintaan
POST
ke metodeinstances.addResourcePolicies
.POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addResourcePolicies { "resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ] }
Ganti kode berikut:
PROJECT_ID
: ID project tempat kebijakan penempatan ringkas dan instance berada.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance yang ada.REGION
: region tempat kebijakan penempatan yang ringkas berada.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.
Menerapkan kebijakan saat membuat instance
Anda hanya dapat membuat instance komputasi yang menentukan kebijakan penempatan compact di region yang sama dengan kebijakan penempatan.
Untuk membuat instance yang menentukan kebijakan penempatan rapat, pilih salah satu opsi berikut:
gcloud
Untuk membuat instance yang menentukan kebijakan penempatan ringkas, gunakan perintah
gcloud compute instances create
dengan flag--maintenance-policy
dan--resource-policies
.gcloud compute instances create INSTANCE_NAME \ --machine-type=MACHINE_TYPE \ --maintenance-policy=MAINTENANCE_POLICY \ --resource-policies=POLICY_NAME \ --zone=ZONE
Ganti kode berikut:
INSTANCE_NAME
: nama instance yang akan dibuat.MACHINE_TYPE
: jenis mesin yang didukung untuk kebijakan penempatan rapat.MAINTENANCE_POLICY
: kebijakan pemeliharaan host instance. Jika kebijakan penempatan rapat yang Anda tentukan menggunakan nilai jarak maksimum1
atau2
, atau jenis mesin yang Anda pilih tidak mendukung migrasi langsung, Anda hanya dapat menentukanTERMINATE
. Jika tidak, Anda dapat menentukanMIGRATE
atauTERMINATE
.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.ZONE
: zona tempat instance akan dibuat.
REST
Untuk membuat instance yang menentukan kebijakan penempatan ringkas, buat permintaan
POST
ke metodeinstances.insert
. Dalam isi permintaan, sertakan kolomonHostMaintenance
danresourcePolicies
.POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ], "scheduling": { "onHostMaintenance": "MAINTENANCE_POLICY" } }
Ganti kode berikut:
PROJECT_ID
: ID project tempat kebijakan penempatan ringkas berada.ZONE
: zona tempat instance akan dibuat dan tempat jenis mesin berada. Anda hanya dapat menentukan zona di region kebijakan penempatan compact.INSTANCE_NAME
: nama instance yang akan dibuat.MACHINE_TYPE
: jenis mesin yang didukung untuk kebijakan penempatan rapat.IMAGE_PROJECT
: project gambar yang berisi gambar—misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
REGION
: region tempat kebijakan penempatan yang ringkas berada.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.MAINTENANCE_POLICY
: kebijakan pemeliharaan host instance. Jika kebijakan penempatan rapat yang Anda tentukan menggunakan nilai jarak maksimum1
atau2
, atau jenis mesin yang Anda pilih tidak mendukung migrasi langsung, Anda hanya dapat menentukanTERMINATE
. Jika tidak, Anda dapat menentukanMIGRATE
atauTERMINATE
.
Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat instance, lihat Membuat dan memulai instance.
Menerapkan kebijakan saat membuat reservasi
Jika Anda ingin membuat pemesanan project tunggal sesuai permintaan yang menentukan kebijakan penempatan rapat, Anda harus membuat pemesanan yang ditargetkan secara khusus. Saat membuat instance untuk menggunakan reservasi, pastikan hal berikut:
Instance harus menentukan kebijakan penempatan compact yang sama yang diterapkan pada pemesanan.
Instance harus secara khusus menargetkan reservasi untuk menggunakannya. Untuk informasi selengkapnya, lihat Menggunakan instance dari reservasi tertentu.
Untuk membuat pemesanan satu project dengan kebijakan penempatan rapat, pilih salah satu metode berikut:
Buat reservasi dengan menentukan properti secara langsung seperti yang dijelaskan di bagian ini.
Terapkan kebijakan saat membuat template instance seperti yang dijelaskan dalam dokumen ini, lalu buat pemesanan satu project dengan menentukan template instance yang baru dibuat.
Untuk membuat pemesanan satu project dengan kebijakan penempatan rapat dengan menentukan properti secara langsung, pilih salah satu opsi berikut:
gcloud
Untuk membuat pemesanan satu project dengan kebijakan penempatan rapat dengan menentukan properti secara langsung, gunakan perintah
gcloud compute reservations create
dengan flag--require-specific-reservation
dan--resource-policies=policy
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --require-specific-reservation \ --resource-policies=policy=POLICY_NAME \ --vm-count=NUMBER_OF_INSTANCES \ --zone=ZONE
Ganti kode berikut:
RESERVATION_NAME
: nama pemesanan.MACHINE_TYPE
: jenis mesin yang didukung untuk kebijakan penempatan rapat.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.NUMBER_OF_INSTANCES
: jumlah instance yang akan dicadangkan, yang tidak boleh lebih tinggi dari jumlah maksimum instance yang didukung dari kebijakan penempatan ringkas yang ditentukan.ZONE
: zona tempat memesan instance. Anda hanya dapat memesan instance di zona dalam region kebijakan penempatan ringkas yang ditentukan.
REST
Untuk membuat pemesanan satu project dengan kebijakan penempatan rapat dengan menentukan properti secara langsung, buat permintaan
POST
ke metodereservations.insert
. Dalam isi permintaan, sertakan kolomresourcePolicies
, dan kolomspecificReservationRequired
yang ditetapkan ketrue
.POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "resourcePolicies": { "policy" : "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" }, "specificReservation": { "count": "NUMBER_OF_INSTANCES", "instanceProperties": { "machineType": "MACHINE_TYPE", } }, "specificReservationRequired": true }
Ganti kode berikut:
PROJECT_ID
: ID project tempat kebijakan penempatan ringkas berada.ZONE
: zona tempat memesan instance. Anda hanya dapat memesan instance di zona dalam region kebijakan penempatan ringkas yang ditentukan.RESERVATION_NAME
: nama pemesanan.REGION
: region tempat kebijakan penempatan yang ringkas berada.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.NUMBER_OF_INSTANCES
: jumlah instance yang akan dicadangkan, yang tidak boleh lebih tinggi dari jumlah maksimum instance yang didukung dari kebijakan penempatan ringkas yang ditentukan.MACHINE_TYPE
: jenis mesin yang didukung untuk kebijakan penempatan rapat.
Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat pemesanan project tunggal, lihat Membuat pemesanan untuk satu project.
Menerapkan kebijakan saat membuat template instance
Jika ingin membuat template instance regional, Anda harus membuat template di region yang sama dengan kebijakan penempatan compact. Jika tidak, pembuatan template instance akan gagal.
Setelah membuat template instance yang menentukan kebijakan penempatan ringkas, Anda dapat menggunakan template tersebut untuk melakukan hal berikut:
Untuk membuat template instance yang menentukan kebijakan penempatan rapat, pilih salah satu opsi berikut:
gcloud
Untuk membuat template instance yang menentukan kebijakan penempatan ringkas, gunakan perintah
gcloud compute instance-templates create
dengan flag--maintenance-policy
dan--resource-policies
.Misalnya, untuk membuat template instance global yang menentukan kebijakan penempatan ringkas, jalankan perintah berikut:
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --machine-type=MACHINE_TYPE \ --maintenance-policy=MAINTENANCE_POLICY \ --resource-policies=POLICY_NAME
Ganti kode berikut:
INSTANCE_TEMPLATE_NAME
: nama template instance.MACHINE_TYPE
: jenis mesin yang didukung untuk kebijakan penempatan rapat.MAINTENANCE_POLICY
: kebijakan pemeliharaan host instance. Jika kebijakan penempatan rapat yang Anda tentukan menggunakan nilai jarak maksimum1
atau2
, atau jenis mesin yang Anda pilih tidak mendukung migrasi langsung, Anda hanya dapat menentukanTERMINATE
. Jika tidak, Anda dapat menentukanMIGRATE
atauTERMINATE
.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.
REST
Untuk membuat template instance yang menentukan kebijakan penempatan ringkas, buat permintaan
POST
ke salah satu metode berikut:Untuk membuat template instance global: Metode
instanceTemplates.insert
.Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
.
Dalam isi permintaan, sertakan kolom
onHostMaintenance
danresourcePolicies
.Misalnya, untuk membuat template instance global yang menentukan kebijakan penempatan ringkas, buat permintaan
POST
sebagai berikut:POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/global/instanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "machineType": "MACHINE_TYPE", "networkInterfaces": [ { "network": "global/networks/default" } ], "resourcePolicies": [ "POLICY_NAME" ], "scheduling": { "onHostMaintenance": "MAINTENANCE_POLICY" } } }
Ganti kode berikut:
PROJECT_ID
: ID project tempat kebijakan penempatan ringkas berada.INSTANCE_TEMPLATE_NAME
: nama template instance.IMAGE_PROJECT
: project gambar yang berisi gambar—misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
MACHINE_TYPE
: jenis mesin yang didukung untuk kebijakan penempatan rapat.POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.MAINTENANCE_POLICY
: kebijakan pemeliharaan host instance. Jika kebijakan penempatan rapat yang Anda tentukan menggunakan nilai jarak maksimum1
atau2
, atau jenis mesin yang Anda pilih tidak mendukung migrasi langsung, Anda hanya dapat menentukanTERMINATE
. Jika tidak, Anda dapat menentukanMIGRATE
atauTERMINATE
.
Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat template instance, lihat Membuat template instance.
Menerapkan kebijakan ke instance di MIG
Setelah membuat template instance yang menentukan kebijakan penempatan rapat, Anda dapat menggunakan template tersebut untuk melakukan hal berikut:
Menerapkan kebijakan saat membuat MIG
Anda hanya dapat membuat instance komputasi yang menentukan kebijakan penempatan compact jika instance berada di region yang sama dengan kebijakan penempatan.
Untuk membuat MIG menggunakan template instance yang menentukan kebijakan penempatan ringkas, pilih salah satu opsi berikut:
gcloud
Untuk membuat MIG menggunakan template instance yang menentukan kebijakan penempatan ringkas, gunakan perintah
gcloud compute instance-groups managed create
.Misalnya, untuk membuat MIG zona menggunakan template instance global yang menentukan kebijakan penempatan ringkas, jalankan perintah berikut:
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --size=SIZE \ --template=INSTANCE_TEMPLATE_NAME \ --zone=ZONE
Ganti kode berikut:
INSTANCE_GROUP_NAME
: nama MIG yang akan dibuat.SIZE
: ukuran MIG.INSTANCE_TEMPLATE_NAME
: nama template instance global yang ada dan menentukan kebijakan penempatan yang ringkas.ZONE
: zona tempat membuat MIG, yang harus berada di region tempat kebijakan penempatan yang ringkas berada.
REST
Untuk membuat MIG menggunakan template instance yang menentukan kebijakan penempatan ringkas, buat permintaan
POST
ke salah satu metode berikut:Untuk membuat MIG zona: metode
instanceGroupManagers.insert
.Untuk membuat MIG regional: metode
regionInstanceGroupManagers.insert
.
Misalnya, untuk membuat MIG zona menggunakan template instance global yang menentukan kebijakan penempatan ringkas, buat permintaan
POST
sebagai berikut:POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "name": "INSTANCE_GROUP_NAME", "targetSize": SIZE, "versions": [ { "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME" } ] }
Ganti kode berikut:
PROJECT_ID
: ID project tempat kebijakan penempatan ringkas dan template instance yang menentukan kebijakan penempatan berada.ZONE
: zona tempat membuat MIG, yang harus berada di region tempat kebijakan penempatan yang ringkas berada.INSTANCE_GROUP_NAME
: nama MIG yang akan dibuat.INSTANCE_TEMPLATE_NAME
: nama template instance global yang ada dan menentukan kebijakan penempatan yang ringkas.SIZE
: ukuran MIG.
Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk membuat MIG, lihat Skenario dasar untuk membuat MIG.
Menerapkan kebijakan ke MIG yang ada
Anda hanya dapat menerapkan kebijakan penempatan yang ringkas ke MIG yang ada jika MIG tersebut berada di region yang sama dengan kebijakan penempatan atau, untuk MIG zona, di zona dalam region yang sama dengan kebijakan penempatan.
Untuk memperbarui MIG agar menggunakan template instance yang menentukan kebijakan penempatan ringkas, pilih salah satu opsi berikut:
gcloud
Untuk memperbarui MIG agar menggunakan template instance yang menentukan kebijakan penempatan ringkas, gunakan perintah
gcloud compute instance-groups managed rolling-action start-update
.Misalnya, untuk memperbarui MIG zonal agar menggunakan template instance yang menentukan kebijakan penempatan ringkas, dan mengganti instance yang ada dari MIG dengan instance baru yang menentukan properti template, jalankan perintah berikut:
gcloud compute instance-groups managed rolling-action start-update MIG_NAME \ --version=template=INSTANCE_TEMPLATE_NAME \ --zone=ZONE
Ganti kode berikut:
MIG_NAME
: nama MIG yang ada.INSTANCE_TEMPLATE_NAME
: nama template instance global yang ada dan menentukan kebijakan penempatan yang ringkas.ZONE
: zona tempat MIG berada. Anda hanya dapat menerapkan kebijakan penempatan yang ringkas ke MIG yang berada di region yang sama dengan kebijakan penempatan.
REST
Untuk memperbarui MIG agar menggunakan template instance yang menentukan kebijakan penempatan ringkas, dan otomatis menerapkan properti template serta kebijakan penempatan ke instance yang ada di MIG, buat permintaan
PATCH
ke salah satu metode berikut:Untuk mengupdate MIG zona: metode
instanceGroupManagers.insert
.Untuk memperbarui MIG regional: metode
regionInstanceGroupManagers.insert
.
Misalnya, untuk memperbarui MIG zonal agar menggunakan template instance global yang menentukan kebijakan penempatan ringkas, dan mengganti instance yang ada dari MIG dengan instance baru yang menentukan properti template, buat permintaan
PATCH
berikut:PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME" }
Ganti kode berikut:
PROJECT_ID
: ID project tempat MIG, kebijakan penempatan ringkas, dan template instance yang menentukan kebijakan penempatan berada.ZONE
: zona tempat MIG berada. Anda hanya dapat menerapkan kebijakan penempatan yang ringkas ke MIG yang berada di region yang sama dengan kebijakan penempatan.MIG_NAME
: nama MIG yang ada.INSTANCE_TEMPLATE_NAME
: nama template instance global yang ada dan menentukan kebijakan penempatan yang ringkas.
Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi untuk mengupdate instance di MIG, lihat Mengupdate dan menerapkan konfigurasi baru ke instance di MIG.
Memverifikasi lokasi fisik instance
Setelah menerapkan kebijakan penempatan yang ringkas ke instance komputasi, Anda dapat melihat lokasi fisik instance tersebut sehubungan dengan instance lain. Perbandingan ini terbatas pada instance yang berada di project Anda dan yang menentukan kebijakan penempatan ringkas yang sama. Melihat lokasi fisik instance membantu Anda melakukan tindakan berikut:
Pastikan kebijakan berhasil diterapkan.
Identifikasi instance mana yang paling berdekatan.
Untuk melihat lokasi fisik instance sehubungan dengan instance lain yang menentukan kebijakan penempatan rapat yang sama, pilih salah satu opsi berikut:
gcloud
Untuk melihat lokasi fisik instance yang menentukan kebijakan penempatan ringkas, gunakan perintah
gcloud compute instances describe
dengan flag--format
.gcloud compute instances describe INSTANCE_NAME \ --format="table[box,title=VM-Position](resourcePolicies.scope():sort=1,resourceStatus.physicalHost:label=location)" \ --zone=ZONE
Ganti kode berikut:
INSTANCE_NAME
: nama instance yang ada, yang menentukan kebijakan penempatan yang ringkas.ZONE
: zona tempat instance berada.
Outputnya mirip dengan hal berikut ini:
VM-Position RESOURCE_POLICIES: us-central1/resourcePolicies/example-policy'] PHYSICAL_HOST: /CCCCCCC/BBBBBB/AAAA
Nilai untuk kolom
PHYSICAL_HOST
terdiri dari tiga bagian. Setiap bagian ini mewakili cluster, rak, dan host tempat instance berada.Saat membandingkan posisi dua instance yang menggunakan kebijakan penempatan ringkas yang sama dalam project Anda, makin banyak bagian kolom
PHYSICAL_HOST
yang digunakan bersama oleh instance, makin dekat lokasi fisiknya satu sama lain. Misalnya, asumsikan bahwa dua instance menentukan salah satu nilai contoh berikut untuk kolomPHYSICAL_HOST
:/CCCCCCC/xxxxxx/xxxx
: kedua instance ditempatkan dalam cluster yang sama, yang sama dengan nilai jarak maksimum2
. Instance yang ditempatkan di cluster yang sama akan mengalami latensi jaringan yang rendah./CCCCCCC/BBBBBB/xxxx
: kedua instance ditempatkan di rak yang sama, yang sama dengan nilai jarak maksimum1
. Instance yang ditempatkan di rak yang sama akan mengalami latensi jaringan yang lebih rendah daripada instance yang ditempatkan di cluster yang sama./CCCCCCC/BBBBBB/AAAA
: kedua instance berbagi host yang sama. Instance yang ditempatkan di host yang sama akan meminimalkan latensi jaringan serendah mungkin.
REST
Untuk melihat lokasi fisik instance yang menentukan kebijakan penempatan ringkas, buat permintaan
GET
ke metodeinstances.get
.GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Ganti kode berikut:
PROJECT_ID
: ID project tempat instance berada.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance yang ada, yang menentukan kebijakan penempatan yang ringkas.
Outputnya mirip dengan hal berikut ini:
{ ... "resourcePolicies": [ "https://www.s3nsapis.fr/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy" ], "resourceStatus": { "physicalHost": "/xxxxxxxx/xxxxxx/xxxxx" }, ... }
Nilai untuk kolom
physicalHost
terdiri dari tiga bagian. Setiap bagian ini mewakili cluster, rak, dan host tempat instance berada.Saat membandingkan posisi dua instance yang menggunakan kebijakan penempatan ringkas yang sama dalam project Anda, makin banyak bagian kolom
physicalHost
yang digunakan bersama oleh instance, makin dekat lokasi fisiknya satu sama lain. Misalnya, asumsikan bahwa dua instance menentukan salah satu nilai contoh berikut untuk kolomphysicalHost
:/CCCCCCC/xxxxxx/xxxx
: kedua instance ditempatkan dalam cluster yang sama, yang sama dengan nilai jarak maksimum2
. Instance yang ditempatkan di cluster yang sama akan mengalami latensi jaringan yang rendah./CCCCCCC/BBBBBB/xxxx
: kedua instance ditempatkan di rak yang sama, yang sama dengan nilai jarak maksimum1
. Instance yang ditempatkan di rak yang sama akan mengalami latensi jaringan yang lebih rendah daripada instance yang ditempatkan di cluster yang sama./CCCCCCC/BBBBBB/AAAA
: kedua instance berbagi host yang sama. Instance yang ditempatkan di host yang sama akan meminimalkan latensi jaringan serendah mungkin.
Apa langkah selanjutnya?
Pelajari cara melihat kebijakan penempatan.
Pelajari cara mengganti, meniadakan, atau menghapus kebijakan penempatan.
Pelajari cara melakukan hal berikut dengan instance compute yang menentukan kebijakan penempatan:
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-18 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-18 UTC."],[[["Compact placement policies reduce network latency by physically placing VMs closer together, beneficial for high-performance computing, machine learning, and database workloads."],["Creating a compact placement policy involves using specific `gcloud` commands or REST API methods, and can optionally include a maximum distance parameter to control VM proximity."],["Compact placement policies can be applied to existing VMs, during VM creation, in bulk VM creation, while creating reservations, or when defining instance templates for managed instance groups (MIGs)."],["To apply a compact placement policy to an existing VM, it must be in the same region as the policy, use a supported machine series, and its host maintenance policy might need adjustments."],["You can verify a VM's physical location relative to other VMs with the same policy to confirm the policy's application and to identify the proximity of VMs to one another."]]],[]] -