kubespray

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 18,688 Open GitHub ↗

프로덕션 레디 Kubernetes 클러스터 배포하기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 프로덕션 준비가 완료된 Kubernetes 클러스터 배포하기
![Kubernetes Logo](https://raw.githubusercontent.com/kubernetes-sigs/kubespray/master/docs/img/kubernetes-logo.png)
질문이 있으시면 [kubespray.io](https://kubespray.io)의 문서를 확인하시고 [kubernetes slack](https://kubernetes.slack.com)의 \*\*\#kubespray\*\* 채널에 참여해 주세요.
초대장은 [여기](http://slack.k8s.io/)에서 받으실 수 있습니다.
- \*\*[AWS](docs/cloud\_providers/aws.md), GCE, [Azure](docs/cloud\_providers/azure.md), [OpenStack](docs/cloud\_controllers/openstack.md), [vSphere](docs/cloud\_controllers/vsphere.md), [Equinix Metal](docs/cloud\_providers/equinix-metal.md) (베어 메탈), Oracle Cloud Infrastructure (실험적), 또는 베어메탈\*\*에 배포 가능
- \*\*고가용성(High Availability)\*\* 클러스터
- \*\*구성 가능(Composable)\*\* (예: 네트워크 플러그인 선택 가능)
- 가장 대중적인 \*\*Linux 배포판\*\* 지원
- \*\*지속 통합 테스트(Continuous Integration Tests)\*\*
## 빠른 시작 (Quick Start)
Kubespray를 사용하여 Kubernetes 클러스터를 배포하는 몇 가지 방법은 다음과 같습니다.
### Docker
먼저 Docker를 설치한 후 다음을 실행하세요.
```ShellSession
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
# Inside the container you may now run the kubespray playbooks:
ansible-playbook -i /inventory/inventory.ini --private-key /root/.ssh/id\_rsa cluster.yml
```
### Ansible
#### 사용법
[시작하기](/docs/getting\_started/getting-started.md)를 참조하세요.
#### 컬렉션
이 저장소를 Ansible 컬렉션으로 사용하려면 [여기](docs/ansible/ansible\_collection.md)를 참조하세요.
### Vagrant
Vagrant를 사용하려면 프로비저닝 작업을 위한 Python 종속성을 설치해야 합니다.
``Python``과 ``pip``가 설치되어 있는지 확인하세요.
```ShellSession
python -V && pip -V
```
소프트웨어 버전이 출력되면 바로 진행하실 수 있습니다. 그렇지 않다면 여기에서 Python을 다운로드하여 설치하세요.
[Ansible 설치 가이드](/docs/ansible/ansible.md#installing-ansible)에 따라 Ansible을 설치한 후
다음 단계를 실행하세요.
```ShellSession
vagrant up
```
## 문서 (Documents)
- [요구사항](#requirements)
- [Kubespray 비교...](docs/getting\_started/comparisons.md)
- [시작하기](docs/getting\_started/getting-started.md)
- [첫 번째 클러스터 설정하기](docs/getting\_started/setting-up-your-first-cluster.md)
- [Ansible 인벤토리 및 태그](docs/ansible/ansible.md)
- [기존 ansible 저장소와 통합](docs/operations/integration.md)
- [배포 데이터 변수](docs/ansible/vars.md)
- [DNS 스택](docs/advanced/dns-stack.md)
- [HA 모드](docs/operations/ha-mode.md)
- [네트워크 플러그인](#network-plugins)
- [Vagrant 설치](docs/developers/vagrant.md)
- [Flatcar Container Linux 부트스트랩](docs/operating\_systems/flatcar.md)
- [Fedora CoreOS 부트스트랩](docs/operating\_systems/fcos.md)
- [openSUSE 설정](docs/operating\_systems/opensuse.md)
- [다운로드된 아티팩트](docs/advanced/downloads.md)
- [Equinix Metal](docs/cloud\_providers/equinix-metal.md)
- [OpenStack](docs/cloud\_controllers/openstack.md)
- [vSphere](docs/cloud\_controllers/vsphere.md)
- [대규모 배포](docs/operations/large-deployments.md)
- [노드 추가/교체](docs/operations/nodes.md)
- [업그레이드 기초](docs/operations/upgrades.md)
- [에어갭(Air-Gap) 설치](docs/operations/offline-environment.md)
- [NTP](docs/advanced/ntp.md)
- [보안 강화 (Hardening)](docs/operations/hardening.md)
- [미러](docs/operations/mirror.md)
- [로드맵](docs/roadmap/roadmap.md)
## 지원되는 Linux 배포판
- \*\*Flatcar Container Linux by Kinvolk\*\*
- \*\*Debian\*\* Bookworm, Bullseye, Trixie
- \*\*Ubuntu\*\* 22.04, 24.04
- \*\*CentOS Stream / RHEL\*\* 9, 10
- \*\*Fedora\*\* 39, 40, 41, 42
- \*\*Fedora CoreOS\*\* ([fcos 참고 사항](docs/operating\_systems/fcos.md) 참조)
- \*\*openSUSE\*\* Leap 15.x/Tumbleweed
- \*\*Oracle Linux\*\* 9, 10
- \*\*Alma Linux\*\* 9, 10
- \*\*Rocky Linux\*\* 9, 10 (10 버전에서는 실험적 기능: [Rocky Linux 10 참고 사항](docs/operating\_systems/rhel.md#rocky-linux 참조)

-10))
- \*\*Kylin Linux Advanced Server V10\*\* (experimental: [kylin linux 참고 문서](docs/operating\_systems/kylinlinux.md) 참조)
- \*\*Amazon Linux 2\*\* (experimental: [amazon linux 참고 문서](docs/operating\_systems/amazonlinux.md) 참조)
- \*\*UOS Linux\*\* (experimental: [uos linux 참고 문서](docs/operating\_systems/uoslinux.md) 참조)
- \*\*openEuler\*\* (experimental: [openEuler 참고 문서](docs/operating\_systems/openeuler.md) 참조)
참고:
- Upstart/SysV init 기반 OS 종류는 지원되지 않습니다.
- [커널 요구사항](docs/operations/kernel-requirements.md) (OS 커널 버전이 4.19 미만인 경우 반드시 읽어주세요).
## 지원되는 컴포넌트
- Core
- [kubernetes](https://github.com/kubernetes/kubernetes) 1.36.3
- [etcd](https://github.com/etcd-io/etcd) 3.6.13
- [docker](https://www.docker.com/) 28.3
- [containerd](https://containerd.io/) 2.3.3
- [cri-o](https://cri-o.io/) 1.36.2 (experimental: [CRI-O 참고 문서](docs/CRI/cri-o.md) 참조. fedora, ubuntu, centos 기반 OS에서만 지원)
- Network Plugin
- [cni-plugins](https://github.com/containernetworking/plugins) 1.9.1
- [calico](https://github.com/projectcalico/calico) 3.31.6
- [cilium](https://github.com/cilium/cilium) 1.20.0
- [flannel](https://github.com/flannel-io/flannel) 0.28.4
- [kube-ovn](https://github.com/alauda/kube-ovn) 1.12.21
- [kube-router](https://github.com/cloudnativelabs/kube-router) 2.1.1
- [multus](https://github.com/k8snetworkplumbingwg/multus-cni) 4.2.2
- [kube-vip](https://github.com/kube-vip/kube-vip) 1.0.3
- Application
- [cert-manager](https://github.com/jetstack/cert-manager) 1.15.3
- [coredns](https://github.com/coredns/coredns) 1.14.2
- [argocd](https://argoproj.github.io/) 2.14.5
- [helm](https://helm.sh/) 3.18.4
- [metallb](https://metallb.universe.tf/) 0.13.9
- [registry](https://github.com/distribution/distribution) 2.8.1
- Storage Plugin
- [aws-ebs-csi-plugin](https://github.com/kubernetes-sigs/aws-ebs-csi-driver) 0.5.0
- [azure-csi-plugin](https://github.com/kubernetes-sigs/azuredisk-csi-driver) 1.10.0
- [cinder-csi-plugin](https://github.com/kubernetes/cloud-provider-openstack/blob/master/docs/cinder-csi-plugin/using-cinder-csi-plugin.md) 1.30.0
- [gcp-pd-csi-plugin](https://github.com/kubernetes-sigs/gcp-compute-persistent-disk-csi-driver) 1.9.2
- [local-path-provisioner](https://github.com/rancher/local-path-provisioner) 0.0.32
- [local-volume-provisioner](https://github.com/kubernetes-sigs/sig-storage-local-static-provisioner) 2.5.0
- [node-feature-discovery](https://github.com/kubernetes-sigs/node-feature-discovery) 0.16.4
## 컨테이너 런타임 참고 사항
- CRI-O 마이너 버전은 Kubernetes 마이너 버전과 일치해야 합니다.
## 요구사항
- \*\*Kubernetes 최소 요구 버전은 v1.34.0입니다\*\*
- \*\*Ansible을 실행할 머신에 Ansible v2.14+, Jinja 2.11+, python-netaddr가 설치되어 있어야 합니다\*\*
- 도커 이미지를 풀(pull)하기 위해 대상 서버는 반드시 \*\*인터넷에 접속\*\*할 수 있어야 합니다. 그렇지 않은 경우 추가 설정이 필요합니다 ([오프라인 환경](docs/operations/offline-environment.md) 참조).
- 대상 서버는 \*\*IPv4 포워딩\*\*을 허용하도록 설정되어 있어야 합니다.
- 파드 및 서비스에 IPv6를 사용하는 경우, 대상 서버는 \*\*IPv6 포워딩\*\*을 허용하도록 설정되어 있어야 합니다.
- \*\*방화벽은 관리되지 않으며\*\*, 기존에 사용하던 방식대로 직접 규칙을 구현해야 합니다.
배포 중 문제를 방지하려면 방화벽을 비활성화하는 것이 좋습니다.
- root가 아닌 사용자 계정으로 Kubespray를 실행하는 경우, 대상 서버에 올바른 권한 상승 메서드가 설정되어 있어야 합니다. 그 후 `ansible\_become` 플래그나 `--become` 또는 `-b` 명령행 파라미터를 지정해야 합니다.
하드웨어:
이러한 제한 사항은 Kubespray에서 보호합니다. 워크로드에 대한 실제 요구사항은 다를 수 있습니다. 사이징 가이드는 [대규모 클러스터 구축 가이드](https://kubernetes.io/docs/setup/cluster-large/#size-of-master-and-master-components)를 참조하세요.
- Control Plane
- 메모리: 2 GB
- Worker Node
- 메모리: 1 GB
## 네트워크 플러그인
10개의 네트워크 플러그인 중 선택할 수 있습니다. (기본값: `calico`, V 제외)

agrant는 `flannel`을 사용합니다)
- [flannel](docs/CNI/flannel.md): gre/vxlan (레이어 2) 네트워킹.
- [Calico](https://docs.tigera.io/calico/latest/about/)는 네트워킹 및 네트워크 정책 제공자입니다. Calico는 비오버레이 및 오버레이 네트워크, BGP 사용 여부 등 다양한 상황에서 가장 효율적인 네트워킹을 제공하도록 설계된 유연한 네트워킹 옵션 세트를 지원합니다. Calico는 동일한 엔진을 사용하여 호스트, Pod, 그리고 서비스 메시 계층의 애플리케이션(Istio 및 Envoy를 사용하는 경우)에 대한 네트워크 정책을 시행합니다.
- [cilium](http://docs.cilium.io/en/latest/): 레이어 3/4 네트워킹(및 애플리케이션 프로토콜 보호와 보안을 위한 레이어 7)을 지원하며, 보안 서비스, 네트워킹 및 가시성 로직을 구현하기 위해 Linux 커널에 BPF 바이트코드를 동적으로 삽입하는 기능을 지원합니다.
- [kube-ovn](docs/CNI/kube-ovn.md): Kube-OVN은 OVN 기반 네트워크 가상화를 Kubernetes와 통합합니다. 엔터프라이즈를 위한 고급 컨테이너 네트워크 패브릭을 제공합니다.
- [kube-router](docs/CNI/kube-router.md): Kube-router는 운영의 단순성과 고성능을 목표로 하는 Kubernetes 네트워킹용 L3 CNI입니다. IPVS를 사용하여 Kube Services Proxy를 제공하고(kube-proxy를 대체하도록 설정된 경우), 네트워크 정책을 위해 iptables를 사용하며, Pod L3 네트워킹을 위해 BGP를 사용합니다(선택적으로 클러스터 외부에 있는 BGP 피어와 BGP 피어링 가능).
또한 선택적으로 Kubernetes 클러스터 Pod CIDR, ClusterIP, ExternalIP 및 LoadBalancerIP로 라우트를 광고할 수 있습니다.
- [macvlan](docs/CNI/macvlan.md): Macvlan은 Linux 네트워크 드라이버입니다. Pod는 고유한 Mac 및 IP 주소를 가지며 물리적(레이어 2) 네트워크에 직접 연결됩니다.
- [multus](docs/CNI/multus.md): Multus는 Pod에 여러 네트워크 인터페이스 지원을 제공하는 메타 CNI 플러그인입니다. 각 인터페이스에 대해 Multus는 CNI 호출을 Calico, macvlan 등과 같은 보조 CNI 플러그인에 위임합니다.
- [custom\_cni](roles/network-plugin/custom\_cni/) : 자체 CNI를 적용하고 Kubespray에서 지원하지 않는 CNI를 사용하기 위해 클러스터에 적용할 매니페스트를 지정할 수 있습니다.
Helm Chart에서 제공하는 CNI를 사용하는 예제는 `tests/files/custom\_cni/README.md`와 `tests/files/custom\_cni/values.yaml`을 참조하세요.
사용할 네트워크 플러그인은 변수 `kube\_network\_plugin`으로 정의됩니다. 내장된 클라우드 제공자 네트워킹을 대신 활용하는 옵션도 있습니다.
[Network checker](docs/advanced/netcheck.md)도 참조하세요.
## Ingress Plugins
- [metallb](docs/ingress/metallb.md): MetalLB 베어메탈 서비스 LoadBalancer 제공자.
## Community docs and resources
- [kubernetes.io/docs/setup/production-environment/tools/kubespray/](https://kubernetes.io/docs/setup/production-environment/tools/kubespray/)
- [@gregbkr의 kubespray, monitoring and logging](https://github.com/gregbkr/kubernetes-kargo-logging-monitoring)
- [@rsmitty의 Deploy Kubernetes w/ Ansible & Terraform](https://rsmitty.github.io/Terraform-Ansible-Kubernetes/)
- [Deploy a Kubernetes Cluster with Kubespray (비디오)](https://www.youtube.com/watch?v=CJ5G4GpqDy0)
## Tools and projects on top of Kubespray
- [Digital Rebar Provision](https://github.com/digitalrebar/provision/blob/v4/doc/integrations/ansible.rst)
- [Terraform Contrib](https://github.com/kubernetes-sigs/kubespray/tree/master/contrib/terraform)
- [Kubean](https://github.com/kubean-io/kubean)
## CI Tests
[![Build graphs](https://gitlab.com/kargo-ci/kubernetes-sigs-kubespray/badges/master/pipeline.svg)](https://gitlab.com/kargo-ci/kubernetes-sigs-kubespray/-/pipelines)
CI/end-to-end 테스트 후원: [CNCF](https://cncf.io), [Equinix Metal](https://metal.equinix.com/), [OVHcloud](https://www.ovhcloud.com/), [ELASTX](https://elastx.se/).
자세한 내용은 [테스트 매트릭스](docs/developers/test\_cases.md)를 참조하세요.

kubespray

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

kubespray

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README