147 lines
4.7 KiB
Markdown
147 lines
4.7 KiB
Markdown
\newpage
|
|
|
|
Mise en place
|
|
=============
|
|
|
|
La mise en place d'un cluster Kubernetes est une opération très longue, car
|
|
elle nécessite l'installation et la configuration de nombreux composants.
|
|
Cette opération n'étant pas très palpitante, nous ne la verrons pas
|
|
aujourd'hui.
|
|
|
|
Pour jouer aujourd'hui, deux solutions s'offrent à nous :
|
|
|
|
Kubernetes in Docker (kind)
|
|
---------------------------
|
|
|
|
`kind` est un projet permettant de lancer un cluster kubernetes directement via
|
|
Docker.
|
|
|
|
Pour commencer, il nous faudra télécharger le binaire (go, donc statique)
|
|
suivant :
|
|
|
|
<div lang="en-US">
|
|
```bash
|
|
curl -Lo kind https://github.com/kubernetes-sigs/kind/releases/download/v0.6.0/kind-$(uname)-amd64
|
|
chmod +x kind
|
|
```
|
|
</div>
|
|
|
|
Placez-le dans un endroit où il sera accessible de votre `$PATH`.
|
|
|
|
Notre prochaine étape est de décrire le cluster que l'on souhaite avoir : 1
|
|
master et 2 workers. Avant de lancer leur création.
|
|
|
|
<div lang="en-US">
|
|
```bash
|
|
cat > my-cluster.yml <<EOF
|
|
kind: Cluster
|
|
apiVersion: kind.sigs.k8s.io/v1alpha3
|
|
nodes:
|
|
- role: control-plane
|
|
- role: worker
|
|
- role: worker
|
|
EOF
|
|
kind create cluster --config my-cluster.yml
|
|
```
|
|
</div>
|
|
|
|
La création du cluster peut prendre quelques minutes.
|
|
|
|
Profitons-en pour télécharger `kubectl` :
|
|
|
|
<div lang="en-US">
|
|
```bash
|
|
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.16.3/bin/linux/amd64/kubectl
|
|
chmod +x kubectl
|
|
```
|
|
</div>
|
|
|
|
C'est via cette commande que nous interagirons principalement avec l'API de
|
|
Kubernetes.
|
|
|
|
Une fois que tout sera opérationnel, nous devrions obtenir :
|
|
|
|
<div lang="en-US">
|
|
```
|
|
42sh$ kubectl version
|
|
Client Version: version.Info{Major:"1", Minor:"16", GitVersion:"v1.16.3", GitCommit:"b3cbbae08ec52a7fc73d334838e18d17e8512749", GitTreeState:"archive", BuildDate:"2019-11-26T02:51:51Z", GoVersion:"go1.12.9", Compiler:"gc", Platform:"linux/amd64"}
|
|
Server Version: version.Info{Major:"1", Minor:"16", GitVersion:"v1.16.3", GitCommit:"b3cbbae08ec52a7fc73d334838e18d17e8512749", GitTreeState:"clean", BuildDate:"2019-11-16T01:01:59Z", GoVersion:"go1.12.12", Compiler:"gc", Platform:"linux/amd64"}
|
|
```
|
|
</div>
|
|
|
|
|
|
Play With Kubernetes
|
|
--------------------
|
|
|
|
De la même manière que pour les TP utilisant Docker, si vous avez des
|
|
difficultés pour réaliser les exercices sur vos machines, vous pouvez utiliser
|
|
le projet [Play With K8s](https://play-with-k8s.com/) qui vous donnera accès à
|
|
un bac à sable avec lequel vous pourrez réaliser tous les exercices de ce TP.
|
|
|
|
Il nous faut créer plusieurs instances, disons 3 : parmi elles, 1 instance sera
|
|
la master, nous l'utiliserons principalement, les deux autres ne feront
|
|
qu'exécuter des conteneurs, nous pourrons les oublier dès qu'on les aura
|
|
connectées au master.
|
|
|
|
Pour initialiser notre cluster Kubernetes, nous allons devoir créer notre
|
|
master. Pour cela, dans notre première instance, nous allons taper :
|
|
|
|
<div lang="en-US">
|
|
```bash
|
|
kubeadm init --apiserver-advertise-address $(hostname -i)
|
|
```
|
|
</div>
|
|
|
|
Cette action peut prendre quelques minutes, et devrait se finir, si tout se
|
|
passe bien, par :
|
|
|
|
<div lang="en-US">
|
|
```
|
|
Your Kubernetes master has initialized successfully!
|
|
|
|
To start using your cluster, you need to run (as a regular user):
|
|
|
|
mkdir -p $HOME/.kube
|
|
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
|
|
sudo chown $(id -u):$(id -g) $HOME/.kube/config
|
|
|
|
You should now deploy a pod network to the cluster.
|
|
Run "kubectl apply -f [podnetwork].yaml" with one of the options listed at:
|
|
http://kubernetes.io/docs/admin/addons/
|
|
|
|
You can now join any number of machines by running the following on each node
|
|
as root:
|
|
|
|
kubeadm join --token SOMETOKEN SOMEIPADDRESS --discovery-token-ca-cert-hash SOMESHAHASH
|
|
```
|
|
</div>
|
|
|
|
Recopions ensuite la commande `kubeadm join ...` donnée dans le terminal, dans
|
|
nos deux autres instances. Cela permettra aux machines de se connecter au
|
|
master.
|
|
|
|
Dernière étape pour la mise en place de notre cluster, il s'agit de définir un
|
|
profil de politique réseau, sur le master (nous n'exécuterons plus de commande
|
|
sur les autres workers) :
|
|
|
|
<div lang="en-US">
|
|
```bash
|
|
kubectl apply -n kube-system -f \
|
|
"https://cloud.weave.works/k8s/net?k8s-version=$(kubectl version | base64 |tr -d '\n')"
|
|
```
|
|
</div>
|
|
|
|
|
|
Minikube, Docker for Mac/Windows, MicroK8s, ...
|
|
-----------------------------------------------
|
|
|
|
Si les solutions précédentes ne sont pas adaptés à votre usage, de nombreuses
|
|
autres applications permettent de mettre en place un cluster plus ou moins
|
|
complet, facilement.
|
|
|
|
Vous pouvez tenter d'utiliser
|
|
[minikube](https://kubernetes.io/docs/setup/learning-environment/minikube/),
|
|
[microk8s](https://microk8s.io/), ... Notez également que *Docker for Mac* et
|
|
*Docker for Windows* intègrent également Kubernetes depuis quelques versions ;
|
|
il convient de l'activer dans les préférences de l'application.
|