Vitess Operator for Kubernetes
PlanetScale provides a Vitess Operator for Kubernetes, released under the Apache 2.0 license. The following steps show how to get started using Minikube:
Before we get started, let’s get a few pre-requisites out of the way:
Install Minikube and start a Minikube engine:
minikube start --kubernetes-version=v1.19.16 --cpus=4 --memory=4000 --disk-size=32g
Install kubectl and ensure it is in your
Install the MySQL client locally.
Install vtctlclient locally.
Install the Operator #
Change to the operator example directory:
git clone https://github.com/vitessio/vitess cd vitess/examples/operator
Install the operator:
kubectl apply -f operator.yaml
Bring up an initial cluster #
In this directory, you will see a group of yaml files. The first digit of each file name indicates the phase of example. The next two digits indicate the order in which to execute them. For example,
101_initial_cluster.yaml is the first file of the first phase. We shall execute that now:
kubectl apply -f 101_initial_cluster.yaml
We have supplied an example yaml for bringing up Vitess with the experimental vtorc component. You can try this out by using the following command:
kubectl apply -f vtorc_example.yaml. Once
vtorc is officially released, the examples will be updated accordingly.
After the port forwarding is setup, you are required to run
SetKeyspaceDurabilityPolicy with the desired durability policy and restart VTOrc.
Verify cluster #
You can check the state of your cluster with
kubectl get pods. After a few minutes, it should show that all pods are in the status of running:
$ kubectl get pods NAME READY STATUS RESTARTS AGE example-etcd-faf13de3-1 1/1 Running 0 78s example-etcd-faf13de3-2 1/1 Running 0 78s example-etcd-faf13de3-3 1/1 Running 0 78s example-vttablet-zone1-2469782763-bfadd780 3/3 Running 1 78s example-vttablet-zone1-2548885007-46a852d0 3/3 Running 1 78s example-zone1-vtctld-1d4dcad0-59d8498459-kwz6b 1/1 Running 2 78s example-zone1-vtgate-bc6cde92-6bd99c6888-vwcj5 1/1 Running 2 78s vitess-operator-8454d86687-4wfnc 1/1 Running 0 2m29s
Setup Port-forward #
kubectldoes not automatically terminate a port-forward as the pod disappears due to apply/upgrade operations. You will need to manually restart the port-forward.
For ease-of-use, Vitess provides a script to port-forward from Kubernetes to your local machine. This script also recommends setting up aliases for
./pf.sh & alias vtctlclient="vtctlclient --server=localhost:15999" alias mysql="mysql -h 127.0.0.1 -P 15306 -u user"
Setting up aliases changes
mysql to always connect to Vitess for your current session. To revert this, type
unalias mysql && unalias vtctlclient or close your session.
Create Schema #
Load our initial schema:
vtctlclient ApplySchema -- --sql="$(cat create_commerce_schema.sql)" commerce vtctlclient ApplyVSchema -- --vschema="$(cat vschema_commerce_initial.json)" commerce
Connect to your cluster #
You should now be able to connect to the VTGate Server in your cluster with the MySQL client:
~/vitess/examples/operator$ mysql Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 3 Server version: 5.7.9-Vitess MySQL Community Server (GPL) Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. mysql> show databases; +-----------+ | Databases | +-----------+ | commerce | +-----------+ 1 row in set (0.00 sec)
In this example, we deployed a single unsharded keyspace named
commerce. Unsharded keyspaces have a single shard named
0. The following schema reflects a common ecommerce scenario that was created by the script:
create table product( sku varbinary(128), description varbinary(128), price bigint, primary key(sku) ); create table customer( customer_id bigint not null auto_increment, email varbinary(128), primary key(customer_id) ); create table corder( order_id bigint not null auto_increment, customer_id bigint, sku varbinary(128), price bigint, primary key(order_id) );
The schema has been simplified to include only those fields that are significant to the example:
producttable contains the product information for all of the products.
customertable has a
customer_idthat has an
auto_increment. A typical customer table would have a lot more columns, and sometimes additional detail tables.
cordertable (named so because
orderis an SQL reserved word) has an
order_idauto-increment column. It also has foreign keys into
Next Steps #
You can now proceed with MoveTables.
Or alternatively, if you would like to teardown your example:
kubectl delete -f 101_initial_cluster.yaml
Congratulations on completing this exercise!