Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Un Aggregate, dos tamaños de clúster MySQL

Un MySQL InnoDB Cluster y el plano de control que lo reconcilia, compilados dos veces a partir de un único Aggregate sin cambios: una vez pidiendo una sola instancia de servidor y otra pidiendo tres.

La lección es dónde vive el tamaño. Cuántos servidores hay detrás de la base de datos no es algo que haya escrito el desarrollador ni algo que haya decidido la Recipe — es una línea de dimensionamiento del operador en la Release, y es todo lo que difiere entre los dos árboles renderizados.

Lo que el compilador escribe, y lo que no

Esta realización emite un recurso personalizado InnoDBCluster. No emite servidores, Services ni enrutadores: el MySQL Operator for Kubernetes los crea dentro del clúster de destino después de que se aplique el recurso personalizado, un trabajo que ocurre mucho después de que el compilador haya terminado.

Así que todo lo que sigue describe lo que el recurso personalizado renderizado pide. Lo que un clúster en ejecución acaba conteniendo es la respuesta del controlador a esa petición, en un momento que el compilador nunca ve — y el compilador no afirma nada al respecto, porque no tiene forma de mirar.

Lo único que varía

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

Ambas Releases seleccionan el mismo Component y la misma Recipe, así que hay un solo Manifest, no uno por Release. Cuando dos Releases solo difieren en el dimensionamiento, la asignación de Ops no tiene nada que decir sobre la diferencia, y una segunda copia de ella sería una segunda cosa que mantener sincronizada sin ninguna ganancia.

Archivos

  • aggregate.yaml — intención del desarrollador, y el mismo documento para ambas Releases: un componente mysql-operator para el plano de control, un componente db de tipo core/datastore/mysql-innodb-cluster, y el juego de caracteres que el desarrollador quiere que hable el servidor. Nada aquí dice cuántos servidores hay.
  • manifest.yaml — la asignación de Ops, compartida por ambas Releases. Dos líneas: qué Recipe realiza el plano de control y cuál realiza la base de datos.
  • release-single.yaml, release-replicated.yaml — el dimensionamiento del operador. Difieren en su metadata.name y en server_instances, y todos los demás campos se mantienen iguales a propósito para que una línea sea toda la diferencia.
  • .aggrega-config.yaml — nombra el registro del hub desde el que se resuelve el catálogo de la biblioteca estándar. Este ejemplo no escribe entidades propias.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

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

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd mysql-innodb-cluster

Compilación

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

--auto-pull escribe durante la compilación el lockfile que le falta a un clon nuevo. Cada compilación escribe en dist/, y una compilación añade sus archivos en lugar de borrar lo que dejó una anterior. Elimina dist/ entre ejecuciones para leer por separado la salida de una Release:

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

Cada Release renderiza cinco archivos: el recurso personalizado de la base de datos, y los cuatro que levantan el plano de control.

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

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `mysql-innodb-cluster`, llama una vez a la herramienta `scaffold` con `example` establecido en `mysql-innodb-cluster` y sin `dir`: escribe el ejemplo en una nueva carpeta `mysql-innodb-cluster`. Después llama a la herramienta `build` una vez por cada Release, en este orden — `release-single.yaml` y `release-replicated.yaml` —, cada vez con `workspace_root` establecido en `mysql-innodb-cluster`, `release` establecido en ese archivo, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió cada compilación; están en `mysql-innodb-cluster/dist/`.

En qué se renderiza la base de datos

# 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

El archivo renderizado también lleva las etiquetas y anotaciones que Aggrega pone en cada artefacto que renderiza — de qué Aggregate procede, qué componente, qué Recipe, qué límite — omitidas aquí para mantener a la vista la propia petición.

Cuatro de esas cinco entradas de spec se remontan directamente a algo escrito: instances al server_instances de la Release, version al valor predeterminado engine_version del Component, secretName al credentials_secret de la Release, y el bloque mycnf a charset y collation del desarrollador. La quinta, router.instances, se trata más abajo.

La comparación que es el objetivo

Toda la diferencia entre los dos árboles renderizados:

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

Una línea, en uno de los cinco archivos. Los cuatro archivos del plano de control son idénticos byte a byte entre las dos Releases: el controlador que reconcilia una petición de una instancia y el controlador que reconcilia una petición de tres instancias son el mismo controlador, así que nada en él se mueve.

El número de enrutadores tampoco se mueve, y no es un ajuste que este componente ofrezca libremente. La dirección que publica el componente es el Service en el que responden los enrutadores, así que el número se expone en el valor predeterminado propio del recurso personalizado y nunca por debajo. Es un tope de lo que una Release puede pedir en lugar de un tamaño que este ejemplo varía, por eso la línea aparece en el diff de arriba sin cambiar.

El plano de control

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]

Ninguna Release nombra una imagen. La referencia procede del valor predeterminado infra.image del propio Component, así que una Release que no establece nada sigue renderizando un Deployment con una versión indicada en lugar de uno que haya que completar antes de poder aplicarlo. Un destino que descarga de su propio espejo de registro establece infra.image en la Release y obtiene esa referencia en su lugar.

El plano de control se declara en el Aggregate, junto a la base de datos, porque un recurso personalizado por sí solo es inerte: solo se convierte en un servidor en ejecución cuando un controlador lo está vigilando. Declarar ambos juntos es lo que permite aplicarlos como una sola unidad.

El requisito previo se afirma, nunca se descubre

El compilador se ejecuta de antemano y nunca contacta con un clúster, así que no puede comprobar si el controlador está instalado. En su lugar, lo pregunta. Deja control_plane_present sin establecer y la compilación se detiene:

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

No se escribe nada. Un recurso personalizado que nadie reconcilia no es un éxito menor que uno que funciona — es un artefacto que se aplica sin errores y luego se queda ahí, así que la compilación se niega a producirlo y nombra la clave que diría lo contrario.

La cuenta root

Ambas Releases apuntan aquí el clúster a un Secret que ya existe en el clúster de destino:

db:
infra:
credentials_secret: mysql-root

No se renderiza nada para ese Secret y ninguna contraseña llega a la salida — el recurso personalizado lleva el nombre y el controlador lee la cuenta de él. Establecer en cambio infra.credentials en generated renderiza el Secret junto al recurso personalizado a partir de una credencial vinculada al slot root_password del componente, lo que pone la contraseña en la salida renderizada y es la elección correcta cuando la salida es lo que aprovisiona el clúster.

Lo que esta realización no crea es una base de datos lógica ni un usuario de aplicación. El controlador establece la cuenta root del clúster y nada por debajo de ella, así que los esquemas y cuentas que necesita una aplicación los crea quien tenga root.

Qué realización elegir

Elige core/datastore/mysql y su Recipe sintetizada cuando nada pueda necesitar instalarse primero — no necesita ningún controlador en el clúster ni ningún repositorio de charts al que llegar, así que se compila sin descargar nada, y crea la base de datos lógica y el rol de acceso que pide una aplicación. Elige core/datastore/mysql-innodb-cluster cuando el destino ya ejecuta el plano de control del MySQL Operator, o lo instala como hace este ejemplo, y lo que necesita la aplicación es acceso root a un clúster en una dirección interna del clúster.

La forma de servidor único de la realización sintetizada se desarrolla en ../mysql-standalone/, y no se repite aquí.

Dónde está la costura

El documento del desarrollador no se vio afectado por la elección entre una instancia y tres, y tampoco la asignación de Ops. Esa es la división que este ejemplo existe para hacer concreta:

  • el desarrollador dice qué necesita la aplicación de una base de datos;
  • Ops dice de qué está hecha una base de datos — qué Recipe la realiza;
  • el operador dice qué tamaño tiene esta.

Cambia server_instances a cualquier valor que acepte el recurso personalizado y el aggregate.yaml de este directorio no se mueve.