Một Aggregate, hai kích thước cụm MySQL
Một MySQL InnoDB Cluster cùng control plane điều hòa nó, được build hai lần từ một Aggregate không thay đổi: một lần yêu cầu một phiên bản máy chủ duy nhất, một lần yêu cầu ba.
Bài học nằm ở chỗ kích thước được đặt ở đâu. Có bao nhiêu máy chủ đứng sau cơ sở dữ liệu không phải điều nhà phát triển viết ra, cũng không phải điều Recipe quyết định — đó là một dòng định cỡ của người vận hành trong Release, và đó là toàn bộ điểm khác nhau giữa hai cây kết xuất.
Những gì trình biên dịch ghi ra, và những gì nó không ghi
Cách hiện thực hóa này xuất ra một custom resource InnoDBCluster. Nó không xuất ra
máy chủ, Service hay router: MySQL Operator for Kubernetes tạo ra chúng
bên trong cụm đích sau khi custom resource được áp dụng, đó là công việc
diễn ra rất lâu sau khi trình biên dịch đã hoàn tất.
Vì vậy mọi điều dưới đây mô tả những gì custom resource được kết xuất yêu cầu. Những gì một cụm đang chạy cuối cùng chứa là câu trả lời của controller cho yêu cầu đó, vào một thời điểm trình biên dịch không bao giờ thấy — và trình biên dịch không khẳng định gì về điều đó, vì nó không có cách nào để quan sát.
Điều duy nhất thay đổi
.-- release-single.yaml ----- spec.instances: 1 /one Aggregate -- one Manifest -+one Component \one Recipe '- release-replicated.yaml -- spec.instances: 3Cả hai Releases đều chọn cùng một Component và cùng một Recipe, nên chỉ có một Manifest, không phải một cho mỗi Release. Khi hai Releases chỉ khác nhau về định cỡ, ánh xạ Ops không có gì để nói về sự khác biệt đó, và một bản sao thứ hai của nó sẽ là thêm một thứ cần giữ đồng bộ mà chẳng được lợi gì.
Các tệp
aggregate.yaml— ý định của nhà phát triển, và là cùng một tài liệu cho cả hai Releases: một componentmysql-operatorcho control plane, một componentdbcó kiểucore/datastore/mysql-innodb-cluster, và bộ ký tự mà nhà phát triển muốn máy chủ sử dụng. Không có gì ở đây cho biết có bao nhiêu máy chủ.manifest.yaml— ánh xạ Ops, được cả hai Releases dùng chung. Hai dòng: Recipe nào hiện thực hóa control plane, và Recipe nào hiện thực hóa cơ sở dữ liệu.release-single.yaml,release-replicated.yaml— phần định cỡ của người vận hành. Chúng khác nhau ởmetadata.namevà ởserver_instances, và mọi trường khác được cố ý giữ bằng nhau để một dòng là toàn bộ sự khác biệt..aggrega-config.yaml— nêu registry hub mà catalog thư viện chuẩn được phân giải từ đó. Ví dụ này không tự định nghĩa thực thể nào.
Tạo ví dụ
Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.
Ghi ví dụ vào một thư mục mới đặt theo tên của nó:
aggrega scaffold --example mysql-innodb-clusterSau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:
cd mysql-innodb-clusterBuild
aggrega build --release release-single.yaml --auto-pullaggrega build --release release-replicated.yaml --auto-pull--auto-pull ghi lockfile mà một bản clone mới còn thiếu trong quá trình build. Mỗi bản build ghi vào dist/, và một lần build thêm các tệp của nó thay vì xóa những gì lần trước để lại. Hãy xóa dist/ giữa các lần chạy để đọc riêng đầu ra của một Release:
rm -rf dist && aggrega build --release release-replicated.yaml --auto-pullMỗi Release kết xuất năm tệp: custom resource của cơ sở dữ liệu, và bốn tệp dựng control plane lên.
dist/stack/helm/db/innodbcluster.yamldist/stack/helm/mysql-operator/clusterrole.yamldist/stack/helm/mysql-operator/clusterrolebinding.yamldist/stack/helm/mysql-operator/deployment.yamldist/stack/helm/mysql-operator/serviceaccount.yamlVới trợ lý AI
Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.
Chỉ sử dụng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa chứa thư mục `mysql-innodb-cluster`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `mysql-innodb-cluster` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `mysql-innodb-cluster` mới. Sau đó gọi công cụ `build` một lần cho mỗi Release, theo thứ tự này — `release-single.yaml` và `release-replicated.yaml` — mỗi lần với `workspace_root` được đặt thành `mysql-innodb-cluster`, `release` được đặt thành tệp đó, `auto_pull` được đặt thành true và `write` được đặt thành true. Hãy cho tôi biết mỗi bản build đã ghi những tệp nào; chúng nằm trong `mysql-innodb-cluster/dist/`.Cơ sở dữ liệu được kết xuất thành gì
# dist/stack/helm/db/innodbcluster.yaml — aggrega build --release release-single.yamlapiVersion: mysql.oracle.com/v2kind: InnoDBClustermetadata: [… omitted: the labels and annotations, described below] name: dbspec: instances: 1 router: instances: 1 version: "8.4.0" secretName: "mysql-root" mycnf: | [mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_0900_ai_ciTệp được kết xuất còn mang các label và annotation mà Aggrega gắn lên mọi artifact nó kết xuất — nó đến từ Aggregate nào, component nào, Recipe nào, ranh giới nào — được lược bỏ ở đây để giữ chính yêu cầu trong tầm nhìn.
Bốn trong năm mục spec đó truy ngược thẳng về một thứ được viết ra: instances về server_instances của Release, version về giá trị mặc định engine_version của Component, secretName về credentials_secret của Release, và khối mycnf về charset và collation của nhà phát triển. Mục thứ năm, router.instances, được bàn ở dưới.
Phép so sánh là mục đích chính
Toàn bộ sự khác biệt giữa hai cây kết xuất:
--- dist/stack/helm/db/innodbcluster.yaml (single)+++ dist/stack/helm/db/innodbcluster.yaml (replicated) spec:- instances: 1+ instances: 3 router: instances: 1Một dòng, trong một trong năm tệp. Bốn tệp control plane giống hệt nhau từng byte giữa hai Releases: controller điều hòa một yêu cầu một phiên bản và controller điều hòa một yêu cầu ba phiên bản là cùng một controller, nên không có gì về nó thay đổi.
Số lượng router cũng không thay đổi, và đó không phải một nút chỉnh mà component này cho phép tự do. Địa chỉ component công bố là Service mà các router trả lời trên đó, nên số lượng được đặt ở giá trị mặc định của chính custom resource và không bao giờ thấp hơn. Đó là một giới hạn cho những gì một Release có thể yêu cầu chứ không phải một kích thước mà ví dụ này thay đổi, đó là lý do dòng này nằm trong diff ở trên mà không thay đổi.
Control plane
[… 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]Không Release nào chỉ định image. Tham chiếu đến từ giá trị mặc định
infra.image của chính Component, nên một Release không đặt gì vẫn kết xuất một Deployment
có một phiên bản trên đó thay vì một Deployment phải được điền vào trước khi có thể
áp dụng. Một đích kéo image từ registry mirror của riêng nó sẽ đặt infra.image trong
Release và nhận tham chiếu đó thay thế.
Control plane được khai báo trong Aggregate, bên cạnh cơ sở dữ liệu, vì một custom resource tự nó là trơ: nó chỉ trở thành một máy chủ đang chạy khi có một controller theo dõi nó. Khai báo cả hai cùng nhau là điều cho phép hai thứ được áp dụng như một đơn vị.
Điều kiện tiên quyết được khẳng định, không bao giờ được dò tìm
Trình biên dịch chạy ahead-of-time và không bao giờ liên hệ với một cụm, nên nó không thể kiểm tra
liệu controller đã được cài đặt hay chưa. Thay vào đó nó hỏi. Để
control_plane_present không được đặt thì quá trình build dừng lại:
[… 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 ReleaseKhông có gì được ghi ra. Một custom resource không ai điều hòa không phải là một thành công nhỏ hơn một cái hoạt động được — nó là một artifact áp dụng trơn tru rồi nằm yên đó, nên quá trình build từ chối tạo ra nó và nêu tên khóa có thể nói điều ngược lại.
Tài khoản root
Cả hai Releases ở đây đều trỏ cụm tới một Secret đã tồn tại trong cụm đích:
db: infra: credentials_secret: mysql-rootKhông có gì được kết xuất cho Secret đó và không có mật khẩu nào đi vào đầu ra — custom
resource mang tên và controller đọc tài khoản từ đó.
Đặt infra.credentials thành generated thay vào đó sẽ kết xuất Secret bên cạnh
custom resource từ một thông tin xác thực gắn vào slot root_password
của component, điều này đặt mật khẩu vào đầu ra được kết xuất và là lựa chọn đúng khi
đầu ra chính là thứ cấp phát cụm.
Những gì cách hiện thực hóa này không tạo ra là một cơ sở dữ liệu logic hay một người dùng ứng dụng. Controller thiết lập tài khoản root của cụm và không gì bên dưới nó, nên các schema và tài khoản mà một ứng dụng cần được tạo bởi người nắm giữ root.
Nên chọn cách hiện thực hóa nào
Hãy chọn core/datastore/mysql và Recipe được tổng hợp của nó khi không được phép
cần cài đặt gì trước — nó không cần controller nào trong cụm và không cần chart
repository nào để truy cập, nên nó build mà không tải gì về, và nó tạo ra
cơ sở dữ liệu logic và vai trò đăng nhập mà một ứng dụng yêu cầu. Hãy chọn
core/datastore/mysql-innodb-cluster khi đích đã chạy control plane MySQL
Operator, hoặc cài đặt nó như ví dụ này làm, và điều ứng dụng cần là quyền truy cập root vào một cụm tại một địa chỉ trong cụm.
Dạng một máy chủ của cách hiện thực hóa được tổng hợp được trình bày chi tiết trong
../mysql-standalone/, và không được lặp lại ở đây.
Đường ranh giới nằm ở đâu
Tài liệu của nhà phát triển không bị ảnh hưởng bởi lựa chọn giữa một phiên bản và ba, và ánh xạ Ops cũng vậy. Đó là sự phân tách mà ví dụ này tồn tại để làm cho cụ thể:
- nhà phát triển nói ứng dụng cần gì từ một cơ sở dữ liệu;
- Ops nói một cơ sở dữ liệu được tạo thành từ gì — Recipe nào hiện thực hóa nó;
- người vận hành nói cái này lớn đến mức nào.
Đổi server_instances thành bất kỳ giá trị nào custom resource chấp nhận thì
aggregate.yaml trong thư mục này vẫn không thay đổi.