Руководство по 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.