gke-playground

Expérimentation avec Terraform pour création d'un environnement de développement Kubernetes dans Google Cloud :

Mise en garde

• Testé uniquement avec des bac à sable Google Cloud de acloud.guru.
• Le stockage de l'état Terraform n'est pas traité (voir backend GCS)
• La segmentation réseau (VPC) n'est pas traitée.
• Les sauvegardes ne sont pas traitées.

Principe du déploiement

Le déploiement est réalisé en plusieurs étapes :

• 01-gke : Création du cluster Kubernetes et la production d'un fichier gke-playground/output/kubeconfig.yml
• 02-rwx : Création d'une instance Google FileStore ("nfs-server") et de la classe de stockage RWX associée ("nfs-legacy")
• 03-lb : Déploiement de ingress-nginx-controller avec une IP réservée ("lb-address")

Pré-requis

• Installer gcloud (gcloud --help)
• Installer terraform (terraform version)
• Se connecter sur un compte Google Cloud sur la console : https://console.cloud.google.com/
• Se connecter avec gcloud :

gcloud auth login
gcloud auth application-default login

Déployer l'environnement de développement

Voir script install.sh qui assure :

• Le contrôle de la variable d'environnement PROJECT_ID
• Le contrôle de l'accès au projet Google Cloud correspondant
• L'activation des services Google Cloud utilisés
• L'appel de terraform apply -auto-approve sur chacun des dossiers

A l'usage :

# Pour install.sh :
export PROJECT_ID=playground-s-11-946429c5
# Pour utilisation direct de terraform :
export TF_VAR_project_id=$PROJECT_ID

# Création de l'infrastructure avec terraform
bash install.sh

Remarques :

• Les paramètres disponibles au niveau des modules terraform sont définis dans le fichiers "variables.tf"
• Noter que PROJECT_ID est traduite en TF_VAR_project_id et que ce principe peut être utilisé pour d'autres variables (voir developer.hashicorp.com - Terraform - Input Variables)

Accès au cluster Kubernetes

Avec kubeconfig généré par Terraform

export KUBECONFIG=$PWD/output/kubeconfig.yaml

# Pour tester le fonctionnement :
kubectl cluster-info
kubectl get nodes
kubectl get namespaces

Avec une utilisation classique de Google Cloud

gcloud config set project $PROJECT_ID

gcloud container clusters list
gcloud compute addresses list

# Pour configurer kubectl (~/.kube/config)
ZONE=$(gcloud container clusters describe primary --format="value(location)")
gcloud container clusters get-credentials primary --zone=$ZONE

# Pour tester le fonctionnement :
kubectl cluster-info
kubectl get nodes
kubectl get namespaces

Utilisation avec docker-devbox

Par exemple :

export KUBECONFIG=$PWD/output/kubeconfig.yaml

# Pour https://whoami.gke.quadtreeworld.net
export DEVBOX_HOSTNAME=gke.quadtreeworld.net
export DEVBOX_ISSUER=letsencrypt-http
export DEVBOX_INGRESS=nginx

git clone https://github.com/mborne/docker-devbox

# déploiement de cert-manager
bash docker-devbox/cert-manager/k8s-install.sh
bash docker-devbox/cert-manager/cluster-issuer/letsencrypt-http.sh <CONTACT_EMAIL>

# déploiement de whoami
bash docker-devbox/whoami/k8s-install.sh

License

MIT