Начало работы с Kubernetes и OpenShift

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

Требования

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

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

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

Отдельные модули на данный момент не входят в репозиторий Ansible, но к ним можно получить доступ, установив роль ansible.kubernetes-modules и включив её в плейбук.

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

$ ansible-galaxy install ansible.kubernetes-modules

Далее включите её в плейбук следующим образом:

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

Поскольку роль прописана, hello-world может получить доступ к модулям и использовать их для развертывания приложения.

Модули находятся в папке library роли. Каждый содержит полную документацию по параметрам и структуре возвращаемых данных. Однако не все модули включают примеры, только те, для которых были созданы тестовые данные.

Аутентификация с 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.

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

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

Также существует утилитарный модуль k8s_common.py, который входит в репозиторий Ansible. Если вы обнаружите ошибку или у вас есть предложения по нему, пожалуйста, отправьте отчет об ошибке на странице отчетов об ошибках Ansible.