Cluster API 개발자 가이드

1 개요

Developer Guide

개발자 가이드

2 Cluster API 조각

클러스터 API는 여러 구성요소로 구성되어 있으며 올바른 작동을 위해서는 모든 구성요소가 구동되어야 합니다. 예를 들어 AWS에서 Cluster API를 사용하려면 cluster-api 매니저와 aws 매니저를 모두 설치해야 합니다.

Cluster API에는 테스트 및 개발에 사용하기에 적합한 빌트인 프로비저너인 Docker가 포함되어 있습니다. 이 가이드는 CAPD로 알려진 데몬을 시작하고 구동하는 과정을 안내합니다.

다른 제공자에는 시작하고 구동하기 위해 따라야 할 추가 단계가 있을 수 있습니다.

3 전제조건

3.1 도커

클러스터 API를 반복(개발)하려면 Docker 컨테이너를 반복적으로 빌드해야 합니다. docker 데몬 v19.03 이상이 필요합니다 .

3.2 클러스터

이미 있는 클러스터를 관리 클러스터로 사용하는 것이 좋습니다. 이를 수행하는 가장 쉬운 방법은 빠른 시작에 설명된대로 kind v0.9 이상을 사용하는 것입니다.

클러스터가 kubectl의 기본값(default)으로 세팅되어 있는지 확인하세요. 그렇지 않은 경우, 아래에 나오는 kubectl 명령어들을 수정해야 합니다.

3.3 컨테이너 레지스트리

If you’re using kind, you’ll need a way to push your images to a registry so they can be pulled. You can instead side-load all images, but the registry workflow is lower-friction.

Most users test with GCR, but you could also use something like Docker Hub. If you choose not to use GCR, you’ll need to set the REGISTRY environment variable.

3.4 Kustomize

You’ll need to install kustomize. There is a version of kustomize built into kubectl, but it does not have all the features of kustomize v3 and will not work.

3.5 Kubebuilder

You’ll need to install kubebuilder.

3.6 Envsubst

You’ll need envsubst or similar to handle clusterctl var replacement. Note: drone/envsubst releases v1.0.2 and earlier do not have the binary packaged under cmd/envsubst. It is available in Go pseudo-version v1.0.3-0.20200709231038-aa43e1c1a629

We provide a make target to generate the envsubst binary if desired. See the provider contract for more details about how clusterctl uses variables.

make envsubst The generated binary can be found at ./hack/tools/bin/envsubst

3.7 Cert-Manager

You’ll need to deploy cert-manager components on your management cluster, using kubectl

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.14.4/cert-manager.yaml Ensure the cert-manager webhook service is ready before creating the Cluster API components.

This can be done by following instructions for manual verification from the cert-manager web site. Note: make sure to follow instructions for the release of cert-manager you are installing.

8 참고

• https://cluster-api.sigs.k8s.io/developer/guide