Ansible-Rolle: Kubernetes

Rolle zur Installation des Kubernetes Container-Cluster-Managers.

Anforderungen

• Ansible Core >= 2.12

• Linux-Distribution

  • Debian-Familie

    • Ubuntu

      • Bionic (18.04)
      • Focal (20.04)

Rollenvariablen

Die folgenden Variablen ändern das Verhalten dieser Rolle (Standardwerte sind unten aufgeführt):

# Knotentyp: bestimmt, welche Funktionen installiert sind.
# - controller:
#     - kubectl
# - worker:
#     - kubelet
#     - kubernetes-cni
# - master:
#     - kubelet
#     - kubectl
#     - kubernetes-cni
# - admin:
#     - kubelet
#     - kubectl
#     - kubeadm
#     - kubernetes-cni
kubernetes_node_type: worker

# Die ID des APT-Schlüssels für das Kubernetes-Repository (optional)
kubernetes_apt_key_id:

Beispiel-Playbook

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

Tab-Vervollständigung und Aliase für Zsh

Verwendung mit Ansible

Wir empfehlen, die Rolle gantsign.antigen zu verwenden, um Zsh-Unterstützung für Kubernetes zu aktivieren (dies muss für jeden Benutzer konfiguriert werden).

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

    - role: gantsign.antigen
      users:
        - username: example
          antigen_libraries:
            - name: oh-my-zsh
          antigen_bundles:
            # Verwenden Sie das Oh My Zsh-Plugin für kubectl
            - name: kubectl
            # Verwenden Sie das GantSign-Plugin für kubeadm
            - name: kubeadm
              url: gantsign/zsh-plugins
              location: kubeadm

Verwendung von Antigen

Wenn Sie Antigen direkt verwenden möchten, fügen Sie Folgendes zu Ihrer Antigen-Konfiguration hinzu:

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

Wichtig: Es gibt einen Fehler in der aktuellen Version von Antigen, der das Funktionieren mit dem kubectl-Plugin verhindert. Wir empfehlen, die Version 2.0.2 von Antigen zu verwenden, bis das Problem behoben ist.

Manuelle Konfiguration

Um die Zsh-Tab-Vervollständigung manuell zu konfigurieren, fügen Sie Folgendes zu Ihrer .zshrc hinzu:

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

Weitere Rollen von GantSign

Sie können weitere Rollen von GantSign auf Ansible Galaxy finden.

Entwicklung & Tests

Dieses Projekt verwendet die folgenden Werkzeuge:

• Molecule zur Orchestrierung von Testszenarien
• Testinfra zum Testen der Änderungen auf der Fernverbindung
• pytest das Test-Framework
• Tox verwaltet Python-virtuelle Umgebungen für Linting und Tests
• pip-tools zur Verwaltung von Abhängigkeiten

Ein Dev Container für Visual Studio Code Dev Container wird bereitgestellt, um diese Rolle zu entwickeln und zu testen.

Lizenz

MIT

Autoreninformationen

John Freeman

GantSign Ltd. Firmen-Nr. 06109112 (in England registriert)