Um Aggregate, dois tamanhos de cluster MySQL
Um MySQL InnoDB Cluster e o plano de controle que o reconcilia, compilados duas vezes a partir de um único Aggregate inalterado: uma vez pedindo uma única instância de servidor, outra vez pedindo três.
A lição é onde o tamanho mora. Quantos servidores ficam atrás do banco de dados não é algo que o desenvolvedor escreveu nem algo que a Recipe decidiu — é uma linha de dimensionamento do operador na Release, e é tudo o que difere entre as duas árvores renderizadas.
O que o compilador escreve, e o que não escreve
Esta realização emite um recurso personalizado InnoDBCluster. Ela não emite servidores, Services nem roteadores: o MySQL Operator for Kubernetes os cria dentro do cluster de destino depois que o recurso personalizado é aplicado, um trabalho que acontece muito depois de o compilador ter terminado.
Portanto, tudo o que segue descreve o que o recurso personalizado renderizado pede. O que um cluster em execução acaba contendo é a resposta do controlador a esse pedido, em um momento que o compilador nunca vê — e o compilador não faz nenhuma afirmação sobre isso, porque não tem como olhar.
A única coisa que varia
.-- release-single.yaml ----- spec.instances: 1 /one Aggregate -- one Manifest -+one Component \one Recipe '- release-replicated.yaml -- spec.instances: 3As duas Releases selecionam o mesmo Component e a mesma Recipe, então há um único Manifest, não um por Release. Quando duas Releases diferem apenas no dimensionamento, o mapeamento de Ops não tem nada a dizer sobre a diferença, e uma segunda cópia dele seria uma segunda coisa a manter sincronizada sem nenhum ganho.
Arquivos
aggregate.yaml— intenção do desenvolvedor, e o mesmo documento para as duas Releases: um componentemysql-operatorpara o plano de controle, um componentedbdo tipocore/datastore/mysql-innodb-cluster, e o conjunto de caracteres que o desenvolvedor quer que o servidor fale. Nada aqui diz quantos servidores existem.manifest.yaml— o mapeamento de Ops, compartilhado pelas duas Releases. Duas linhas: qual Recipe realiza o plano de controle e qual realiza o banco de dados.release-single.yaml,release-replicated.yaml— o dimensionamento do operador. Elas diferem no seumetadata.namee emserver_instances, e todos os outros campos são mantidos iguais de propósito, para que uma linha seja a diferença inteira..aggrega-config.yaml— nomeia o registro do hub a partir do qual o catálogo da biblioteca padrão é resolvido. Este exemplo não escreve nenhuma entidade própria.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example mysql-innodb-clusterEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd mysql-innodb-clusterBuild
aggrega build --release release-single.yaml --auto-pullaggrega build --release release-replicated.yaml --auto-pull--auto-pull grava durante o build o lockfile que falta em um clone novo. Cada build grava em dist/, e um build adiciona os seus arquivos em vez de limpar o que um anterior deixou. Remova dist/ entre as execuções para ler isoladamente a saída de uma Release:
rm -rf dist && aggrega build --release release-replicated.yaml --auto-pullCada Release renderiza cinco arquivos: o recurso personalizado do banco de dados e os quatro que colocam o plano de controle de pé.
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.yamlCom um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `mysql-innodb-cluster`, chame a ferramenta `scaffold` uma vez com `example` definido como `mysql-innodb-cluster` e sem `dir`: ela grava o exemplo em uma nova pasta `mysql-innodb-cluster`. Depois chame a ferramenta `build` uma vez para cada Release, nesta ordem — `release-single.yaml` e `release-replicated.yaml` —, cada vez com `workspace_root` definido como `mysql-innodb-cluster`, `release` definido como esse arquivo, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos cada build gravou; eles ficam em `mysql-innodb-cluster/dist/`.No que o banco de dados é renderizado
# 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_ciO arquivo renderizado também traz os rótulos e as anotações que o Aggrega coloca em todo artefato que renderiza — de qual Aggregate ele veio, qual componente, qual Recipe, qual fronteira — omitidos aqui para manter o próprio pedido à vista.
Quatro dessas cinco entradas de spec remontam diretamente a algo escrito: instances ao server_instances da Release, version ao valor padrão engine_version do Component, secretName ao credentials_secret da Release, e o bloco mycnf a charset e collation do desenvolvedor. A quinta, router.instances, é discutida abaixo.
A comparação que é o ponto central
A diferença inteira entre as duas árvores renderizadas:
--- dist/stack/helm/db/innodbcluster.yaml (single)+++ dist/stack/helm/db/innodbcluster.yaml (replicated) spec:- instances: 1+ instances: 3 router: instances: 1Uma linha, em um dos cinco arquivos. Os quatro arquivos do plano de controle são idênticos byte a byte entre as duas Releases: o controlador que reconcilia um pedido de uma instância e o controlador que reconcilia um pedido de três instâncias são o mesmo controlador, então nada nele se move.
A contagem de roteadores também não se move, e não é um ajuste que este componente oferece livremente. O endereço que o componente publica é o Service no qual os roteadores respondem, então a contagem é exposta no próprio valor padrão do recurso personalizado e nunca abaixo dele. Isso é um limite para o que uma Release pode pedir, e não um tamanho que este exemplo varia, e é por isso que a linha aparece no diff acima sem mudar.
O plano de controle
[… 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]Nenhuma Release nomeia uma imagem. A referência vem do próprio valor padrão infra.image do Component, então uma Release que não define nada ainda renderiza um Deployment com uma versão definida, em vez de um que precise ser preenchido antes de poder ser aplicado. Um destino que baixa do seu próprio espelho de registro define infra.image na Release e recebe essa referência em vez disso.
O plano de controle é declarado no Aggregate, ao lado do banco de dados, porque um recurso personalizado sozinho é inerte: ele só se torna um servidor em execução quando um controlador o está observando. Declarar os dois juntos é o que permite que sejam aplicados como uma única unidade.
O pré-requisito é afirmado, nunca descoberto
O compilador é executado antecipadamente e nunca contata um cluster, então não consegue verificar se o controlador está instalado. Em vez disso, ele pergunta. Deixe control_plane_present sem definir e o build para:
[… 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 ReleaseNada é gravado. Um recurso personalizado que ninguém está reconciliando não é um sucesso menor do que um que funciona — é um artefato que é aplicado sem erros e depois fica parado ali, então o build se recusa a produzi-lo e nomeia a chave que diria o contrário.
A conta root
As duas Releases aqui apontam o cluster para um Secret que já existe no cluster de destino:
db: infra: credentials_secret: mysql-rootNada é renderizado para esse Secret e nenhuma senha chega à saída — o recurso personalizado traz o nome e o controlador lê a conta a partir dele. Definir infra.credentials como generated em vez disso renderiza o Secret ao lado do recurso personalizado a partir de uma credencial vinculada ao slot root_password do componente, o que coloca a senha na saída renderizada e é a escolha certa quando a saída é o que provisiona o cluster.
O que esta realização não cria é um banco de dados lógico nem um usuário de aplicação. O controlador estabelece a conta root do cluster e nada abaixo dela, então os esquemas e as contas de que uma aplicação precisa são criados por quem detém o root.
Qual realização escolher
Escolha core/datastore/mysql e a sua Recipe sintetizada quando nada puder precisar ser instalado antes — ela não precisa de nenhum controlador no cluster nem de nenhum repositório de charts a alcançar, então compila sem baixar nada, e cria o banco de dados lógico e o papel de login que uma aplicação pede. Escolha core/datastore/mysql-innodb-cluster quando o destino já executa o plano de controle do MySQL Operator, ou o instala como este exemplo faz, e o que a aplicação precisa é de acesso root a um cluster em um endereço interno ao cluster.
A forma de servidor único da realização sintetizada é detalhada em ../mysql-standalone/, e não é repetida aqui.
Onde fica a costura
O documento do desenvolvedor não foi tocado pela escolha entre uma instância e três, e o mapeamento de Ops também não. Essa é a divisão que este exemplo existe para tornar concreta:
- o desenvolvedor diz do que a aplicação precisa de um banco de dados;
- Ops diz do que um banco de dados é feito — qual Recipe o realiza;
- o operador diz qual é o tamanho deste.
Altere server_instances para qualquer valor que o recurso personalizado aceite e o aggregate.yaml neste diretório não se move.