kubernetes-sigs/kubespray

어떤 프로젝트인가요?

핵심 기능

• 01AWS, GCE, Azure, OpenStack, vSphere 또는 베어메탈에 고가용성 Kubernetes 클러스터를 배포합니다.
• 02Calico, Cilium, flannel 같은 여러 네트워크 플러그인 중에서 선택할 수 있습니다.
• 03Debian, Ubuntu, RHEL 계열, Fedora, openSUSE 등 다양한 Linux 배포판을 지원합니다.
• 04에어갭 환경을 위한 오프라인 설치 경로를 제공합니다.
• 05지속적 통합 테스트를 포함합니다.

활용 사례

• 베어메탈 서버에 자체 관리형 Kubernetes 클러스터를 구축합니다.
• OpenStack 또는 vSphere 프라이빗 클라우드 인프라에 클러스터를 구성합니다.
• 로컬 미러를 사용해 에어갭 네트워크에 Kubernetes를 배포합니다.
• 기존 Ansible 관리 인프라에 클러스터 설정을 통합합니다.

빠른 시작

1. 1

   Docker가 설치되어 있는지 확인합니다

2. 2

   인벤토리와 SSH 키를 마운트한 상태로 Kubespray 컨테이너를 시작합니다

   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은(는) 무엇인가요?

AWS, GCE, Azure, OpenStack, vSphere 또는 베어메탈에 운영 환경에 바로 적용할 수 있는 고가용성 Kubernetes 클러스터를 배포하는 Ansible 기반 툴킷입니다. Kubespray는 Kubernetes 클러스터를 설치하고 구성하기 위한 Ansible 플레이북과 롤 모음입니다. AWS, GCE, Azure 같은 퍼블릭 클라우드나 OpenStack, vSphere 같은 프라이빗 클라우드, 또는 베어메탈 서버에 클러스터를 구축하려는 운영자를 대상으로 하며, 고가용성 컨트롤 플레인을 지원합니다.

kubespray은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

kubespray은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

kubespray은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. kubespray의 마지막 커밋은 2026년 10월 21일입니다.

kubespray은(는) 어디에 사용할 수 있나요?

베어메탈 서버에 자체 관리형 Kubernetes 클러스터를 구축합니다. OpenStack 또는 vSphere 프라이빗 클라우드 인프라에 클러스터를 구성합니다. 로컬 미러를 사용해 에어갭 네트워크에 Kubernetes를 배포합니다. 기존 Ansible 관리 인프라에 클러스터 설정을 통합합니다.

kubespray는 어떻게 설치하나요?

Docker가 설치되어 있는지 확인합니다 인벤토리와 SSH 키를 마운트한 상태로 Kubespray 컨테이너를 시작합니다: 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