Rôle Ansible : Kubernetes

Rôle pour installer le gestionnaire de clusters de conteneurs Kubernetes.

Exigences

• Ansible Core >= 2.12

• Distribution Linux

  • Famille Debian

    • Ubuntu

      • Bionic (18.04)
      • Focal (20.04)

Variables du rôle

Les variables suivantes changeront le comportement de ce rôle (les valeurs par défaut sont indiquées ci-dessous) :

# Type de nœud : détermine les fonctionnalités installées.
# - controller:
#     - kubectl
# - worker:
#     - kubelet
#     - kubernetes-cni
# - master:
#     - kubelet
#     - kubectl
#     - kubernetes-cni
# - admin:
#     - kubelet
#     - kubectl
#     - kubeadm
#     - kubernetes-cni
kubernetes_node_type: worker

# L'ID de la clé APT pour le dépôt Kubernetes (facultatif)
kubernetes_apt_key_id:

Exemple de Playbook

- hosts: servers
  roles:
    - role: gantsign.kubernetes
      kubernetes_node_type: worker

Complétion par onglets et alias pour Zsh

En utilisant Ansible

Nous recommandons d'utiliser le rôle gantsign.antigen pour activer le support Zsh pour Kubernetes (cela doit être configuré pour chaque utilisateur).

- hosts: servers
  roles:
    - role: gantsign.kubernetes
      kubernetes_node_type: worker

    - role: gantsign.antigen
      users:
        - username: exemple
          antigen_libraries:
            - name: oh-my-zsh
          antigen_bundles:
            # Utiliser le plugin Oh My Zsh pour kubectl
            - name: kubectl
            # Utiliser le plugin GantSign pour kubeadm
            - name: kubeadm
              url: gantsign/zsh-plugins
              location: kubeadm

En utilisant Antigen

Si vous préférez utiliser Antigen directement, ajoutez ce qui suit à votre configuration Antigen :

antigen use oh-my-zsh
antigen bundle kubectl
antigen bundle gantsign/zsh-plugins kubeadm

Important : il y a un bug avec la version actuelle d'Antigen qui empêche son fonctionnement avec le plugin kubectl. Nous recommandons d'utiliser la version 2.0.2 d'Antigen jusqu'à ce que le problème soit corrigé.

Configuration manuelle

Pour configurer manuellement la complétion par onglets Zsh, ajoutez ce qui suit à votre .zshrc :

eval "$(kubectl completion zsh)"
eval "$(kubeadm completion zsh)"

Autres rôles de GantSign

Vous pouvez trouver d'autres rôles de GantSign sur Ansible Galaxy.

Développement et tests

Ce projet utilise les outils suivants :

• Molecule pour orchestrer les scénarios de test
• Testinfra pour tester les modifications à distance
• pytest le cadre de test
• Tox gère les environnements virtuels Python pour le linting et le test
• pip-tools pour gérer les dépendances

Un Dev Container pour Visual Studio Code est fourni pour développer et tester ce rôle.

Licence

MIT

Informations sur l'auteur

John Freeman

GantSign Ltd. Numéro de société : 06109112 (enregistrée en Angleterre)