https://blog.homelab89.com/tags/kubespray/ Recent content in Kubespray on homelab89 Hugo ko-KR Mon, 29 Jun 2026 00:00:00 +0000 https://blog.homelab89.com/docs/k8s/etcd-kubespray-deploy/ Mon, 29 Jun 2026 00:00:00 +0000 https://blog.homelab89.com/docs/k8s/etcd-kubespray-deploy/ <h2 id="kubespray-개요">kubespray 개요</h2> <p>kubespray는 Ansible 기반의 프로덕션급 Kubernetes 클러스터 배포 도구입니다.</p> <pre tabindex="0"><code>kubespray (Ansible Playbook) └── cluster.yml ├── 부트스트랩 (python, pip 설치) ├── etcd 클러스터 구성 (3-node) ├── kube-apiserver, kube-scheduler, kube-controller-manager ├── kubelet, kube-proxy └── CNI (Calico) </code></pre><h2 id="kubespray-clone-및-환경-구성">kubespray Clone 및 환경 구성</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">cd</span> /home/jinsoo/Documents/k8s-etcd-lab </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># kubespray clone</span> </span></span><span class="line"><span class="cl">git clone https://github.com/kubernetes-sigs/kubespray.git /tmp/kubespray-src </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 인벤토리 복사</span> </span></span><span class="line"><span class="cl">cp -rfp /tmp/kubespray-src/inventory/sample kubespray/inventory/k8s-etcd-lab </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Python 가상환경 활성화 후 의존성 설치</span> </span></span><span class="line"><span class="cl"><span class="nb">source</span> .venv/bin/activate </span></span><span class="line"><span class="cl">pip install -r /tmp/kubespray-src/requirements.txt </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># ansible 연결 테스트</span> </span></span><span class="line"><span class="cl">ansible all -i kubespray/inventory/k8s-etcd-lab/hosts.yaml <span class="se">\ </span></span></span><span class="line"><span class="cl"> -m ping <span class="se">\ </span></span></span><span class="line"><span class="cl"> --private-key ~/.ssh/k8s-lab <span class="se">\ </span></span></span><span class="line"><span class="cl"> -u ubuntu </span></span></code></pre></div><h2 id="인벤토리-구조">인벤토리 구조</h2> <p><code>kubespray/inventory/k8s-etcd-lab/hosts.yaml</code> 파일을 사용합니다.</p>