ansible.kubernetes-modules

DEPRECJONOWANE

Te moduły zostały wycofane na rzecz modułów k8s_raw i openshift_raw, które zostały dodane do Ansible 2.5.

ansible-kubernetes-modules

Zapewnia dostęp do najnowszej wersji modułów K8s.

Dodaj tę rolę do playbooka, aby inne playe, role i włączone moduły miały dostęp do tych modułów.

Moduły znajdują się w folderze library. Każdy z nich ma pełną dokumentację parametrów i struktury danych. Jednak nie wszystkie moduły zawierają przykłady, tylko te, dla których stworzono dane testowe.

Jeśli napotkasz problem z konkretnym modułem lub masz sugestie, zgłoś problem w repozytorium OpenShift Rest Client.

Dla wygody moduły k8s_common.py i openshift_common.py są dołączone w folderze module_utils. Nie jest to obecnie częścią oficjalnego wydania Ansible, ale jest częścią Ansible i znajduje się w gałęzi devel. Jeśli napotkasz błąd lub chciałbyś wprowadzić zmiany, zgłoś problemy i przesyłaj prośby o zaciągnięcie w repozytorium Ansible.

Wymagania

Ansible
Zainstalowany OpenShift Rest Client na hoście, na którym będą uruchamiane moduły.

Instalacja i użycie

Użyj klienta Galaxy, aby zainstalować rolę:

$ ansible-galaxy install ansible.kubernetes-modules

Po zainstalowaniu dodaj ją do playbooka:

---
- hosts: localhost
  remote_user: root
  roles:
    - role: ansible.kubernetes-modules
      install_python_requirements: no
    - role: hello-world

Ponieważ rola jest wskazana, rola hello-world może wdrożyć aplikację przy użyciu modułów K8s. Aby zobaczyć zawartość rzeczywistej roli, sprawdź folder tests/roles.

Uwierzytelnianie z API

Moduły współpracują bezpośrednio z API Kubernetes lub OpenShift. Nie jest wymagane zainstalowanie narzędzi CLI kubectl lub oc.

Parametry modułów

Klient REST OpenShift wymaga pliku konfiguracyjnego Kubernetes. Użyj następujących opcji, aby określić, gdzie szukać pliku i jakiego kontekstu używać do uwierzytelnienia z API:

kubeconfig

Domyślna ścieżka do pliku konfiguracyjnego to ~/.kube/config. Użyj, aby podać alternatywną ścieżkę pliku.

context

Nazwa kontekstu konfiguracyjnego do użycia w celu uwierzytelnienia. Jeśli nie jest określona, używany jest bieżący, aktywny kontekst.

Użyj następujących parametrów, aby nadpisać ustawienia znajdujące się w pliku konfiguracyjnym:

host

Podaj URL do serwera API.

ssl_ca_cert

Ścieżka do pliku certyfikatu urzędów certyfikacji.

cert_file

Ścieżka do pliku certyfikatu serwera.

key_file

Ścieżka do pliku klucza prywatnego.

api_key

Token API.

verify_ssl

Ustaw na true lub false. Jeśli false, weryfikacja SSL nie będzie wymuszana.

Zmienne środowiskowe

Zamiast przekazywać ustawienia uwierzytelnienia jako parametry do poszczególnych modułów, możesz przekazać informacje za pomocą zmiennych środowiskowych. Nazwa zmiennych środowiskowych to K8S_AUTH_ z nazwą zmiennej napisanej wielkimi literami. Na przykład, key_file będzie K8S_AUTH_KEY_FILE.