コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

1 つの Aggregate で 2 つのサイズの MySQL クラスタ

MySQL InnoDB Cluster と、それを調整するコントロールプレーンを、変更していない 1 つの Aggregate から 2 回ビルドします。1 回は単一のサーバーインスタンスを要求し、もう 1 回は 3 つを要求します。

ここで学ぶのは、サイズがどこにあるかです。 データベースの背後に何台のサーバーがあるかは、開発者が書いたものでも Recipe が決めたものでもありません。それは Release にあるオペレーターによるサイジングの 1 行であり、レンダリングされた 2 つのツリーの違いはそれだけです。

コンパイラが書き出すもの、書き出さないもの

この実現は InnoDBCluster カスタムリソースを出力します。サーバー、Service、ルーターは出力しません。それらはカスタムリソースが適用された後に、MySQL Operator for Kubernetes がターゲットクラスタ内で作成します。これはコンパイラが処理を終えてからずっと後に行われる作業です。

したがって、以下の説明はすべて、レンダリングされたカスタムリソースが何を要求するかについてのものです。実行中のクラスタが最終的に何を含むかは、その要求に対するコントローラーの回答であり、コンパイラが決して目にしない時点で決まります。コンパイラはそれについて何も主張しません。確認する手段がないからです。

唯一変化するもの

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

どちらの Releases も同じ Component と同じ Recipe を選択するため、Manifest は 1 つであり、Release ごとに 1 つではありません。2 つの Releases がサイジングだけで異なる場合、Ops のマッピングはその違いについて何も言うことがなく、その 2 つ目のコピーは、何の利点もなく同期を保つ対象を 1 つ増やすだけです。

ファイル

  • aggregate.yaml — 開発者の意図であり、両方の Releases で同じドキュメントです。コントロールプレーン用の mysql-operator コンポーネント、型が core/datastore/mysql-innodb-cluster の db コンポーネント、そして開発者がサーバーに使わせたい文字セットを含みます。サーバーが何台あるかについては、ここには何も書かれていません。
  • manifest.yaml — 両方の Releases で共有される Ops のマッピングです。2 行だけで、どの Recipe がコントロールプレーンを実現し、どれがデータベースを実現するかを示します。
  • release-single.yaml、release-replicated.yaml — オペレーターによるサイジングです。違いは metadata.name と server_instances だけであり、他のすべてのフィールドは、1 行だけが違いとなるよう意図的に同じにしてあります。
  • .aggrega-config.yaml — 標準ライブラリのカタログの解決元となる hub レジストリを指定します。この例では独自のエンティティを作成しません。

サンプルを生成する

このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

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

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd mysql-innodb-cluster

ビルド

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

--auto-pull は、新しいクローンにはない lockfile をビルド中に書き出します。各ビルドは dist/ に書き出し、ビルドは以前のビルドが残したものを消去せずにファイルを追加します。1 つの Release の出力だけを確認するには、実行の間に dist/ を削除してください。

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

各 Release は 5 つのファイルをレンダリングします。データベースのカスタムリソースと、コントロールプレーンを立ち上げる 4 つのファイルです。

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

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `mysql-innodb-cluster` フォルダーがない場合は、`example` を `mysql-innodb-cluster` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。これにより、例が新しい `mysql-innodb-cluster` フォルダーに書き込まれます。次に、`release-single.yaml`、`release-replicated.yaml` の順に、各 Release について `build` ツールを一度ずつ呼び出してください。毎回、`workspace_root` を `mysql-innodb-cluster`、`release` をそのファイル、`auto_pull` を true、`write` を true に設定します。各ビルドが書き込んだファイルを教えてください。ファイルは `mysql-innodb-cluster/dist/` の下にあります。

データベースのレンダリング結果

# 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

レンダリングされたファイルには、Aggrega がレンダリングするすべての成果物に付けるラベルとアノテーション(どの Aggregate に由来するか、どのコンポーネント、どの Recipe、どの境界か)も含まれますが、要求そのものに注目できるよう、ここでは省略しています。

5 つの spec エントリのうち 4 つは、作成されたものに直接たどれます。instances は Release の server_instances に、version は Component の engine_version のデフォルトに、secretName は Release の credentials_secret に、mycnf ブロックは開発者の charset と collation に対応します。5 つ目の router.instances については後述します。

要点となる比較

レンダリングされた 2 つのツリーの違いのすべて:

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

5 つのファイルのうち 1 つにある 1 行です。 コントロールプレーンの 4 つのファイルは、2 つの Releases の間でバイト単位で同一です。1 インスタンスの要求を調整するコントローラーと 3 インスタンスの要求を調整するコントローラーは同じコントローラーなので、それに関しては何も変わりません。

ルーターの数も変わりません。また、これはこのコンポーネントが自由に調整できる値ではありません。 コンポーネントが公開するアドレスはルーターが応答する Service なので、その数はカスタムリソース自体のデフォルト値で公開され、それを下回ることはありません。これはこの例で変化させるサイズではなく、Release が要求できる範囲の制限です。そのため、この行は上の差分の中で変化せずに存在しています。

コントロールプレーン

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]

どちらの Release もイメージを指定していません。 参照は Component 自身の infra.image のデフォルト値から来るため、何も設定しない Release でも、適用前に値を埋める必要がある Deployment ではなく、1 つのバージョンが指定された Deployment がレンダリングされます。独自のレジストリミラーからプルするターゲットは、Release で infra.image を設定すれば、代わりにその参照が使われます。

コントロールプレーンは、Aggregate の中でデータベースと並べて宣言されます。カスタムリソースはそれ単体では何もせず、コントローラーが監視して初めて実行中のサーバーになるからです。両方をまとめて宣言することで、2 つを 1 つの単位として適用できます。

前提条件は検出されず、宣言される

コンパイラは事前に実行され、クラスタに接続することはないため、コントローラーがインストールされているかどうかを確認できません。代わりに問い合わせます。control_plane_present を未設定のままにすると、ビルドは停止します。

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

何も書き出されません。誰も調整していないカスタムリソースは、動作するものより小さな成功ではありません。それは問題なく適用された後、ただそこに置かれたままになる成果物です。そのため、ビルドはそれを生成することを拒否し、そうでないことを示すキーの名前を挙げます。

root アカウント

ここでは、どちらの Releases も、ターゲットクラスタにすでに存在する Secret をクラスタに指定しています。

db:
infra:
credentials_secret: mysql-root

その Secret については何もレンダリングされず、パスワードが出力に含まれることもありません。カスタムリソースが名前を持ち、コントローラーがそこからアカウントを読み取ります。代わりに infra.credentials を generated に設定すると、コンポーネントの root_password スロットに付与された認証情報から、カスタムリソースと並べて Secret がレンダリングされます。これによりパスワードがレンダリング出力に含まれますが、出力そのものがクラスタをプロビジョニングする場合にはこれが適切な選択です。

この実現が作成しないものは、論理データベースとアプリケーションユーザーです。コントローラーはクラスタの root アカウントを確立しますが、その下のものは何も作成しません。そのため、アプリケーションが必要とするスキーマとアカウントは、root を持つ人が作成します。

どの実現を選ぶか

事前に何もインストールする必要がないようにしたい場合は、core/datastore/mysql とその合成された Recipe を選びます。 クラスタ内のコントローラーも、アクセスするチャートリポジトリも不要なため、何も取得せずにビルドでき、アプリケーションが要求する論理データベースとログインロールを作成します。ターゲットですでに MySQL Operator のコントロールプレーンが実行されている場合、またはこの例のようにそれをインストールする場合で、アプリケーションに必要なのがクラスタ内アドレスにあるクラスタへの root アクセスであるときは、core/datastore/mysql-innodb-cluster を選びます。

合成された実現の単一サーバー構成は ../mysql-standalone/ で詳しく説明しているため、ここでは繰り返しません。

境界線はどこにあるか

1 インスタンスか 3 インスタンスかの選択によって、開発者のドキュメントは変更されず、Ops のマッピングも変更されませんでした。これが、この例が具体的に示そうとしている分担です。

  • 開発者は アプリケーションがデータベースに何を必要とするか を示します。
  • Ops は データベースが何で構成されるか、つまりどの Recipe がそれを実現するかを示します。
  • オペレーターは このデータベースがどれだけの大きさか を示します。

server_instances をカスタムリソースが受け付ける任意の値に変更しても、このディレクトリの aggregate.yaml は変わりません。