Руководство по Kubernetes и OpenShift

Модули для взаимодействия с API Kubernetes (K8s) и OpenShift находятся в стадии разработки и могут быть использованы в режиме предварительного просмотра. Для их использования ознакомьтесь с требованиями, а затем следуйте инструкциям по установке и использованию.

Требования

Для использования модулей вам потребуется следующее:

• Запустить Ansible из исходного кода. Для получения помощи см. Запуск ansible-base из исходного кода (devel).
• OpenShift Rest Client установлен на хосте, который будет выполнять модули.

Установка и использование

Модули Kubernetes являются частью коллекции Ansible Kubernetes.

Для установки коллекции выполните следующие действия:

$ ansible-galaxy collection install community.kubernetes

Далее, включите её в playbook, как показано ниже:

---
- hosts: localhost
  tasks:
  - name: Create a pod
    community.kubernetes.k8s:
      state: present
      definition:
        apiVersion: v1
        kind: Pod
        metadata:
          name: "utilitypod-1"
          namespace: default
          labels:
            app: galaxy
        spec:
          containers:
          - name: utilitypod
            image: busybox

Авторизация с API

По умолчанию OpenShift Rest Client будет искать ~/.kube/config, и, если найдёт, подключиться используя активный контекст. Вы можете изменить расположение файла с помощью параметра ``kubeconfig``, а контекст — с помощью параметра context.

Также поддерживается базовая аутентификация с помощью параметров username и password. Вы можете изменить URL с помощью параметра host. Верификация сертификатов работает через параметры ssl_ca_cert, cert_file, и key_file, а для аутентификации по токену используйте параметр api_key.

Чтобы отключить проверку SSL-сертификата, установите verify_ssl в значение false.

Отправка отчетов об ошибках

Если вы обнаружили ошибку или у вас есть предложения по модулям, пожалуйста, отправьте отчет об ошибке на странице отчетов об ошибках Ansible Kubernetes collection. Если вы обнаружили ошибку, относящуюся к клиенту OpenShift, отправьте отчет об ошибке на странице отчетов об ошибках OpenShift REST Client.