Menggabungkan dan memisahkan komitmen


Guna membantu Anda mengelola persyaratan resource untuk project, Compute Engine memungkinkan Anda menggabungkan atau membagi komitmen yang ada dan mendistribusikan ulang resource agar sesuai dengan tingkat perincian yang diperlukan untuk project.

Dokumen ini menjelaskan manfaat dan proses penggabungan serta pemisahan komitmen, beserta batasan dan persyaratan yang berlaku.

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init
    2. Menetapkan region dan zona default.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init

Menggabungkan komitmen

Anda dapat menggabungkan beberapa komitmen yang kompatibel untuk membuat komitmen baru yang lebih besar. Dengan menggabungkan komitmen, Anda dapat melacak dan mengelolanya sebagai satu entitas. Menggabungkan komitmen membantu Anda menghindari tanggal habis masa berlaku komitmen yang berbeda-beda dengan menggabungkan komitmen individu agar masa berlakunya berakhir pada waktu yang sama. Penggabungan juga memungkinkan Anda meningkatkan beban kerja secara bertahap. Misalnya, Anda dapat membeli komitmen yang lebih baru dan lebih kecil jika diperlukan dan memilih untuk menggabungkannya bersama atau dengan komitmen yang sudah ada.

Batasan untuk penggabungan

  • Anda tidak dapat menggabungkan komitmen lisensi.
  • Pada saat membuat komitmen gabungan, Anda tidak dapat membuat pemesanan baru dan melampirkannya ke komitmen tersebut.
  • Anda tidak dapat menggabungkan komitmen yang telah habis masa berlakunya atau dibatalkan.
  • Secara default, saat Anda membuat komitmen gabungan, setelan perpanjangan otomatis akan dinonaktifkan pada komitmen baru meskipun semua komitmen sumber disetel untuk diperpanjang secara otomatis. Jika ingin komitmen gabungan diperpanjang secara otomatis, Anda harus mengaktifkan setelan perpanjangan otomatis pada komitmen tersebut secara manual. Anda dapat melakukannya pada saat pembuatan atau setelah pembuatan.

Cara kerja penggabungan

Jika menggabungkan komitmen individu (komitmen sumber), Anda akan membuat komitmen baru (komitmen gabungan) dengan resource gabungan dari semua komitmen sumber. Pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas) pada hari berikutnya, komitmen gabungan akan aktif dan komitmen sumber dibatalkan. Tanggal aktivasi ini menjadi tanggal mulai untuk komitmen gabungan dan operasi penggabungan berakhir.

Compute Engine menetapkan tanggal habis masa berlaku untuk komitmen gabungan pada tanggal habis masa berlaku mana pun di antara komitmen sumber yang paling jauh di masa mendatang. Misalnya, jika Anda memiliki dua komitmen sumber dan masing-masing masa berlakunya berakhir pada 1 Januari 2023 dan 1 Desember 2023, komitmen gabungan akan berakhir masa berlakunya pada 1 Desember 2023.

Jika salah satu komitmen sumber memiliki pemesanan yang terlampir, pemesanan itu akan dipertahankan selama penggabungan dan dilampirkan ke komitmen gabungan setelah dibuat. Untuk mempelajari lebih lanjut komitmen dengan reservasi terlampir, lihat Melampirkan reservasi ke komitmen berbasis resource.

Implikasi harga untuk penggabungan

Biaya komitmen adalah jumlah harga diskon dari semua alokasi resource Anda. Jika Anda menggabungkan komitmen, harga diskon untuk resource komitmen gabungan dapat berubah pada hari komitmen gabungan Anda aktif. Harga diskon baru untuk setiap resource ini tetap sama hingga akhir masa berlaku komitmen gabungan, meskipun harga on-demand berubah. Namun, jika Anda menggabungkan atau memisahkan komitmen ini lagi di masa mendatang, harga diskon resource dapat berubah lagi.

Contoh komitmen gabungan

Tabel berikut menunjukkan properti sumber dan komitmen gabungan dalam skenario di mana dua komitmen (source-commitment-1 dan source-commitment-2) digabungkan menjadi satu komitmen (merged-commitment) pada March 1, 2022.

Komitmen sumber pertama
(sebelum penggabungan)
Komitmen sumber kedua
(sebelum penggabungan)
Komitmen gabungan
Name komitmen-sumber-1 komitmen-sumber-2 komitmen gabungan
Type N2 N2 N2
Region us-central-1 us-central-1 us-central-1
Referensi
  • vCPU: 100
  • Memori: 100 GB
  • vCPU: 200
  • Memori: 300 GB
  • vCPU: 300
  • Memori: 400 GB
Masa Berlaku 3 tahun 3 tahun 3 tahun
Tanggal mulai* 1 Januari 2020 1 Desember 2020 2 Maret 2022
(hari setelah penggabungan)
Tanggal akhir 1 Januari 2023 1 Desember 2023 1 Desember 2023

*Semua komitmen dimulai pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7) pada tanggal mulai yang ditentukan.
Semua komitmen berakhir pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7) pada tanggal akhir yang ditentukan.

Persyaratan penggabungan

Saat Anda menggabungkan komitmen sumber individu untuk membuat komitmen gabungan yang baru, komitmen sumber dan gabungan Anda harus memenuhi persyaratan berikut:

  • Komitmen sumber harus memiliki project, region, durasi (atau masa berlaku), jenis komitmen, dan kategori komitmen yang sama.
  • Komitmen gabungan yang baru harus memiliki project, region, durasi (atau masa berlaku), jenis komitmen, dan kategori komitmen yang sama dengan komitmen sumber. Namun, Anda dapat memilih nama baru untuk komitmen gabungan.
  • Jenis resource yang ditentukan untuk komitmen gabungan harus sama persis dengan jenis resource yang ada dalam komitmen sumber. Selain itu, jumlah resource untuk setiap jenis resource dalam komitmen gabungan baru Anda harus sama dengan total jumlah resource untuk jenis resource tersebut di semua komitmen sumber. Misalnya, jika komitmen sumber pertama memiliki 100 vCPU dan 100 GB memori sedangkan komitmen sumber kedua memiliki 200 vCPU dan 300 GB memori, Anda harus membuat komitmen gabungan dengan 300 vCPU dan 400 GB memori.
  • Komitmen sumber dan gabungan harus ditujukan untuk resource hardware (vCPU, memori, GPU, dan disk SSD Lokal).

Membuat komitmen gabungan

Buat komitmen gabungan menggunakan gcloud CLI atau Compute Engine API. Sebelum menggabungkan komitmen, tinjau batasan untuk menggabungkan.

Konsol

  1. Di Konsol Google Cloud, pilih project tempat Anda ingin menggabungkan komitmen dan buka halaman Committed use discounts.

    Buka halaman Committed use discounts

  2. Untuk memulai operasi penggabungan pada sekumpulan komitmen, di tab Hardware commitments di halaman Commitment list, klik Merge.

    Atau, Anda juga dapat memilih komitmen yang ingin digabungkan dari daftar, lalu mengklik Merge.

  3. Pada tab Choose commitment di halaman Merge yang terbuka, lakukan hal berikut:

    1. Di bagian Choose commitments to merge, pilih komitmen yang ingin Anda gabungkan dari daftar. Jika Anda sudah memilih komitmen ini di halaman Commitment list, verifikasi komitmen yang Anda pilih di tab ini.

      Opsional: Anda juga dapat menentukan nilai Plan, Region, dan Commitment type yang diinginkan untuk komitmen gabungan Anda sebelum memilih komitmen individual yang akan digabungkan. Tindakan ini akan memfilter daftar komitmen agar hanya menampilkan komitmen yang dapat Anda gabungkan untuk atribut yang ditentukan.

    2. Klik Next. Tab Review akan terbuka.

  4. Pada tab Review di halaman Merge, lakukan hal berikut:

    1. Tinjau dan konfirmasi detail komitmen gabungan. Untuk mengubah daftar komitmen individual yang ingin digabungkan, pilih tab Choose commitment di sisi kiri jendela, lalu ulangi langkah 3.
    2. Di kolom New commitment name, masukkan nama untuk komitmen gabungan Anda.
    3. Opsional: Untuk mengaktifkan perpanjangan otomatis di komitmen gabungan Anda, centang kotak Enable auto renew.
    4. Baca Terms and conditions.
    5. Untuk menyelesaikan pembuatan komitmen gabungan dan kembali ke halaman Commitment list, klik Merge.

gcloud

Untuk menggabungkan komitmen yang ada menjadi satu komitmen, gunakan perintah pembuatan komitmen komputasi gcloud dengan flag --merge-source-commitment.

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --merge-source-commitments=SOURCE_COMMITMENT_URLS

Ganti kode berikut:

  • COMMITMENT_NAME: nama komitmen gabungan baru Anda.
  • NUMBER_VCPUS: total jumlah vCPU dalam komitmen sumber.
  • COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, salah satu dari pilihan berikut:
    • general-purpose untuk komitmen jenis mesin N1 tujuan umum
    • general-purpose-n2 untuk komitmen jenis mesin N2 tujuan umum
    • general-purpose-e2 untuk komitmen jenis mesin E2 tujuan umum
    • general-purpose-n2d untuk komitmen jenis mesin N2D tujuan umum
    • general-purpose-t2d untuk komitmen jenis mesin Tau T2D tujuan umum
    • storage-optimized-z3 untuk komitmen jenis mesin Z3 yang dioptimalkan untuk penyimpanan
    • compute-optimized untuk komitmen jenis mesin C2 yang dioptimalkan untuk komputasi
    • compute-optimized-c2d untuk komitmen jenis mesin C2D yang dioptimalkan untuk komputasi
    • memory-optimized untuk komitmen jenis mesin M1 atau M2 yang dioptimalkan untuk memori
    • accelerator-optimized untuk komitmen jenis mesin A2 yang dioptimalkan untuk akselerator
    • accelerator-optimized-a3 untuk komitmen jenis mesin A3 yang dioptimalkan akselerator
    • graphics-optimized untuk komitmen jenis mesin G2 yang dioptimalkan untuk akselerator
  • REGION: region yang sama dengan komitmen sumber.
  • PROJECT_ID: project ID dari project yang komitmennya ingin Anda gabungkan.
  • DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, 12-month atau 36-month.
  • MEMORY: total jumlah, dalam MB atau GB, memori dalam komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah GB.
  • SOURCE_COMMITMENT_URLS: Tentukan daftar URL komitmen sumber yang berbeda, yang memisahkan setiap URL dengan koma. Jangan tambahkan spasi kosong di antara URL. Dalam daftar, Anda harus menentukan setidaknya dua URL komitmen sumber.

Misalnya, pertimbangkan dua komitmen sumber di region us-east1 dengan resource-nya masing-masing (4 vCPU N2 dan 2048 MB) serta (3 vCPU N2 dan 2048 MB). Durasi setiap komitmen sumber adalah 12 bulan. Perintah gcloud CLI berikut menggabungkan kedua komitmen dan membuat komitmen baru yang disebut merged-commitment, dengan resource-nya sebagai 7 N2 vCPU dan 4096 MB serta durasinya 12 bulan:

gcloud compute commitments create merged-commitment \
    --plan=12-month \
    --project=myproject \
    --region=us-east1 \
    --type=general-purpose-n2 \
    --resources=vcpu=7,memory=4096MB \
     --merge-source-commitments=projects/myproject/regions/us-central1/commitments/source-commitment-1,projects/myproject/regions/us-central1/commitments/source-commitment-2

API

Untuk menggabungkan komitmen yang ada menjadi satu komitmen, gunakan metode regionCommitments.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
  "name": COMMITMENT_NAME,
  "plan": DURATION,
  "type": COMMITMENT_TYPE,
  "region": REGION,
  "resources": [
    {
      "type": "vCPUs",
      "amount": NUMBER_VCPUS
    }
    {
      "type": "MEMORY",
      "amount": MEMORY
    }
  ],
  "mergeSourceCommitments": [SOURCE_COMMITMENT_URL ...]
}

Ganti kode berikut:

  • PROJECT_ID: project ID dari project yang komitmennya ingin Anda gabungkan.
  • REGION: region yang sama dengan komitmen sumber.
  • COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, salah satu dari pilihan berikut:
    • GENERAL_PURPOSE untuk komitmen jenis mesin N1 tujuan umum
    • GENERAL_PURPOSE_N2 untuk komitmen jenis mesin N2 tujuan umum
    • GENERAL_PURPOSE_E2 untuk komitmen jenis mesin E2 tujuan umum
    • GENERAL_PURPOSE_N2D untuk komitmen jenis mesin N2D tujuan umum
    • GENERAL_PURPOSE_T2D untuk komitmen jenis mesin Tau T2D tujuan umum
    • STORAGE_OPTIMIZED_Z3 untuk komitmen jenis mesin Z3 yang dioptimalkan untuk penyimpanan
    • COMPUTE_OPTIMIZED untuk komitmen jenis mesin C2 yang dioptimalkan untuk komputasi
    • COMPUTE_OPTIMIZED_C2D untuk komitmen jenis mesin C2D yang dioptimalkan untuk komputasi
    • MEMORY_OPTIMIZED untuk komitmen jenis mesin M1 atau M2 yang dioptimalkan untuk memori
    • ACCELERATOR_OPTIMIZED untuk komitmen jenis mesin A2 yang dioptimalkan untuk akselerator
    • ACCELERATOR_OPTIMIZED_A3 untuk komitmen jenis mesin A3 yang dioptimalkan akselerator
    • GRAPHICS_OPTIMIZED untuk komitmen jenis mesin G2 yang dioptimalkan untuk akselerator
  • DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, TWELVE_MONTH atau THIRTY_SIX_MONTH.
  • COMMITMENT_NAME: nama komitmen gabungan baru Anda.
  • NUMBER_VCPUS: total jumlah vCPU dalam komitmen sumber.
  • MEMORY: total jumlah, dalam MB, memori di komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah MB.
  • SOURCE_COMMITMENT_URL: URL komitmen sumber yang ingin Anda gabungkan. Anda harus menentukan daftar yang dipisahkan koma untuk URL komitmen sumber yang berbeda.

Misalnya, pertimbangkan dua komitmen sumber (source-commitment-1 dan source-commitment-2) di region us-east1 dengan resource-nya masing-masing sebagai (4 vCPU N2 dan 2048 MB) serta (3 vCPU N2 dan 2048 MB). Permintaan POST berikut menggabungkan source-commitment-1 dan source-commitment-2 menjadi satu komitmen yang disebut merged-commitment:

POST https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments
{
  "name": "merged-commitment",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE_N2",
  "region": "us-east1",
   "resources": [
    {
      "type": "VCPU",
      "amount": "7"
    }
    {
      "type": "MEMORY",
      "amount": "4096"
    }
  ],
  "mergeSourceCommitments": [
         "projects/myproject/regions/us-central1/commitments/source-commitment-1",
         "projects/myproject/regions/us-central1/commitments/source-commitment-2",
         ...
    ]
}

Memisahkan komitmen

Anda dapat mentransfer resource dari komitmen yang ada dan memisahkan komitmen menjadi komitmen yang lebih kecil. Dengan pemisahan, Anda dapat memantau dan mengelola sebagian dari satu komitmen besar dalam bentuk komitmen individu yang lebih kecil. Misalnya, Anda hanya dapat menetapkan sebagian komitmen untuk diperpanjang otomatis dengan memisahkannya dan mengaktifkan perpanjangan otomatis hanya untuk salah satu komitmen turunan. Dengan pemisahan, Anda juga dapat mendistribusikan diskon abonemen pada tingkat yang lebih terperinci dengan menggunakan atribusi prioritas untuk komitmen terpisah.

Batasan untuk pemisahan

  • Anda tidak dapat memisahkan komitmen lisensi.
  • Anda tidak dapat memisahkan komitmen yang memiliki reservasi terlampir. Akibatnya, Anda tidak dapat membagi komitmen yang memiliki GPU, disk SSD Lokal, atau keduanya karena komitmen dengan resource ini selalu memiliki reservasi terlampir.
  • Pada saat membuat komitmen terpisah, Anda tidak dapat membuat pemesanan baru dan melampirkannya ke komitmen tersebut.
  • Anda tidak dapat memisahkan komitmen yang telah habis masa berlakunya atau dibatalkan.
  • Secara default, saat Anda membuat komitmen terpisah, setelan perpanjangan otomatis akan dinonaktifkan pada komitmen baru meskipun semua komitmen sumber disetel untuk diperpanjang secara otomatis. Jika ingin komitmen terpisah diperpanjang secara otomatis, Anda harus mengaktifkan setelan perpanjangan otomatis pada komitmen tersebut secara manual. Anda dapat melakukannya pada saat pembuatan atau setelah pembuatan.
  • Anda hanya dapat membuat satu komitmen terpisah baru pada satu waktu menggunakan Compute Engine API atau gcloud CLI.

Cara kerja pemisahan

Saat memisahkan komitmen yang ada (komitmen sumber), Anda mentransfer resource dari komitmen sumber Anda, membuat satu atau beberapa komitmen baru (komitmen terpisah), dan mendistribusikan ulang resource yang ditransfer ke komitmen terpisah baru tersebut. Aktivasi komitmen terpisah baru dan perubahan ukuran komitmen sumber dilakukan pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas) pada hari berikutnya. Compute Engine menetapkan tanggal aktivasi ini sebagai tanggal mulai untuk komitmen pemisahan. Pada penyelesaian operasi pemisahan, Anda memiliki komitmen berikut:

  • Komitmen sumber yang diubah ukurannya dengan resource yang tetap ada setelah pemisahan.
  • Komitmen terpisah yang baru dibuat dengan resource yang didistribusikan ulang.

Komitmen sumber, meskipun diubah ukurannya, mempertahankan semua atribut lain, termasuk tanggal mulai dan habis masa berlakunya, serta terus beroperasi seperti biasa. Tanggal habis masa berlaku komitmen pemisahan tetap sama dengan komitmen sumber.

Anda hanya dapat membuat satu komitmen terpisah baru pada satu waktu menggunakan Compute Engine API dan gcloud CLI. Anda dapat membuat beberapa komitmen terpisah baru dalam satu operasi menggunakan Konsol Google Cloud.

Anda tidak dapat memisahkan komitmen jika memiliki pemesanan yang terlampir. Untuk mempelajari lebih lanjut komitmen dengan pemesanan terlampir, lihat Menggabungkan pemesanan dengan diskon abonemen.

Implikasi harga untuk pemisahan

Biaya komitmen adalah jumlah harga diskon dari semua alokasi resource Anda. Memisahkan komitmen akan memengaruhi biaya resource Anda dengan cara berikut:

  • Komitmen sumber yang diubah ukurannya: Harga diskon resource dari komitmen sumber yang diubah ukurannya tetap sama.
  • Komitmen terpisah: Harga diskon resource komitmen terpisah Anda dapat berubah pada hari komitmen terpisah Anda aktif. Harga diskon baru untuk setiap resource ini tetap sama hingga akhir masa berlaku komitmen terpisah, meskipun harga on-demand berubah.

Namun, jika Anda menggabungkan atau memisahkan salah satu komitmen ini lagi di masa mendatang, harga diskon dapat berubah lagi.

Contoh komitmen terpisah

Tabel berikut menunjukkan properti komitmen saat komitmen yang ada (source-commitment) dipisah menjadi dua komitmen yang berbeda (source-commitment dan split-commitment yang diubah ukurannya) pada 1 Maret 2022:

Komitmen sumber
(sebelum pemisahan)
Komitmen terpisah Komitmen sumber
(setelah pemisahan)
Nama komitmen sumber komitmen-terpisah komitmen sumber
Jenis N2 N2 N2
Region us-central-1 us-central-1 us-central-1
Resource
  • vCPU: 200
  • Memori: 200 GB
  • vCPU: 50
  • Memori: 100 GB
  • vCPU: 150
  • Memori: 100 GB
Masa Berlaku 3 tahun 3 tahun 3 tahun
Tanggal mulai* 1 Januari 2020 2 Maret 2022
(hari setelah pemisahan)
1 Januari 2020
Tanggal akhir 1 Januari 2023 1 Januari 2023 1 Januari 2023

*Semua komitmen dimulai pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7) pada tanggal mulai yang ditentukan.
Semua komitmen berakhir pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7) pada tanggal akhir yang ditentukan.

Persyaratan pemisahan

Jika Anda memisahkan komitmen sumber dan membuat satu atau beberapa komitmen terpisah, komitmen sumber dan komitmen terpisah Anda harus memenuhi persyaratan berikut:

  • Komitmen terpisah baru harus memiliki project, jenis komitmen, region, dan durasi (atau masa berlaku) yang sama dengan komitmen sumber. Namun, Anda harus memilih nama baru untuk komitmen terpisah.
  • Jenis resource yang ditentukan untuk komitmen terpisah baru harus sama persis dengan beberapa atau semua jenis resource di komitmen sumber. Selain itu, jumlah gabungan resource yang Anda tentukan untuk komitmen terpisah baru harus merupakan bagian dari resource dalam komitmen sumber. Anda harus mempertahankan sebagian resource dalam komitmen sumber. Misalnya, anggap saja komitmen sumber Anda adalah untuk 200 vCPU dan 300 GB memori, skenario pengubahan ukuran dan distribusi ulang berikut berlaku:
    • Anda dapat mendistribusikan ulang sebagian dari 200 vCPU dan sebagian dari 300 GB memori ke komitmen terpisah baru.
    • Anda dapat mendistribusikan ulang 200 vCPU seluruhnya, tetapi Anda harus mempertahankan sebagian memori dalam komitmen sumber Anda.
    • Anda dapat mendistribusikan ulang 300 GB memori seluruhnya, tetapi Anda harus mempertahankan sebagian vCPU dalam komitmen sumber Anda.
    • Anda tidak dapat mendistribusikan ulang 200 vCPU dan 300 GB memori seluruhnya ke komitmen terpisah baru
  • Komitmen sumber dan pemisahan harus ditujukan untuk resource hardware yang merupakan vCPU, memori, atau kombinasi keduanya.

Selain itu, agar dapat menggunakan Google Cloud CLI untuk membagi komitmen sumber, update Google Cloud CLI ke versi 423.0.0 atau yang lebih baru. Jika Anda mencoba membagi komitmen sumber menggunakan versi gcloud CLI yang lebih lama, operasi pemisahan akan gagal dan Compute Engine akan menampilkan error.

Membuat komitmen terpisah

Buat satu komitmen terpisah baru dalam satu waktu menggunakan gcloud CLI atau Compute Engine API. Buat beberapa komitmen terpisah baru sekaligus menggunakan Konsol Google Cloud. Sebelum Anda memisahkan komitmen, tinjau batasan untuk pemisahan.

Konsol

  1. Di Konsol Google Cloud, pilih project tempat Anda ingin memisahkan komitmen dan buka halaman Committed use discounts.

    Buka halaman Committed use discounts

  2. Untuk memulai operasi pemisahan pada komitmen, lakukan salah satu hal berikut di tab Hardware commitments di halaman Commitment list:

    • Dari daftar, pilih komitmen yang ingin dipisahkan, lalu klik Split.
    • Di kolom Name, klik nama komitmen yang ingin dipisahkan. Pada halaman Hardware commitment details yang terbuka, klik Split.
  3. Pada tab Resize di halaman Split commitment yang terbuka, lakukan tindakan berikut:

    1. Di kolom vCPUs dan Memory, tentukan jumlah vCPU dan memori yang ingin dipertahankan dalam komitmen awal Anda. Resource yang tersisa dapat didistribusikan ulang ke komitmen terpisah Anda. Resource untuk komitmen sumber tidak boleh kosong setelah Anda mengubah ukurannya.
    2. Klik Next. Tab Redistribute akan terbuka.
  4. Pada tab Redistribute di halaman Split commitment, lakukan hal berikut:

    1. Di kolom Name, tentukan nama untuk komitmen terpisah Anda.
    2. Di kolom vCPUs dan Memory, tentukan jumlah vCPU dan memori yang diinginkan dalam komitmen terpisah Anda.
      • Jika Anda ingin membuat beberapa komitmen terpisah, tentukan sebagian saja dari resource yang didistribusikan ulang.
      • Jika tidak, tentukan semua resource yang didistribusikan ulang.
    3. Opsional: Untuk mengaktifkan perpanjangan otomatis di komitmen terpisah Anda, centang kotak Enable auto renew.
    4. Klik Done.
    5. Opsional: Untuk membuat komitmen terpisah tambahan, klik Add an item, lalu ulangi langkah-langkah sebelumnya.
    6. Klik Next. Tab Review akan terbuka.
  5. Pada tab Review di halaman Split commitment, lakukan hal berikut:

    1. Tinjau dan konfirmasi detail komitmen yang diubah ukurannya dan komitmen terpisah.
      • Untuk mengubah alokasi resource dari komitmen awal, pilih tab Resize di sisi kiri jendela, lalu ulangi langkah 3.
      • Untuk mengubah distribusi ulang resource di komitmen terpisah, pilih tab Redistribute di sisi kiri jendela, lalu ulangi langkah 4.
    2. Baca Terms and conditions.
    3. Untuk menyelesaikan pembuatan komitmen terpisah dan kembali ke halaman Commitment list, klik Submit.

gcloud

Untuk memisahkan komitmen yang ada menjadi dua komitmen, gunakan perintah pembuatan komitmen komputasi gcloud dengan flag --split-source-commitment.

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --split-source-commitment=SOURCE_COMMITMENT_URL

Ganti kode berikut:

  • COMMITMENT_NAME: nama komitmen terpisah baru Anda.
  • COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, dengan salah satu dari hal berikut:
    • general-purpose untuk komitmen jenis mesin N1 tujuan umum
    • general-purpose-n2 untuk komitmen jenis mesin N2 tujuan umum
    • general-purpose-e2 untuk komitmen jenis mesin E2 tujuan umum
    • general-purpose-n2d untuk komitmen jenis mesin N2D tujuan umum
    • general-purpose-t2d untuk komitmen jenis mesin Tau T2D tujuan umum
    • storage-optimized-z3 untuk komitmen jenis mesin Z3 yang dioptimalkan untuk penyimpanan
    • compute-optimized untuk komitmen jenis mesin C2 yang dioptimalkan untuk komputasi
    • compute-optimized-c2d untuk komitmen jenis mesin C2D yang dioptimalkan untuk komputasi
    • memory-optimized untuk komitmen jenis mesin M1 atau M2 yang dioptimalkan untuk memori
    • accelerator-optimized untuk komitmen jenis mesin A2 yang dioptimalkan untuk akselerator
    • accelerator-optimized-a3 untuk komitmen jenis mesin A3 yang dioptimalkan akselerator
    • graphics-optimized untuk komitmen jenis mesin G2 yang dioptimalkan untuk akselerator
  • REGION: region yang sama dengan komitmen sumber Anda.
  • PROJECT_ID: project ID dari project yang komitmen sumbernya ingin Anda pisahkan.
  • DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, 12-month atau 36-month.
  • NUMBER_VCPUS: jumlah vCPU yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Angka harus berupa bilangan bulat yang kurang dari jumlah vCPU dalam komitmen sumber.
  • MEMORY: jumlah memori, dalam MB atau GB, yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Jumlahnya harus lebih kecil dari jumlah memori dalam komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah GB. Memori dapat dibeli dengan kelipatan 0,25 GB.
  • SOURCE_COMMITMENT_URL: URL komitmen sumber tempat Anda ingin mengambil resource.

Misalnya, pertimbangkan komitmen sumber (source-commitment) di region us-east1 dengan 3 vCPU N2 dan memori 2.048 MB. Perintah CLI gcloud berikut membagi komitmen dengan melakukan hal berikut:

  • Mengambil resource dari source-commitment dan membuat komitmen baru split-commitment dengan 1 vCPU N2 dan memori 1024 MB.
  • Mengubah ukuran source-commitment ke resource yang tersisa.
gcloud compute commitments create split-commitment \
    --plan=12-month \
    --type=general-purpose-n2 \
    --region=us-east1 \
    --project=myproject \
    --resources vcpu=1,memory=1024MB \
    --split-source-commitment=projects/myproject/regions/us-central1/commitments/source-commitment

API

Untuk memisahkan komitmen yang ada menjadi dua komitmen, gunakan metode regionCommitments.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
  "name": COMMITMENT_NAME,
  "plan": DURATION,
  "type": COMMITMENT_TYPE,
  "region": REGION,
  "resources": [
    {
      "type": "vCPUs",
      "amount": NUMBER_VCPUS
    }
    {
      "type": "MEMORY",
      "amount": MEMORY
    }
  ],
  "splitSourceCommitment": SOURCE_COMMITMENT_URL
}

Ganti kode berikut:

  • PROJECT_ID: project ID dari project yang komitmen sumbernya ingin Anda pisahkan.
  • REGION: region yang sama dengan komitmen sumber Anda.
  • COMMITMENT_NAME: nama komitmen terpisah baru Anda.
  • COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, dengan salah satu dari hal berikut:
    • GENERAL_PURPOSE untuk komitmen jenis mesin N1 tujuan umum
    • GENERAL_PURPOSE_N2 untuk komitmen jenis mesin N2 tujuan umum
    • GENERAL_PURPOSE_E2 untuk komitmen jenis mesin E2 tujuan umum
    • GENERAL_PURPOSE_N2D untuk komitmen jenis mesin N2D tujuan umum
    • GENERAL_PURPOSE_T2D untuk komitmen jenis mesin Tau T2D tujuan umum
    • STORAGE_OPTIMIZED_Z3 untuk komitmen jenis mesin Z3 yang dioptimalkan untuk penyimpanan
    • COMPUTE_OPTIMIZED untuk komitmen jenis mesin C2 yang dioptimalkan untuk komputasi
    • COMPUTE_OPTIMIZED_C2D untuk komitmen jenis mesin C2D yang dioptimalkan untuk komputasi
    • MEMORY_OPTIMIZED untuk komitmen jenis mesin M1 atau M2 yang dioptimalkan untuk memori
    • ACCELERATOR_OPTIMIZED untuk komitmen jenis mesin A2 yang dioptimalkan untuk akselerator
    • ACCELERATOR_OPTIMIZED_A3 untuk komitmen jenis mesin A3 yang dioptimalkan akselerator
    • GRAPHICS_OPTIMIZED untuk komitmen jenis mesin G2 yang dioptimalkan untuk akselerator
  • DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, TWELVE_MONTH atau THIRTY_SIX_MONTH.
  • NUMBER_VCPUS: jumlah vCPU yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Angka harus berupa bilangan bulat yang kurang dari jumlah vCPU dalam komitmen sumber.
  • MEMORY: jumlah memori, dalam MB, yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Jumlahnya harus lebih kecil dari jumlah memori dalam komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah MB. Memori dapat dibeli dengan kelipatan 0,25 GB.
  • SOURCE_COMMITMENT_URL: URL komitmen sumber tempat Anda ingin mentransfer resource.

Misalnya, pertimbangkan komitmen sumber (source-commitment) di region us-east1 dengan 3 vCPU N2 dan memori 2.048 MB. Permintaan POST berikut membagi komitmen dengan melakukan hal berikut:

  • Mengambil resource dari source-commitment dan membuat komitmen baru split-commitment dengan 1 vCPU N2 dan memori 1024 MB.
  • Mengubah ukuran source-commitment ke resource yang tersisa.
POST https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments
{
  "name": "split-commitment",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE_N2",
  "region": "us-east1",
  "resources": [
    {
      "type": "VCPU",
      "amount": "1"
    }
    {
      "type": "MEMORY",
      "amount": "1024"
    }
  ],
  "splitSourceCommitment": "projects/myproject/regions/us-central1/commitments/source-commitment"
}

Langkah selanjutnya