kubernetes-sigs/kubespray

O que é?

Recursos principais

• 01Implanta clusters Kubernetes altamente disponíveis na AWS, GCE, Azure, OpenStack, vSphere ou em servidores bare metal.
• 02Permite escolher entre vários plugins de rede, como Calico, Cilium e flannel.
• 03Oferece suporte a várias distribuições Linux, incluindo Debian, Ubuntu, distribuições da família RHEL, Fedora e openSUSE.
• 04Oferece uma opção de instalação offline para ambientes isolados de redes externas.
• 05Inclui testes de integração contínua.

Casos de uso

• Provisionar um cluster Kubernetes autogerenciado em servidores bare metal.
• Criar clusters em uma infraestrutura de nuvem privada OpenStack ou vSphere.
• Implantar Kubernetes em redes isoladas de redes externas, usando um mirror local.
• Integrar a configuração de clusters a uma infraestrutura existente gerenciada pelo Ansible.

Início rápido

1. 1

   Verifique se o Docker está instalado

2. 2

   Inicie o contêiner do Kubespray com o inventário e a chave 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 do contêiner, execute o playbook do cluster

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

Antes de usar

• !Os servidores de destino precisam de acesso à Internet para baixar as imagens de contêiner, a menos que você configure um ambiente offline.
• !O README recomenda desativar os firewalls dos hosts durante a implantação, pois o Kubespray não os gerencia.
• !O suporte ao Oracle Cloud Infrastructure está marcado como experimental.

Tópicos

Perguntas frequentes

O que é kubespray?

Kit baseado em Ansible para implantar clusters Kubernetes altamente disponíveis e prontos para produção na AWS, GCE, Azure, OpenStack, vSphere ou em servidores bare metal. Kubespray é um conjunto de playbooks e roles do Ansible para instalar e configurar um cluster Kubernetes. Ele atende a operadores que querem provisionar clusters em nuvens públicas, como AWS, GCE e Azure, em nuvens privadas, como OpenStack e vSphere, ou diretamente em servidores bare metal, além de oferecer suporte a um control plane altamente disponível.

kubespray é gratuito? Qual é a licença?

kubespray é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

kubespray ainda é mantido?

Manutenção ativa. O último commit de kubespray foi em 21 de out. de 2026.

Para que posso usar kubespray?

Provisionar um cluster Kubernetes autogerenciado em servidores bare metal. Criar clusters em uma infraestrutura de nuvem privada OpenStack ou vSphere. Implantar Kubernetes em redes isoladas de redes externas, usando um mirror local. Integrar a configuração de clusters a uma infraestrutura existente gerenciada pelo Ansible.

Como instalar kubespray?

Verifique se o Docker está instalado Inicie o contêiner do Kubespray com o inventário e a chave 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 do contêiner, execute o playbook do cluster: ansible-playbook -i /inventory/inventory.ini --private-key /root/.ssh/id_rsa cluster.yml

Onde consigo kubespray?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kubernetes-sigs/kubespray