nephelaiio.kind
nephelaiio.kind
Un rôle ansible pour installer et détruire des clusters Kind.
Variables du rôle
Avec les valeurs par défaut, le rôle instanciera un cluster de 4 nœuds en utilisant la dernière version et l'image de Kind. Voici la liste des variables que l'utilisateur peut modifier :
| Paramètre | Valeur par défaut | Type | Obligatoire | Description |
|---|---|---|---|---|
| kind_release_tag | latest | string | non | Prise de la page de publication de Kind |
| kind_image_tag | latest | string | non | Prise de docker hub |
| kind_cluster_state | present | string | non | Pour créer ('present') ou détruire ('absent') le cluster cible |
| kind_cluster_name | kind | string | non | Nom du cluster à créer/détruire |
| kind_network_addr | 172.160.0/16 | string | non | Sous-réseau pour le réseau docker de kind |
| kind_kubeconfig | ~/.kube/config | string | non | Chemin pour stocker le fichier kubeconfig pour le cluster |
| kind_bin | indéfini | string | non | Chemin pour stocker le binaire kind utilisé pour déployer le cluster |
| kind_registry_deploy | false | bool | non | Créer un conteneur de registre local |
| kind_registry_hostname | localhost | string | localhost | Nom d'hôte pour le registre docker local |
| kind_registry_cleanup | true | string | non | Détruire le conteneur de registre local avec le cluster |
| kind_registry_port | 49153 | integer | non | Port d'écoute pour le registre docker local |
| kind_proxy_deploy | false | bool | non | Déployer un conteneur de registre proxy |
| kind_proxy_hostname | localhost | string | non | Nom d'hôte pour le registre proxy |
| kind_proxy_cleanup | true | string | non | Ajouter le conteneur de registre proxy à la configuration du cluster |
| kind_nodes | 4 | integer | non | Taille du cluster |
Dépendances
Système
Les exigences suivantes sont nécessaires sur l'hôte exécutant ce module :
- Système d'exploitation Linux ou Darwin 64 bits
- Binaire kubectl disponible dans le chemin
Ce rôle est compatible avec les distributions arm64 et darwin. Vous devez rassembler des faits avant d'exécuter ce rôle pour qu'il fonctionne comme prévu.
Pour que ce rôle fonctionne sur des appareils Apple Silicon, vous devez exporter la variable d'environnement DOCKER_HOST vers unix:///$HOME/.docker/run/docker.sock. Le unix:///var/run/docker.sock par défaut n'est pas disponible sur MacOS.
Ansible
Les collections python suivantes sont nécessaires sur l'hôte exécutant ce module :
- ansible.utils
Exemple de Playbook
---
- name: converger
hosts: all
roles:
- nephelaiio.kind
Test
Veuillez vous assurer que votre environnement a docker installé ; puis testez le rôle à partir de la racine du projet en utilisant les commandes suivantes :
poetry installpoetry run molecule test
Licence
Ce projet est sous les termes de la Licence MIT
ansible-galaxy install nephelaiio.kind