Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Um Aggregate, dois tamanhos de cluster MySQL

Um MySQL InnoDB Cluster e o plano de controlo que o reconcilia, compilados duas vezes a partir de um único Aggregate inalterado: uma vez a pedir uma única instância de servidor, outra a pedir três.

A lição está no sítio onde vive o tamanho. Quantos servidores estão por trás da base de dados não é algo que o programador tenha escrito nem algo que a Recipe tenha decidido — é 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. Não emite servidores, Services nem routers: o MySQL Operator for Kubernetes cria-os dentro do cluster de destino depois de o recurso personalizado ser aplicado, um trabalho que acontece muito depois de o compilador ter terminado.

Portanto, tudo o que se segue descreve o que o recurso personalizado renderizado pede. O que um cluster em execução acaba por conter é a resposta do controlador a esse pedido, num momento que o compilador nunca vê — e o compilador não faz nenhuma afirmação sobre isso, porque não tem forma de 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: 3

Ambas as Releases selecionam o mesmo Component e a mesma Recipe, pelo que há um único Manifest, e 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 em sintonia sem qualquer ganho.

Ficheiros

  • aggregate.yaml — intenção do programador, e o mesmo documento para ambas as Releases: um componente mysql-operator para o plano de controlo, um componente db do tipo core/datastore/mysql-innodb-cluster, e o conjunto de caracteres que o programador quer que o servidor fale. Nada aqui diz quantos servidores existem.
  • manifest.yaml — o mapeamento de Ops, partilhado por ambas as Releases. Duas linhas: que Recipe realiza o plano de controlo e qual realiza a base de dados.
  • release-single.yaml, release-replicated.yaml — o dimensionamento do operador. Diferem no seu metadata.name e em server_instances, e todos os outros campos são mantidos iguais de propósito, para que uma linha seja toda a diferença.
  • .aggrega-config.yaml — nomeia o registo 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

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

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

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd mysql-innodb-cluster

Compilação

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

--auto-pull escreve durante a compilação o lockfile que falta a um clone acabado de criar. Cada compilação escreve em dist/, e uma compilação acrescenta os seus ficheiros em vez de limpar o que uma anterior deixou. Remova-se dist/ entre execuções para ler isoladamente a saída de uma Release:

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

Cada Release renderiza cinco ficheiros: o recurso personalizado da base de dados e os quatro que põem de pé o plano de controlo.

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

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta da área de trabalho ainda não contiver uma pasta `mysql-innodb-cluster`, chame uma vez a ferramenta `scaffold` com `example` definido como `mysql-innodb-cluster` e sem `dir`: esta escreve o exemplo numa nova pasta `mysql-innodb-cluster`. Em seguida, chame a ferramenta `build` uma vez para cada Release, por esta ordem — `release-single.yaml` e `release-replicated.yaml` —, de cada vez com `workspace_root` definido como `mysql-innodb-cluster`, `release` definido como esse ficheiro, `auto_pull` definido como true e `write` definido como true. Indique quais os ficheiros que cada compilação escreveu; encontram-se em `mysql-innodb-cluster/dist/`.

Em que é renderizada a base de dados

# 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

O ficheiro renderizado traz também as etiquetas e as anotações que o Aggrega coloca em todos os artefactos que renderiza — de que Aggregate veio, que componente, que Recipe, que fronteira — omitidas aqui para manter à vista o próprio pedido.

Quatro dessas cinco entradas de spec remontam diretamente a algo escrito: instances ao server_instances da Release, version ao valor predefinido engine_version do Component, secretName ao credentials_secret da Release, e o bloco mycnf a charset e collation do programador. A quinta, router.instances, é discutida mais abaixo.

A comparação que é o essencial

Toda a diferença 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: 1

Uma linha, num dos cinco ficheiros. Os quatro ficheiros do plano de controlo 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, pelo que nada nele se move.

A contagem de routers também não se move, e não é um ajuste que este componente ofereça livremente. O endereço que o componente publica é o Service no qual os routers respondem, pelo que a contagem é exposta no próprio valor predefinido do recurso personalizado e nunca abaixo dele. Isto é um limite ao que uma Release pode pedir, e não um tamanho que este exemplo faça variar, e é por isso que a linha aparece no diff acima sem mudar.

O plano de controlo

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]

Nenhuma Release nomeia uma imagem. A referência vem do próprio valor predefinido infra.image do Component, pelo que uma Release que não defina nada renderiza ainda assim um Deployment com uma versão indicada, em vez de um que tenha de ser preenchido antes de poder ser aplicado. Um destino que obtém imagens do seu próprio espelho de registo define infra.image na Release e recebe essa referência em vez disso.

O plano de controlo é declarado no Aggregate, ao lado da base de dados, porque um recurso personalizado por si só é inerte: só se torna um servidor em execução quando um controlador o está a observar. Declarar ambos em conjunto é o que permite aplicá-los como uma única unidade.

O pré-requisito é afirmado, nunca descoberto

O compilador é executado antecipadamente e nunca contacta um cluster, pelo que não consegue verificar se o controlador está instalado. Em vez disso, pergunta. Deixe-se control_plane_present por definir e a compilação 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 Release

Nada é escrito. Um recurso personalizado que ninguém está a reconciliar não é um sucesso menor do que um que funciona — é um artefacto que é aplicado sem erros e depois fica ali parado, pelo que a compilação se recusa a produzi-lo e nomeia a chave que diria o contrário.

A conta root

Ambas as Releases aqui apontam o cluster para um Secret que já existe no cluster de destino:

db:
infra:
credentials_secret: mysql-root

Nada é renderizado para esse Secret e nenhuma palavra-passe 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 anexada ao slot root_password do componente, o que coloca a palavra-passe na saída renderizada e é a escolha certa quando é a saída que aprovisiona o cluster.

O que esta realização não cria é uma base de dados lógica nem um utilizador de aplicação. O controlador estabelece a conta root do cluster e nada abaixo dela, pelo que os esquemas e as contas de que uma aplicação precisa são criados por quem detém o root.

Que realização escolher

Escolha-se core/datastore/mysql e a sua Recipe sintetizada quando nada possa precisar de ser instalado primeiro — não precisa de nenhum controlador no cluster nem de nenhum repositório de charts a alcançar, pelo que compila sem obter nada, e cria a base de dados lógica e o papel de início de sessão que uma aplicação pede. Escolha-se core/datastore/mysql-innodb-cluster quando o destino já executa o plano de controlo do MySQL Operator, ou o instala como este exemplo faz, e aquilo de que a aplicação precisa é de acesso root a um cluster num 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 programador não foi tocado pela escolha entre uma instância e três, nem o mapeamento de Ops. Essa é a divisão que este exemplo existe para tornar concreta:

  • o programador diz de que a aplicação precisa de uma base de dados;
  • Ops diz de que é feita uma base de dados — que Recipe a realiza;
  • o operador diz qual é o tamanho desta.

Altere-se server_instances para qualquer valor que o recurso personalizado aceite e o aggregate.yaml neste diretório não se move.