Tek Aggregate, iki boyutta MySQL kümesi
Bir MySQL InnoDB Cluster ve onu uzlaştıran kontrol düzlemi, değiştirilmemiş tek bir Aggregate’ten iki kez derlenir: bir kez tek sunucu örneği istenerek, bir kez de üç örnek istenerek.
Ders, boyutun nerede durduğudur. Veritabanının arkasında kaç sunucu bulunduğu, geliştiricinin yazdığı bir şey değildir ve Recipe’in karar verdiği bir şey de değildir; Release’teki tek satırlık bir operatör boyutlandırmasıdır ve işlenen iki ağaç arasındaki farkın tamamıdır.
Derleyicinin yazdıkları ve yazmadıkları
Bu gerçekleştirme bir InnoDBCluster özel kaynağı üretir. Sunucular, Service’ler veya yönlendiriciler üretmez: bunları, özel kaynak uygulandıktan sonra hedef kümenin içinde MySQL Operator for Kubernetes oluşturur; bu da derleyici işini bitirdikten çok sonra gerçekleşen bir iştir.
Dolayısıyla aşağıdaki her şey, işlenen özel kaynağın ne istediğini anlatır. Çalışan bir kümenin sonunda neleri içereceği, denetleyicinin bu isteğe derleyicinin hiç görmediği bir anda verdiği yanıttır; derleyici bu konuda hiçbir iddiada bulunmaz, çünkü bakmanın bir yolu yoktur.
Değişen tek şey
.-- release-single.yaml ----- spec.instances: 1 /one Aggregate -- one Manifest -+one Component \one Recipe '- release-replicated.yaml -- spec.instances: 3İki Release de aynı Component’i ve aynı Recipe’i seçer, bu yüzden her Release için ayrı değil, tek bir Manifest vardır. İki Release yalnızca boyutlandırmada farklı olduğunda Ops eşlemesinin bu fark hakkında söyleyeceği bir şey yoktur ve ikinci bir kopyası, hiçbir kazanç sağlamadan uyumlu tutulması gereken ikinci bir şey olurdu.
Dosyalar
aggregate.yaml— geliştirici niyeti ve iki Release için de aynı belge: kontrol düzlemi için birmysql-operatorbileşeni,core/datastore/mysql-innodb-clustertüründe birdbbileşeni ve geliştiricinin sunucunun kullanmasını istediği karakter kümesi. Burada kaç sunucu olduğunu söyleyen hiçbir şey yoktur.manifest.yaml— iki Release’in paylaştığı Ops eşlemesi. İki satır: kontrol düzlemini hangi Recipe’in, veritabanını hangisinin gerçekleştirdiği.release-single.yaml,release-replicated.yaml— operatörün boyutlandırması. Yalnızcametadata.nameveserver_instancesdeğerlerinde farklıdırlar; diğer her alan, farkın tamamı tek satır olsun diye bilerek eşit tutulmuştur..aggrega-config.yaml— standart kütüphane kataloğunun çözümlendiği hub kayıt defterini adlandırır. Bu örnek kendine ait hiçbir varlık yazmaz.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example mysql-innodb-clusterArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd mysql-innodb-clusterDerleme
aggrega build --release release-single.yaml --auto-pullaggrega build --release release-replicated.yaml --auto-pull--auto-pull, yeni bir klonda bulunmayan lockfile’ı derleme sırasında yazar. Her derleme dist/ dizinine yazar ve bir derleme, öncekinin bıraktıklarını temizlemek yerine kendi dosyalarını ekler. Bir Release’in çıktısını tek başına okumak için çalıştırmalar arasında dist/ dizinini silin:
rm -rf dist && aggrega build --release release-replicated.yaml --auto-pullHer Release beş dosya işler: veritabanının özel kaynağı ve kontrol düzlemini ayağa kaldıran dört dosya.
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.yamlBir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz klasör oluşturmayın. Çalışma alanı klasöründe henüz `mysql-innodb-cluster` klasörü yoksa `scaffold` aracını `example` değeri `mysql-innodb-cluster` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `mysql-innodb-cluster` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla — `release-single.yaml` ve `release-replicated.yaml` — her seferinde `workspace_root` değeri `mysql-innodb-cluster`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `mysql-innodb-cluster/dist/` altındadır.Veritabanının işlendiği çıktı
# 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_ciİşlenen dosya, Aggrega’nın işlediği her yapıta koyduğu etiketleri ve ek açıklamaları da taşır: hangi Aggregate’ten, hangi bileşenden, hangi Recipe’ten ve hangi sınırdan geldiği. İsteğin kendisi görünür kalsın diye bunlar burada çıkarılmıştır.
Bu beş spec girdisinden dördü doğrudan yazılmış bir şeye dayanır: instances Release’in server_instances alanına, version Component’in engine_version varsayılanına, secretName Release’in credentials_secret alanına, mycnf bloğu ise geliştiricinin charset ve collation alanlarına. Beşincisi, router.instances, aşağıda ele alınır.
Asıl önemli olan karşılaştırma
İşlenen iki ağaç arasındaki farkın tamamı:
--- dist/stack/helm/db/innodbcluster.yaml (single)+++ dist/stack/helm/db/innodbcluster.yaml (replicated) spec:- instances: 1+ instances: 3 router: instances: 1Beş dosyadan birinde, tek satır. Dört kontrol düzlemi dosyası iki Release arasında bayt bayt aynıdır: tek örnekli bir isteği uzlaştıran denetleyici ile üç örnekli bir isteği uzlaştıran denetleyici aynı denetleyicidir, bu yüzden onunla ilgili hiçbir şey değişmez.
Yönlendirici sayısı da değişmez ve bu bileşenin serbestçe sunduğu bir ayar değildir. Bileşenin yayımladığı adres, yönlendiricilerin yanıt verdiği Service’tir; bu yüzden sayı, özel kaynağın kendi varsayılanında sunulur ve hiçbir zaman onun altına inmez. Bu, bu örneğin değiştirdiği bir boyut değil, bir Release’in isteyebileceklerine konan bir sınırdır; satırın yukarıdaki farkta değişmeden durmasının nedeni budur.
Kontrol düzlemi
[… 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]İki Release de bir imaj adı vermez. Başvuru, Component’in kendi infra.image varsayılanından gelir; bu yüzden hiçbir şey ayarlamayan bir Release bile, uygulanabilmesi için önce doldurulması gereken bir Deployment yerine üzerinde tek bir sürüm olan bir Deployment işler. Kendi kayıt defteri aynasından çeken bir hedef, Release’te infra.image ayarlar ve onun yerine o başvuruyu alır.
Kontrol düzlemi, Aggregate’te veritabanının yanında bildirilir, çünkü tek başına bir özel kaynak etkisizdir: ancak bir denetleyici onu izlemeye başladığında çalışan bir sunucuya dönüşür. İkisini birlikte bildirmek, ikisinin tek bir birim olarak uygulanmasını sağlar.
Ön koşul keşfedilmez, beyan edilir
Derleyici önceden çalışır ve hiçbir zaman bir kümeye bağlanmaz, bu yüzden denetleyicinin kurulu olup olmadığını denetleyemez. Bunun yerine sorar. control_plane_present ayarlanmadan bırakılırsa derleme durur:
[… 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 ReleaseHiçbir şey yazılmaz. Kimsenin uzlaştırmadığı bir özel kaynak, çalışan bir kaynaktan daha küçük bir başarı değildir; sorunsuz uygulanıp sonra öylece duran bir yapıttır. Bu yüzden derleme onu üretmeyi reddeder ve aksini söyleyecek anahtarın adını verir.
Root hesabı
Buradaki iki Release de kümeyi, hedef kümede zaten var olan bir Secret’a yönlendirir:
db: infra: credentials_secret: mysql-rootO Secret için hiçbir şey işlenmez ve çıktıya hiçbir parola ulaşmaz; özel kaynak adı taşır, denetleyici de hesabı oradan okur. Bunun yerine infra.credentials değerini generated olarak ayarlamak, Secret’ı özel kaynağın yanında, bileşenin root_password yuvasına bağlı bir kimlik bilgisinden işler; bu, parolayı işlenen çıktıya koyar ve kümeyi hazırlayan şey çıktının kendisi olduğunda doğru seçimdir.
Bu gerçekleştirmenin oluşturmadığı şey, mantıksal bir veritabanı veya bir uygulama kullanıcısıdır. Denetleyici kümenin root hesabını kurar ve altında hiçbir şey kurmaz; bu yüzden bir uygulamanın ihtiyaç duyduğu şemaları ve hesapları root yetkisine sahip olan kişi oluşturur.
Hangi gerçekleştirmeye başvurulmalı
Önce hiçbir şeyin kurulması gerekmeyebilecekse core/datastore/mysql ve onun sentezlenmiş Recipe’ine başvurun: kümede denetleyici ve erişilecek bir chart deposu gerektirmez, bu yüzden hiçbir şey çekmeden derlenir ve bir uygulamanın istediği mantıksal veritabanını ve oturum açma rolünü oluşturur. Hedef zaten MySQL Operator kontrol düzlemini çalıştırıyorsa core/datastore/mysql-innodb-cluster seçeneğine başvurun; ya da hedef bu örnekte olduğu gibi onu kuruyorsa ve uygulamanın ihtiyacı küme içi bir adresteki bir kümeye root erişimiyse.
Sentezlenmiş gerçekleştirmenin tek sunuculu biçimi ../mysql-standalone/ içinde ayrıntılı olarak işlenmiştir ve burada tekrarlanmaz.
Ayrım noktası nerede
Tek örnek ile üç örnek arasındaki seçim geliştirici belgesine dokunmadı, Ops eşlemesine de. Bu örneğin somutlaştırmak için var olduğu ayrım budur:
- geliştirici uygulamanın bir veritabanından neye ihtiyaç duyduğunu söyler;
- Ops bir veritabanının nelerden oluştuğunu, yani onu hangi Recipe’in gerçekleştirdiğini söyler;
- operatör bunun ne kadar büyük olduğunu söyler.
server_instances değerini özel kaynağın kabul ettiği herhangi bir değere değiştirin; bu dizindeki aggregate.yaml değişmez.