vitess-gh/doc/DockerBuild.md

By default, the Helm Charts point to the vitess/lite image on Docker Hub.

We created the lite image as a stripped down version of our old image base such that Kubernetes pods can start faster. The lite image is updated automatically after every push to the GitHub main branch.

For more information on the different images we provide, please read the docker/README.md file.

If your goal is run the latest Vitess code, the simplest solution is to use the lite.

Another alternative is to customize our Docker images and build them yourselves. This is described below and involves building the base image first. Then you can run our build script for the lite image which extracts the Vitess binaries from the built base image.

1. Install Docker on your workstation.

   Our scripts also assume you can run the docker command without sudo, which you can do by setting up a docker group.

2. Create an account on Docker Hub and then docker login to it.

3. Go to your src/vitess.io/vitess directory.

4. Usually, you won't need to build your own bootstrap image unless you edit bootstrap.sh or vendor.json, for example to add new dependencies. If you do need it then build the bootstrap image, otherwise pull the image using one of the following commands depending on the MySQL flavor you want:

   vitess$ docker pull vitess/bootstrap:mysql57   # MySQL Community Edition 5.7
   vitess$ docker pull vitess/bootstrap:mysql56   # MySQL Community Edition 5.6
   vitess$ docker pull vitess/bootstrap:percona57 # Percona Server 5.7
   vitess$ docker pull vitess/bootstrap:percona   # Percona Server
   vitess$ docker pull vitess/bootstrap:mariadb   # MariaDB
   

   Note: If you have already downloaded the vitess/bootstrap:<flavor> image on your machine before then it could be old, which may cause build failures. So it would be a good idea to always execute this step.

5. Build the vitess/base[:<flavor>] image. It will include the compiled the Vitess binaries. (vitess/base also contains the source code and tests i.e. everything needed for development work.)

   Choose one of the following commands (the command without suffix builds the default image containing MySQL 5.7):

   vitess$ make docker_base
   vitess$ make docker_base_mysql56
   vitess$ make docker_base_percona57
   vitess$ make docker_base_percona
   vitess$ make docker_base_mariadb
   

6. Build the vitess/lite[:<flavor>] image. This will run a script that extracts from vitess/base only the files needed to run Vitess.

   Choose one of the following commands (the command without suffix builds the default image containing MySQL 5.7):

   vitess$ make docker_lite
   vitess$ make docker_lite_mysql56
   vitess$ make docker_lite_percona57
   vitess$ make docker_lite_percona
   vitess$ make docker_lite_mariadb
   

7. Re-tag the image under your personal repository, then upload it.

   vitess$ docker tag -f vitess/lite yourname/vitess
   vitess$ docker push yourname/vitess
   

   Note: If you chose a non-default flavor above, then change vitess/lite in the above command to vitess/lite:<flavor>.

8. Launch Vitess on Kubernetes as usual.