Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Satu Aggregate, dua ukuran klaster MySQL

Sebuah MySQL InnoDB Cluster beserta control plane yang merekonsiliasinya, dibangun dua kali dari satu Aggregate yang tidak diubah: sekali dengan meminta satu instans server, sekali dengan meminta tiga.

Pelajarannya adalah di mana ukuran itu berada. Berapa banyak server yang berdiri di belakang basis data bukanlah sesuatu yang ditulis oleh pengembang dan bukan sesuatu yang diputuskan oleh Recipe — itu adalah satu baris pengaturan ukuran dari operator di dalam Release, dan itulah keseluruhan perbedaan antara kedua pohon hasil render.

Apa yang ditulis oleh compiler, dan apa yang tidak

Realisasi ini menghasilkan custom resource InnoDBCluster. Realisasi ini tidak menghasilkan server, Service, atau router: MySQL Operator for Kubernetes membuat semua itu di dalam klaster target setelah custom resource diterapkan, yaitu pekerjaan yang terjadi jauh setelah compiler selesai.

Jadi, semua yang dijelaskan di bawah ini adalah apa yang diminta oleh custom resource hasil render. Apa yang akhirnya ada di dalam klaster yang berjalan adalah jawaban controller atas permintaan tersebut, pada saat yang tidak pernah dilihat oleh compiler — dan compiler tidak membuat klaim apa pun tentangnya, karena compiler tidak memiliki cara untuk melihatnya.

Satu-satunya hal yang berbeda

.-- release-single.yaml ----- spec.instances: 1
/
one Aggregate -- one Manifest -+
one Component \
one Recipe '- release-replicated.yaml -- spec.instances: 3

Kedua Releases memilih Component yang sama dan Recipe yang sama, sehingga hanya ada satu Manifest, bukan satu per Release. Ketika dua Releases hanya berbeda dalam ukuran, pemetaan Ops tidak memiliki apa pun untuk dikatakan tentang perbedaan tersebut, dan salinan kedua darinya hanya akan menjadi hal kedua yang harus diselaraskan tanpa manfaat apa pun.

Berkas

  • aggregate.yaml — maksud pengembang, dan merupakan dokumen yang sama untuk kedua Releases: komponen mysql-operator untuk control plane, komponen db bertipe core/datastore/mysql-innodb-cluster, dan set karakter yang diinginkan pengembang untuk digunakan server. Tidak ada bagian di sini yang menyebutkan berapa banyak server yang ada.
  • manifest.yaml — pemetaan Ops, digunakan bersama oleh kedua Releases. Dua baris: Recipe mana yang merealisasikan control plane, dan mana yang merealisasikan basis data.
  • release-single.yaml, release-replicated.yaml — pengaturan ukuran dari operator. Keduanya berbeda pada metadata.name dan server_instances, dan setiap field lainnya sengaja dibuat sama agar satu baris itu menjadi keseluruhan perbedaannya.
  • .aggrega-config.yaml — menyebutkan registry hub yang menjadi sumber resolusi katalog pustaka standar. Contoh ini tidak menulis entitas sendiri.

Membuat contoh

Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

Terminal window
aggrega scaffold --example mysql-innodb-cluster

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd mysql-innodb-cluster

Build

Terminal window
aggrega build --release release-single.yaml --auto-pull
aggrega build --release release-replicated.yaml --auto-pull

--auto-pull menulis lockfile yang tidak dimiliki oleh clone baru selama build. Setiap build menulis ke dist/, dan sebuah build menambahkan file-filenya alih-alih membersihkan apa yang ditinggalkan oleh build sebelumnya. Hapus dist/ di antara setiap eksekusi untuk membaca keluaran satu Release secara tersendiri:

Terminal window
rm -rf dist && aggrega build --release release-replicated.yaml --auto-pull

Setiap Release merender lima file: custom resource basis data, dan empat file yang menyiapkan control plane.

dist/stack/helm/db/innodbcluster.yaml
dist/stack/helm/mysql-operator/clusterrole.yaml
dist/stack/helm/mysql-operator/clusterrolebinding.yaml
dist/stack/helm/mysql-operator/deployment.yaml
dist/stack/helm/mysql-operator/serviceaccount.yaml

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `mysql-innodb-cluster`, panggil alat `scaffold` sekali dengan `example` diatur ke `mysql-innodb-cluster` dan tanpa `dir`: alat ini menulis contoh ke folder `mysql-innodb-cluster` yang baru. Kemudian panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-single.yaml` dan `release-replicated.yaml` — setiap kali dengan `workspace_root` diatur ke `mysql-innodb-cluster`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh setiap build; file tersebut berada di bawah `mysql-innodb-cluster/dist/`.

Hasil render basis data

# dist/stack/helm/db/innodbcluster.yaml — aggrega build --release release-single.yaml
apiVersion: mysql.oracle.com/v2
kind: InnoDBCluster
metadata:
[… omitted: the labels and annotations, described below]
name: db
spec:
instances: 1
router:
instances: 1
version: "8.4.0"
secretName: "mysql-root"
mycnf: |
[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_0900_ai_ci

File hasil render juga membawa label dan anotasi yang dipasang Aggrega pada setiap artefak yang direndernya — dari Aggregate mana artefak itu berasal, komponen mana, Recipe mana, batas mana — yang dihilangkan di sini agar permintaannya sendiri tetap terlihat.

Empat dari lima entri spec tersebut dapat ditelusuri langsung ke sesuatu yang ditulis: instances ke server_instances milik Release, version ke default engine_version milik Component, secretName ke credentials_secret milik Release, dan blok mycnf ke charset dan collation milik pengembang. Entri kelima, router.instances, dibahas di bawah.

Perbandingan yang menjadi intinya

Keseluruhan perbedaan antara kedua pohon hasil render:

--- dist/stack/helm/db/innodbcluster.yaml (single)
+++ dist/stack/helm/db/innodbcluster.yaml (replicated)
spec:
- instances: 1
+ instances: 3
router:
instances: 1

Satu baris, di salah satu dari lima file. Keempat file control plane identik byte demi byte di antara kedua Releases: controller yang merekonsiliasi permintaan satu instans dan controller yang merekonsiliasi permintaan tiga instans adalah controller yang sama, sehingga tidak ada yang berubah padanya.

Jumlah router juga tidak berubah, dan itu bukan pengaturan yang ditawarkan komponen ini secara bebas. Alamat yang dipublikasikan komponen adalah Service tempat router menjawab, sehingga jumlahnya diekspos pada nilai default milik custom resource itu sendiri dan tidak pernah di bawahnya. Itu adalah batas atas apa yang boleh diminta oleh sebuah Release, bukan ukuran yang divariasikan oleh contoh ini, itulah sebabnya baris tersebut ada di diff di atas tanpa berubah.

Control plane

dist/stack/helm/mysql-operator/deployment.yaml
[… omitted: the Deployment's metadata, selector and pod template up to the containers]
containers:
- name: controller
image: container-registry.oracle.com/mysql/community-operator:26.7.0-2.3.0
[… omitted: the controller's readiness probe]

Tidak ada Release yang menyebutkan image. Referensinya berasal dari nilai default infra.image milik Component itu sendiri, sehingga Release yang tidak mengatur apa pun tetap merender Deployment dengan satu versi di dalamnya, bukan Deployment yang harus diisi terlebih dahulu sebelum dapat diterapkan. Target yang menarik image dari mirror registry-nya sendiri mengatur infra.image di dalam Release dan mendapatkan referensi tersebut sebagai gantinya.

Control plane dideklarasikan di dalam Aggregate, di samping basis data, karena custom resource saja bersifat pasif: custom resource baru menjadi server yang berjalan ketika ada controller yang mengawasinya. Mendeklarasikan keduanya bersama-sama memungkinkan keduanya diterapkan sebagai satu unit.

Prasyarat dinyatakan, tidak pernah ditemukan

Compiler berjalan secara ahead-of-time dan tidak pernah menghubungi klaster, sehingga compiler tidak dapat memeriksa apakah controller sudah terpasang. Sebagai gantinya, compiler bertanya. Biarkan control_plane_present tidak diatur dan build akan berhenti:

[… omitted: the pull's lines, which carry the same halt]
[CATALOG_ERROR E0033]
Recipe/FeatureRecipe assertions
caused by: Recipe "mysql-innodb-cluster" instance "db" assertion "mysql_operator_prerequisite": assertion "Recipe/mysql-innodb-cluster/db/mysql_operator_prerequisite": template: Recipe/mysql-innodb-cluster/db/mysql_operator_prerequisite:1:48: executing "Recipe/mysql-innodb-cluster/db/mysql_operator_prerequisite" at <fail "the MySQL Operator control plane must be installed in the target cluster before this realization emits its InnoDBCluster custom resource; once the control plane is present, affirm the prerequisite by setting infra.control_plane_present to true in the Release">: error calling fail: assertion failed: the MySQL Operator control plane must be installed in the target cluster before this realization emits its InnoDBCluster custom resource; once the control plane is present, affirm the prerequisite by setting infra.control_plane_present to true in the Release

Tidak ada yang ditulis. Custom resource yang tidak direkonsiliasi oleh siapa pun bukanlah keberhasilan yang lebih kecil daripada yang berfungsi — itu adalah artefak yang berhasil diterapkan lalu hanya diam di sana, sehingga build menolak menghasilkannya dan menyebutkan key yang akan menyatakan sebaliknya.

Akun root

Kedua Releases di sini mengarahkan klaster ke Secret yang sudah ada di klaster target:

db:
infra:
credentials_secret: mysql-root

Tidak ada yang dirender untuk Secret tersebut dan tidak ada kata sandi yang sampai ke keluaran — custom resource membawa namanya dan controller membaca akun dari Secret tersebut. Mengatur infra.credentials ke generated sebagai gantinya akan merender Secret di samping custom resource dari kredensial yang dilampirkan pada slot root_password milik komponen, yang menempatkan kata sandi di dalam keluaran hasil render dan merupakan pilihan yang tepat ketika keluaran itulah yang menyediakan klaster.

Yang tidak dibuat oleh realisasi ini adalah basis data logis atau pengguna aplikasi. Controller menetapkan akun root klaster dan tidak ada apa pun di bawahnya, sehingga skema dan akun yang dibutuhkan aplikasi dibuat oleh siapa pun yang memegang akses root.

Realisasi mana yang dipilih

Pilih core/datastore/mysql dan Recipe sintesisnya ketika tidak boleh ada yang perlu dipasang terlebih dahulu — realisasi ini tidak memerlukan controller di dalam klaster dan tidak memerlukan repositori chart untuk dijangkau, sehingga dapat dibangun tanpa mengambil apa pun, dan realisasi ini membuat basis data logis serta peran login yang diminta oleh aplikasi. Pilih core/datastore/mysql-innodb-cluster ketika target sudah menjalankan control plane MySQL Operator, atau memasangnya seperti yang dilakukan contoh ini, dan yang dibutuhkan aplikasi adalah akses root ke klaster pada alamat di dalam klaster.

Bentuk server tunggal dari realisasi sintesis dibahas di ../mysql-standalone/, dan tidak diulang di sini.

Di mana batasnya

Dokumen pengembang tidak tersentuh oleh pilihan antara satu instans dan tiga, demikian pula pemetaan Ops. Itulah pemisahan yang ingin diperjelas oleh contoh ini:

  • pengembang menyatakan apa yang dibutuhkan aplikasi dari basis data;
  • Ops menyatakan dari apa basis data tersusun — Recipe mana yang merealisasikannya;
  • operator menyatakan seberapa besar basis data yang satu ini.

Ubah server_instances ke nilai apa pun yang diterima oleh custom resource dan aggregate.yaml di direktori ini tidak berubah.