sql-server-samples/samples/features/sql-big-data-cluster/deployment/kubeadm/README.md

Create a Kubernetes cluster using Kubeadm on Ubuntu 16.04 LTS or 18.04 LTS

In this example, we will deploy Kubernetes over multiple Linux machines (physical or virtualized) using kubeadm utility. These instructions have been tested primarily with Ubuntu 16.04 LTS version. If you are using Ubuntu 18.04 LTS then install of docker.io may fail with message below depending on your configuration.

Package docker.io is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source

E: Package 'docker.io' has no installation candidate

To install docker, you can follow the steps below:

#!/usr/bin/env bash

sudo apt update

sudo apt --yes install \
    software-properties-common \
    apt-transport-https \
    ca-certificates \
    curl

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository \
    "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

sudo apt update

sudo apt --yes install docker-ce

sudo usermod --append --groups docker $USER

Pre-requisites

1. Multiple Linux machines or virtual machines. Recommended configuration is 8 CPUs, 32 GB memory each and at least 100 GB storage for each machine. Minimum number of machines required is three machines
2. Designate one machine as the Kubernetes master
3. Rest of the machines will be used as the Kubernetes agents

Useful resources

Deploy SQL Server 2019 big data cluster on Kubernetes

Creating a cluster using kubeadm

Troubleshooting kubeadm

Instructions

1. Start a sudo shell context
2. Execute ubuntu/setup-k8s-prereqs.sh script on each machine
3. Execute ubuntu/setup-k8s-master.sh script on the machine designated as Kubernetes master
4. After successful initialization of the Kubernetes master, follow the kubeadm join commands output by the setup script on each agent machine
5. Execute ubuntu/setup-volumes-agent.sh script on each agent machine to create volumes for local storage

NOTE: Ensure there is sufficient local storage on your agents. Each volume will use up to 6GB by default. The script creates 25 volumes. Not all of the volumes will be used since it depends on the number of pods being deployed on each agent node. It is recommended to have at least 200 GB of storage on the agent nodes

1. Execute kubectl apply -f ubuntu/local-storage-provisioner.yaml against the Kubernetes cluster to create the local storage provisioner. You can now use persistent volumes by setting the USE_PERSISTENT_VOLUME environment variable to true and STORAGE_CLASS_NAME environment variable to local-storage during deployment
2. Now, you can deploy the SQL Server 2019 big data cluster following instructions here