kubernetes-sigs/kubespray

¿Qué es?

Funciones clave

• 01Despliega clústeres de Kubernetes de alta disponibilidad en AWS, GCE, Azure, OpenStack, vSphere o servidores bare metal.
• 02Permite elegir entre varios plugins de red, como Calico, Cilium y flannel.
• 03Es compatible con muchas distribuciones de Linux, incluidas Debian, Ubuntu, las de la familia RHEL, Fedora y openSUSE.
• 04Ofrece una opción de instalación sin conexión para entornos aislados de la red.
• 05Incluye pruebas de integración continua.

Casos de uso

• Aprovisionar un clúster de Kubernetes autogestionado en servidores bare metal.
• Poner en marcha clústeres en infraestructura de nube privada OpenStack o vSphere.
• Desplegar Kubernetes en redes aisladas de la red con un mirror local.
• Integrar la configuración del clúster en una infraestructura existente gestionada con Ansible.

Inicio rápido

1. 1

   Asegúrate de que Docker esté instalado

2. 2

   Inicia el contenedor de Kubespray con el inventario y la clave SSH montados

   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

   Dentro del contenedor, ejecuta el playbook del clúster

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

Antes de usarlo

• !Los servidores de destino necesitan acceso a Internet para descargar las imágenes de contenedor, salvo que configures un entorno sin conexión.
• !El README indica que se desactiven los firewalls de los hosts durante el despliegue, ya que Kubespray no los gestiona.
• !La compatibilidad con Oracle Cloud Infrastructure está marcada como experimental.

Temas

Preguntas frecuentes

¿Qué es kubespray?

Herramientas basadas en Ansible para desplegar clústeres de Kubernetes altamente disponibles y listos para producción en AWS, GCE, Azure, OpenStack, vSphere o servidores bare metal. Kubespray es un conjunto de playbooks y roles de Ansible para instalar y configurar un clúster de Kubernetes. Está dirigido a operadores que quieren aprovisionar clústeres en nubes públicas como AWS, GCE y Azure, en nubes privadas como OpenStack y vSphere, o directamente en servidores bare metal, y admite un plano de control de alta disponibilidad.

¿kubespray es gratuito? ¿Qué licencia tiene?

kubespray es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿kubespray sigue mantenido?

Mantenimiento activo. El último commit de kubespray fue el 21 oct 2026.

¿Para qué puedo usar kubespray?

Aprovisionar un clúster de Kubernetes autogestionado en servidores bare metal. Poner en marcha clústeres en infraestructura de nube privada OpenStack o vSphere. Desplegar Kubernetes en redes aisladas de la red con un mirror local. Integrar la configuración del clúster en una infraestructura existente gestionada con Ansible.

¿Cómo se instala kubespray?

Asegúrate de que Docker esté instalado Inicia el contenedor de Kubespray con el inventario y la clave SSH montados: 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 Dentro del contenedor, ejecuta el playbook del clúster: ansible-playbook -i /inventory/inventory.ini --private-key /root/.ssh/id_rsa cluster.yml

¿Dónde consigo kubespray?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/kubernetes-sigs/kubespray