Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Ein Aggregate, zwei Größen von MySQL-Clustern

Ein MySQL InnoDB Cluster und die Control Plane, die ihn abgleicht, zweimal aus einem einzigen unveränderten Aggregate gebaut: einmal mit der Anforderung einer einzelnen Serverinstanz, einmal mit der von drei.

Die Lektion ist, wo die Größe liegt. Wie viele Server hinter der Datenbank stehen, hat weder der Entwickler geschrieben noch das Recipe entschieden — es ist eine Zeile Dimensionierung durch den Operator im Release, und sie ist das Ganze dessen, was sich zwischen den beiden gerenderten Bäumen unterscheidet.

Was der Compiler schreibt und was nicht

Diese Realisierung gibt eine benutzerdefinierte Ressource InnoDBCluster aus. Sie gibt keine Server, Services oder Router aus: Der MySQL Operator for Kubernetes erstellt diese innerhalb des Ziel-Clusters, nachdem die benutzerdefinierte Ressource angewendet wurde — Arbeit, die lange nach dem Abschluss des Compilers geschieht.

Alles Folgende beschreibt daher, was die gerenderte benutzerdefinierte Ressource anfordert. Was ein laufender Cluster am Ende enthält, ist die Antwort des Controllers auf diese Anforderung, zu einem Zeitpunkt, den der Compiler nie sieht — und der Compiler stellt darüber keine Behauptung auf, weil er keine Möglichkeit hat nachzusehen.

Das eine, was variiert

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

Beide Releases wählen dieselbe Component und dasselbe Recipe aus, daher gibt es ein Manifest, nicht eines pro Release. Wenn sich zwei Releases nur in der Dimensionierung unterscheiden, hat das Ops-Mapping zu dem Unterschied nichts zu sagen, und eine zweite Kopie davon wäre ohne Gewinn ein zweites Ding, das synchron gehalten werden muss.

Dateien

  • aggregate.yaml — Entwicklerabsicht und dasselbe Dokument für beide Releases: eine Komponente mysql-operator für die Control Plane, eine Komponente db vom Typ core/datastore/mysql-innodb-cluster und der Zeichensatz, den der Server nach dem Wunsch des Entwicklers sprechen soll. Nichts hier sagt, wie viele Server es gibt.
  • manifest.yaml — das Ops-Mapping, von beiden Releases geteilt. Zwei Zeilen: welches Recipe die Control Plane realisiert und welches die Datenbank realisiert.
  • release-single.yaml, release-replicated.yaml — die Dimensionierung durch den Operator. Sie unterscheiden sich in ihrem metadata.name und in server_instances, und jedes andere Feld wird absichtlich gleich gehalten, sodass eine Zeile der gesamte Unterschied ist.
  • .aggrega-config.yaml — nennt die Hub-Registry, aus der der Katalog der Standardbibliothek aufgelöst wird. Dieses Beispiel verfasst keine eigenen Entitäten.

Das Beispiel generieren

Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.

Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:

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

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

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 schreibt während des Builds die Lockfile, die einem frischen Klon fehlt. Jeder Build schreibt nach dist/, und ein Build ergänzt seine Dateien, statt zu bereinigen, was ein früherer hinterlassen hat. Entfernen Sie dist/ zwischen den Läufen, um die Ausgabe eines Release für sich allein zu lesen:

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

Jedes Release rendert fünf Dateien: die benutzerdefinierte Ressource der Datenbank und die vier, die die Control Plane aufbauen.

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

Mit einem KI-Assistenten

Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.

Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `mysql-innodb-cluster` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `mysql-innodb-cluster` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `mysql-innodb-cluster`. Rufen Sie anschließend das Tool `build` einmal für jedes Release auf, in dieser Reihenfolge — `release-single.yaml` und `release-replicated.yaml` —, jedes Mal mit `workspace_root` auf `mysql-innodb-cluster`, `release` auf diese Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir, welche Dateien jeder Build geschrieben hat; sie liegen unter `mysql-innodb-cluster/dist/`.

Wozu die Datenbank gerendert wird

# 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

Die gerenderte Datei trägt außerdem die Labels und Annotationen, die Aggrega an jedes Artefakt setzt, das es rendert — aus welchem Aggregate es stammt, welche Komponente, welches Recipe, welche Boundary —, hier weggelassen, damit die Anforderung selbst im Blick bleibt.

Vier dieser fünf Einträge in spec lassen sich direkt auf etwas Verfasstes zurückführen: instances auf server_instances des Release, version auf den Standardwert engine_version der Component, secretName auf credentials_secret des Release und der Block mycnf auf charset und collation des Entwicklers. Der fünfte, router.instances, wird weiter unten besprochen.

Der Vergleich, um den es geht

Der gesamte Unterschied zwischen den beiden gerenderten Bäumen:

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

Eine Zeile, in einer der fünf Dateien. Die vier Control-Plane-Dateien sind zwischen den beiden Releases byteidentisch: Der Controller, der eine Anforderung mit einer Instanz abgleicht, und der Controller, der eine Anforderung mit drei Instanzen abgleicht, sind derselbe Controller, daher bewegt sich an ihm nichts.

Auch die Router-Anzahl bewegt sich nicht, und sie ist kein Regler, den diese Komponente frei anbietet. Die Adresse, die die Komponente veröffentlicht, ist der Service, auf dem die Router antworten, daher wird die Anzahl auf dem eigenen Standardwert der benutzerdefinierten Ressource bereitgestellt und nie darunter. Das ist eine Schranke für das, was ein Release anfordern darf, und keine Größe, die dieses Beispiel variiert, weshalb die Zeile im Diff oben steht, ohne sich zu ändern.

Die 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]

Kein Release nennt ein Image. Die Referenz stammt aus dem eigenen Standardwert infra.image der Component, sodass ein Release, das nichts setzt, trotzdem ein Deployment mit einer bereits eingetragenen Version rendert statt eines, das ausgefüllt werden muss, bevor es angewendet werden kann. Ein Ziel, das aus seinem eigenen Registry-Mirror bezieht, setzt infra.image im Release und erhält stattdessen diese Referenz.

Die Control Plane wird im Aggregate deklariert, neben der Datenbank, weil eine benutzerdefinierte Ressource für sich allein inert ist: Sie wird erst dann zu einem laufenden Server, wenn ein Controller nach ihr Ausschau hält. Beide zusammen zu deklarieren ist das, was es erlaubt, die beiden als eine Einheit anzuwenden.

Die Voraussetzung wird zugesichert, nie ermittelt

Der Compiler läuft im Voraus und kontaktiert nie einen Cluster, daher kann er nicht prüfen, ob der Controller installiert ist. Stattdessen fragt er nach. Lassen Sie control_plane_present ungesetzt, und der Build hält an:

[… 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

Nichts wird geschrieben. Eine benutzerdefinierte Ressource, die niemand abgleicht, ist kein kleinerer Erfolg als eine funktionierende — sie ist ein Artefakt, das sich sauber anwenden lässt und dann einfach dort liegt, daher weigert sich der Build, es zu erzeugen, und nennt den Schlüssel, der etwas anderes aussagen würde.

Das Root-Konto

Beide Releases hier verweisen den Cluster auf ein Secret, das im Ziel-Cluster bereits existiert:

db:
infra:
credentials_secret: mysql-root

Für dieses Secret wird nichts gerendert, und kein Passwort gelangt in die Ausgabe — die benutzerdefinierte Ressource trägt den Namen, und der Controller liest das Konto daraus. Wird infra.credentials stattdessen auf generated gesetzt, wird das Secret neben der benutzerdefinierten Ressource aus Zugangsdaten gerendert, die an den Slot root_password der Komponente angebunden sind; das bringt das Passwort in die gerenderte Ausgabe und ist die richtige Wahl, wenn die Ausgabe das ist, was den Cluster bereitstellt.

Was diese Realisierung nicht erstellt, ist eine logische Datenbank oder ein Anwendungsbenutzer. Der Controller richtet das Root-Konto des Clusters ein und nichts darunter, daher werden die Schemas und Konten, die eine Anwendung braucht, von demjenigen erstellt, der Root-Rechte hat.

Zu welcher Realisierung man greift

Greifen Sie zu core/datastore/mysql und seinem synthetisierten Recipe, wenn nichts eine vorherige Installation erfordern darf — es braucht keinen Controller im Cluster und kein erreichbares Chart-Repository, daher baut es, ohne etwas abzurufen, und es erstellt die logische Datenbank und die Login-Rolle, die eine Anwendung anfordert. Greifen Sie zu core/datastore/mysql-innodb-cluster, wenn das Ziel die Control Plane des MySQL Operator bereits ausführt, oder sie installiert, wie dieses Beispiel es tut, und die Anwendung Root-Zugriff auf einen Cluster unter einer clusterinternen Adresse braucht.

Die Ein-Server-Form der synthetisierten Realisierung wird in ../mysql-standalone/ durchgearbeitet und hier nicht wiederholt.

Wo die Naht liegt

Das Dokument des Entwicklers blieb von der Wahl zwischen einer Instanz und drei unberührt, ebenso das Ops-Mapping. Das ist die Aufteilung, die dieses Beispiel greifbar machen soll:

  • der Entwickler sagt, was die Anwendung von einer Datenbank braucht;
  • Ops sagt, woraus eine Datenbank besteht — welches Recipe sie realisiert;
  • der Operator sagt, wie groß diese hier ist.

Ändern Sie server_instances auf einen beliebigen Wert, den die benutzerdefinierte Ressource akzeptiert, und das aggregate.yaml in diesem Verzeichnis bewegt sich nicht.