kubernetes-sigs/kubespray

Что это?

Ключевые возможности

• 01Развертывает высокодоступные кластеры Kubernetes в AWS, GCE, Azure, OpenStack, vSphere или на bare metal.
• 02Позволяет выбирать из нескольких сетевых плагинов, например Calico, Cilium и flannel.
• 03Поддерживает множество дистрибутивов Linux, включая Debian, Ubuntu, дистрибутивы семейства RHEL, Fedora и openSUSE.
• 04Предоставляет офлайн-способ установки для изолированных сред.
• 05Включает тесты непрерывной интеграции.

Сценарии использования

• Развертывание самостоятельно управляемого кластера Kubernetes на bare-metal-серверах.
• Создание кластеров на инфраструктуре частного облака OpenStack или vSphere.
• Развертывание Kubernetes в изолированных сетях с локальным зеркалом.
• Интеграция настройки кластера в существующую инфраструктуру под управлением Ansible.

Быстрый старт

1. 1

   Убедитесь, что Docker установлен

2. 2

   Запустите контейнер Kubespray, подключив инвентарь и SSH-ключ

   docker run --rm -it --mount type=bind,source="$(pwd)"/inventory/sample,dst=/inventory --mount type=bind,source="${HOME}"/.ssh/id_rsa,dst=/root/.ssh/id_rsa quay.io/kubespray/kubespray:v2.31.0 bash
3. 3

   Внутри контейнера запустите playbook кластера

   ansible-playbook -i /inventory/inventory.ini --private-key /root/.ssh/id_rsa cluster.yml

Что важно знать

• !Целевым серверам необходим доступ к Интернету для загрузки образов контейнеров, если не настроена автономная среда.
• !В README рекомендуется отключать межсетевые экраны хостов на время развертывания, поскольку Kubespray ими не управляет.
• !Поддержка Oracle Cloud Infrastructure отмечена как экспериментальная.

Темы

Частые вопросы

Что такое kubespray?

Набор инструментов на базе Ansible для развертывания готовых к production высокодоступных кластеров Kubernetes в облаках и на bare metal. Kubespray — это набор Ansible playbooks и ролей для установки и настройки кластера Kubernetes. Он предназначен для операторов, которым нужно развертывать кластеры в публичных облаках, таких как AWS, GCE и Azure, в частных облаках вроде OpenStack и vSphere или непосредственно на bare-metal-серверах. Также поддерживается высокодоступная плоскость управления.

kubespray можно использовать бесплатно? Какая у него лицензия?

kubespray распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

kubespray всё ещё поддерживается?

Активно поддерживается. Последний коммит в kubespray — 21 окт. 2026 г..

Для чего можно использовать kubespray?

Развертывание самостоятельно управляемого кластера Kubernetes на bare-metal-серверах. Создание кластеров на инфраструктуре частного облака OpenStack или vSphere. Развертывание Kubernetes в изолированных сетях с локальным зеркалом. Интеграция настройки кластера в существующую инфраструктуру под управлением Ansible.

Как установить kubespray?

Убедитесь, что Docker установлен Запустите контейнер Kubespray, подключив инвентарь и SSH-ключ: docker run --rm -it --mount type=bind,source="$(pwd)"/inventory/sample,dst=/inventory --mount type=bind,source="${HOME}"/.ssh/id_rsa,dst=/root/.ssh/id_rsa quay.io/kubespray/kubespray:v2.31.0 bash Внутри контейнера запустите playbook кластера: ansible-playbook -i /inventory/inventory.ini --private-key /root/.ssh/id_rsa cluster.yml

Где скачать kubespray?

Исходный код и инструкции по установке — на GitHub: https://github.com/kubernetes-sigs/kubespray