Cluster API 소개

1 개요

k8s Cluster API

쿠버네티스 클러스터 API, k8s 클러스터 API

클러스터 API는 여러 Kubernetes 클러스터의 프로비저닝, 업그레이드 및 운영을 단순화하기 위한 선언적 API 및 도구 제공에 중점을 둔 Kubernetes 하위 프로젝트입니다.

Kubernetes SIG(Special Interest Group) 클러스터 라이프사이클 에 의해 시작된 클러스터 API 프로젝트는 Kubernetes 스타일 API 및 패턴을 사용하여 플랫폼 운영자를 위한 클러스터 라이프사이클 관리를 자동화합니다. 가상 머신, 네트워크, 로드 밸런서, VPC와 같은 지원 인프라와 Kubernetes 클러스터 구성은 모두 애플리케이션 개발자가 워크로드를 배포하고 관리하는 것과 동일한 방식으로 정의됩니다. 이를 통해 다양한 인프라 환경에서 일관되고 반복 가능한 클러스터 배포가 가능합니다.

2 ⚠️ 파격적 변경 ⚠️

레거시 k8s.gcr.io 컨테이너 이미지 레지스트리는 Registry.k8s.io로 리디렉션됩니다. k8s.gcr.io 이미지 레지스트리는 3월 20일 월요일에 Registry.k8s.io로 리디렉션됩니다. k8s.gcr.io에서 사용할 수 있는 모든 이미지는 Registry.k8s.io에서 사용할 수 있습니다. 자세한 내용은 공지사항을 읽어보시기 바랍니다 .

또한 이 가이드에서는 미러링할 이미지를 식별하는 방법과 미러링된 이미지를 사용하는 방법에 대한 지침을 제공합니다.

더 이상 사용되지 않는 API 제거

API 버전 v1alpha3 지원은 릴리스 v1.5에서 더 이상 제공되지 않습니다. API 버전 v1alpha4 지원은 v1.6의 향후 릴리스에서 제거될 예정입니다.

자세한 내용은 기여 가이드의 지원 및 보증 섹션을 검토하세요 .

3 시작하기

ClusterAPI 문서 버전 이 책에는 ClusterAPI v1.6이 문서화되어 있습니다. 다른 클러스터 API 버전에 대해서는 해당 문서를 참조하세요.

• main.cluster-api.sigs.k8s.io
• release-1-5.cluster-api.sigs.k8s.io
• release-1-4.cluster-api.sigs.k8s.io
• release-1-3.cluster-api.sigs.k8s.io
• release-1-2.cluster-api.sigs.k8s.io
• release-1-1.cluster-api.sigs.k8s.io
• release-1-0.cluster-api.sigs.k8s.io
• release-0-4.cluster-api.sigs.k8s.io
• release-0-3.cluster-api.sigs.k8s.io

4 왜 클러스터 API를 구축합니까?

Kubernetes는 작동하는 클러스터를 갖기 위해 올바르게 구성된 여러 구성 요소에 의존하는 복잡한 시스템입니다. 이를 사용자에게 잠재적인 걸림돌로 인식한 커뮤니티에서는 부트스트래핑 프로세스를 단순화하는 데 중점을 두었습니다. 현재 100개 이상의 Kubernetes 배포판과 설치 프로그램이 생성되었으며, 각각은 클러스터 및 지원되는 인프라 제공업체에 대해 서로 다른 기본 구성을 가지고 있습니다. SIG Cluster Lifecycle은 일련의 공통된 중복 설치 문제를 해결하기 위한 단일 도구의 필요성을 확인하고 kubeadm을 시작했습니다.

Kubeadm은 모범 사례 Kubernetes 클러스터를 부트스트래핑하기 위한 집중 도구로 설계되었습니다. kubeadm 프로젝트의 핵심 원칙은 다른 설치 프로그램이 활용할 수 있는 도구를 만들고 궁극적으로 개별 설치 프로그램이 유지 관리해야 하는 구성의 양을 줄이는 것이었습니다. kubeadm은 시작된 이후 Kubespray, minikube, kind 등을 포함한 여러 다른 애플리케이션의 기본 부트스트래핑 도구가 되었습니다.

그러나 kubeadm 및 기타 부트스트랩 제공업체는 설치 복잡성을 줄여주지만 일상적인 클러스터 관리 또는 Kubernetes 환경을 장기적으로 관리하는 방법은 다루지 않습니다. 프로덕션 환경을 설정할 때 다음을 포함하여 여전히 몇 가지 질문에 직면합니다.

• 여러 인프라 제공업체 및 위치에 걸쳐 머신, 로드 밸런서, VPC 등을 일관되게 프로비저닝하려면 어떻게 해야 합니까?
• 업그레이드, 클러스터 삭제 등을 포함하여 클러스터 수명주기 관리를 자동화하려면 어떻게 해야 합니까?
• 원하는 수의 클러스터를 관리하기 위해 이러한 프로세스를 확장하려면 어떻게 해야 합니까?

SIG Cluster Lifecycle은 클러스터 생성, 구성 및 관리를 자동화하는 선언적 Kubernetes 스타일 API를 구축하여 이러한 격차를 해결하는 방법으로 Cluster API 프로젝트를 시작했습니다. 이 모델을 사용하면 필요한 모든 인프라 제공자(AWS, Azure, vSphere 등) 또는 부트스트랩 제공자(kubeadm이 기본값)를 지원하도록 클러스터 API를 확장할 수도 있습니다. 점점 늘어나는 제공업체 목록을 확인하세요 .

4.1 목표

• 선언적 API를 사용하여 Kubernetes 호환 클러스터의 수명 주기(생성, 확장, 업그레이드, 삭제)를 관리합니다.
• 온프레미스 및 클라우드 등 다양한 환경에서 작업합니다.
• 공통 작업을 정의하려면 기본 구현을 제공하고 구현을 대체 구현으로 교체하는 기능을 제공합니다.
• 기능을 복제하는 대신 기존 생태계 구성 요소를 재사용하고 통합합니다(예: 노드 문제 감지기, 클러스터 자동 크기 조정기, SIG-Multi-cluster).
• Kubernetes 라이프사이클 제품이 Cluster API를 점진적으로 채택할 수 있도록 전환 경로를 제공합니다. 특히, 기존 클러스터 수명주기 관리 도구는 여러 릴리스 과정에서 단계적으로 클러스터 API를 채택하거나 심지어 클러스터 API의 하위 집합을 채택할 수도 있어야 합니다.

4.2 비목표

• 이러한 API를 Kubernetes 코어(kubernetes/kubernetes)에 추가합니다.
• 이 API는 코어 외부의 네임스페이스에 있어야 하며 api 검토자가 정의한 모범 사례를 따라야 하지만 core-api 제약 조건이 적용되지 않습니다.
• Kubernetes 호환 클러스터 실행과 관련되지 않은 인프라의 수명주기를 관리합니다.
• 모든 Kubernetes 수명 주기 제품(kOps, Kubespray, GKE, AKS, EKS, IKS 등)이 이러한 API를 지원하거나 사용하도록 강제합니다.
• 클러스터 API가 아닌 프로비저닝된 Kubernetes 호환 클러스터를 관리합니다.
• 여러 인프라 제공업체에 걸쳐 있는 단일 클러스터를 관리합니다.
• 생성 또는 업그레이드 이외의 시간에 머신을 구성합니다.
• 존재하거나 다른 도구에 추가될 기능을 복제합니다(예: kubelet 구성 업데이트(동적 kubelet 구성 참조) 또는 클러스터 배포 후 apiserver, 컨트롤러 관리자, 스케줄러 구성 업데이트(구성 요소 구성 노력 참조)).

5 🤗 커뮤니티, 토론, 기여 및 지원

Cluster API는 공개적으로 개발되었으며 사용자, 기여자 및 유지 관리자에 의해 지속적으로 개선되고 있습니다. 우리가 커뮤니티의 클러스터 수명주기 관리를 자동화할 수 있는 것은 여러분 덕분입니다. 우리와 함께하세요!

질문이 있거나 최신 프로젝트 소식을 받고 싶으시면 다음 방법으로 저희에게 연락하실 수 있습니다.

• #cluster-api 채널 의 Kubernetes Slack 에서 우리와 채팅하세요.
• 문서와 달력에 액세스하려면 SIG Cluster Lifecycle Google 그룹 을 구독하세요.
• 최신 프로젝트 뉴스, 데모, 질문 답변 및 문제 분류를 공유하는 Cluster API 실무 그룹 세션에 참여하세요.
  • Zoom 에서 매주 수요일 @ 10:00 PT
  • 이전 회의: [ 메모 | 녹음 ]

문제에 대한 Pull Request와 피드백을 환영합니다! 어디서부터 시작해야 할지 잘 모르겠으면 이슈 추적기를 확인하세요 . 특히 Good 첫 번째 이슈 와 지원 구함 태그에 대해 알아보고, 언제든지 연락해 논의해 보세요.

참여 방법에 대한 자세한 내용은 기여자 가이드 와 Kubernetes 커뮤니티 페이지를 참조하세요.

5.1 행동강령

Kubernetes 커뮤니티 참여에는 Kubernetes 행동 강령 이 적용됩니다 .

6 같이 보기

• k8s cluster
• k8s API
• k8s Federation

7 참고

• https://cluster-api.sigs.k8s.io/
• https://github.com/kubernetes-sigs/cluster-api