Menetapkan node ke cluster database menggunakan penjadwalan

Pilih versi dokumentasi:

Di operator AlloyDB Omni Kubernetes, penjadwalan adalah proses untuk mencocokkan Pod database baru dengan node untuk menyeimbangkan distribusi node di seluruh cluster dan membantu mengoptimalkan performa. Pod dan node dicocokkan berdasarkan beberapa kriteria dan resource yang tersedia, seperti CPU dan memori.

Untuk mengetahui informasi selengkapnya tentang penjadwalan, lihat Penjadwalan, Preemption, dan Eviction dalam dokumentasi Kubernetes.

Halaman ini menunjukkan cara menentukan konfigurasi penjadwalan afinitas node dan toleransi untuk instance kumpulan baca dan utama dalam manifes Kubernetes Anda.

Untuk mengetahui informasi tentang cara menentukan taint pada node, lihat Taint dan Toleransi dalam dokumentasi Kubernetes.

Menentukan toleransi

Untuk menjadwalkan Pod AlloyDB Omni ke node yang bebas dari Pod aplikasi lain atau mencocokkan taint tertentu yang ditentukan pada node tersebut, terapkan satu atau beberapa toleransi ke node sebagai berikut:

  1. Ubah manifes cluster operator AlloyDB Omni Kubernetes untuk menyertakan bagian tolerations di bagian schedulingConfig dari salah satu bagian berikut:
    • primarySpec untuk instance utama
    • spec untuk instance kumpulan baca
         tolerations:
      - key: "TAINT_KEY"
        operator: "OPERATOR_VALUE"
        value: "VALUE"
        effect: "TAINT_EFFECT"

    Ganti kode berikut:

    • TAINT_KEY: Nama unik yang ada dari kunci taint seperti nama host node atau nilai lain yang disimpulkan secara lokal yang diterapkan toleransi. Kunci taint sudah ditentukan pada node. Kolom kosong dan OPERATOR_VALUE yang ditetapkan ke exists menandakan bahwa toleransi harus cocok dengan semua nilai dan semua kunci.
    • OPERATOR_VALUE: Mewakili hubungan kunci dengan sekumpulan nilai. Tetapkan parameter ke salah satu opsi berikut:
      • exists: Kubernetes mencocokkan nilai apa pun jika taint ditentukan, terlepas dari nilai taint.
      • equal: Kubernetes tidak menjadwalkan Pod ke node jika nilainya berbeda. Operator memerlukan nilai taint true.
    • VALUE: Nilai taint yang cocok dengan toleransi. Jika operatornya adalah Exists, nilainya kosong, jika tidak, nilainya adalah string reguler. Contohnya, true.
    • TAINT_EFFECT: Menunjukkan efek taint yang akan dicocokkan. Kolom kosong menandakan bahwa semua efek taint harus dicocokkan. Tetapkan parameter ke salah satu opsi berikut:
      • NoSchedule: Kubernetes tidak menjadwalkan Pod baru di node yang terpengaruh.
      • PreferNoSchedule: Kubernetes menghindari penempatan Pod baru di node yang terpengaruh kecuali jika diperlukan.
      • NoExecute: Kubernetes mengeluarkan Pod yang ada yang tidak mentoleransi taint.
  2. Terapkan kembali manifes.

Menentukan afinitas node

Penjadwal Kubernetes menggunakan afinitas node sebagai sekumpulan aturan untuk menentukan tempat menempatkan Pod. Afinitas node adalah versi pemilih node yang lebih fleksibel dan ekspresif.

Untuk menentukan node mana yang harus dijadwalkan untuk menjalankan database Anda, ikuti langkah-langkah berikut:

  1. Ubah manifes cluster database untuk menyertakan bagian nodeaffinity setelah bagian tolerations di bagian schedulingConfig dari primarySpec untuk instance utama atau spec untuk instance kumpulan baca: 
          nodeaffinity:
         NODE_AFFINITY_TYPE:
         - weight: WAIT_VALUE
           preference:
             matchExpressions:
             - key: LABEL_KEY
               operator: OPERATOR_VALUE
               values:
               - LABEL_KEY_VALUE

    Ganti kode berikut:

    • NODE_AFFINITY_TYPE: Tetapkan parameter ke salah satu opsi berikut:
      • requiredDuringSchedulingIgnoredDuringExecution: Kubernetes menjadwalkan Pod berdasarkan aturan yang ditentukan.
      • preferredDuringSchedulingIgnoredDuringExecution: Penjadwal Kubernetes mencoba menemukan node yang memenuhi aturan yang ditentukan untuk penjadwalan. Namun, jika tidak ada node seperti itu, Kubernetes akan menjadwalkan ke node lain dalam cluster.
    • WAIT_VALUE: Menunjukkan bobot preferensi untuk node yang ditentukan. Nilai yang lebih tinggi menunjukkan preferensi yang lebih kuat. Nilai yang valid adalah dari 1 hingga 100.
    • LABEL_KEY: Label node untuk kunci yang berfungsi sebagai indikator lokasi dan memfasilitasi distribusi Pod yang merata di seluruh cluster. Contohnya, disktype=ssd.
    • OPERATOR_VALUE: Mewakili hubungan kunci dengan sekumpulan nilai. Tetapkan parameter ke salah satu opsi berikut:
      • In: Array nilai tidak boleh kosong.
      • NotIn: Array nilai tidak boleh kosong.
      • Exists: Array nilai harus kosong.
      • DoesNotExist: Array nilai harus kosong.
      • Gt: Array nilai harus memiliki satu elemen, yang ditafsirkan sebagai bilangan bulat.
      • Lt: Array nilai harus memiliki satu elemen, yang ditafsirkan sebagai bilangan bulat.
    • LABEL_KEY_VALUE: Nilai untuk kunci label Anda. Tetapkan parameter ke array nilai string sebagai berikut:
      • Jika operatornya adalah In atau NotIn, array nilai tidak boleh kosong.
      • Jika operatornya adalah Exists atau DoesNotExist, array nilai harus kosong.
      • Jika operatornya adalah Gt atau Lt, array nilai harus memiliki satu elemen, yang ditafsirkan sebagai bilangan bulat.
  2. Terapkan kembali manifes.

Contoh

Contoh berikut mengilustrasikan penjadwalan Pod di instance kumpulan baca dan utama operator AlloyDB Omni Kubernetes. Penyiapan penjadwalan ini membantu memastikan bahwa instance utama cluster database dijadwalkan pada node yang sesuai sekaligus memungkinkan fleksibilitas dalam pemilihan node. Fleksibilitas ini dapat berguna untuk menyeimbangkan beban, mengoptimalkan penggunaan resource, atau mematuhi peran dan karakteristik node tertentu.

    schedulingconfig:
      tolerations:
      - key: "node-role.kubernetes.io/control-plane"
        operator: "Exists"
        effect: "NoSchedule"
      nodeaffinity:
        preferredDuringSchedulingIgnoredDuringExecution:
        - weight: 1
          preference:
            matchExpressions:
            - key: another-node-label-key
              operator: In
              values:
              - another-node-label-value

Toleransi contoh memungkinkan Pod dijadwalkan pada node yang ditandai sebagai node bidang kontrol karena detail berikut:

  • Kunci taint node-role.kubernetes.io/control-plane menunjukkan bahwa node memiliki node bidang kontrol.
  • Operator Exists berarti toleransi cocok dengan taint apa pun dengan kunci taint yang ditentukan, terlepas dari nilainya.
  • Efek NoSchedule berarti Pod tidak akan dijadwalkan di node bidang kontrol kecuali jika memiliki toleransi yang cocok.

Jenis afinitas node preferredDuringSchedulingIgnoredDuringExecution menentukan bahwa aturan yang ditentukan untuk afinitas node lebih disukai, tetapi tidak diperlukan selama penjadwalan. Jika node pilihan tidak tersedia, Pod mungkin masih dijadwalkan di node lain. Nilai bobot 1 menunjukkan preferensi yang lemah. Kriteria pemilihan node ditentukan di bagian preference. Bagian matchExpressions berisi array ekspresi yang digunakan untuk mencocokkan node. Kunci another-node-label-key mewakili kunci label node yang akan dicocokkan. Operator In berarti node harus memiliki kunci dengan salah satu nilai yang ditentukan. Kunci another-node-label-key harus memiliki nilai another-node-label-value.

Aturan afinitas node contoh menunjukkan preferensi untuk menjadwalkan Pod pada node yang memiliki label another-node-label-key dengan nilai another-node-label-value. Preferensinya lemah sehingga bukan persyaratan yang kuat.

Contoh ini menggabungkan hal berikut:

  • Toleransi yang memungkinkan Pod dijadwalkan pada node bidang kontrol dengan mentoleransi taint NoSchedule.
  • Afinitas node yang lebih memilih node dengan label tertentu, tetapi tidak mewajibkannya secara ketat; oleh karena itu, afinitas ini menawarkan fleksibilitas dalam penjadwalan.

Langkah berikutnya