1 개요
- Overview of clusterctl
- clusterctl 개요
Clusterctl CLI 도구는 클러스터 API 관리 클러스터의 수명주기를 처리합니다.
clusterctl 명령줄 인터페이스는 간단한 "1일차 경험"과 Cluster API를 통한 퀵스타트를 제공하기 위해 특별히 설계되었습니다. 제공자 컴포넌트를 정의하는 YAML 파일을 가져오고 설치하는 작업을 자동화합니다.
또한 사용자의 잘못된 설정을 방지하거나 업그레이드와 같은 2일차 작업을 관리하는 데 도움이 되는 제공자 관리에 대한 일련의 모범사례를 내포합니다.
아래는 주요 clusterctl 명령어 목록입니다.
clusterctl initInitialize a management cluster.clusterctl upgrade planProvide a list of recommended target versions for upgrading Cluster API providers in a management cluster.clusterctl upgrade applyApply new versions of Cluster API core and providers in a management cluster.clusterctl deleteDelete one or more providers from the management cluster.clusterctl generatecluster Generate templates for creating workload clusters.clusterctl generate yamlProcess yaml using clusterctl’s yaml processor.clusterctl get kubeconfigGets the kubeconfig file for accessing a workload cluster.clusterctl moveMove Cluster API objects and all their dependencies between management clusters.clusterctl alpha rolloutManages the rollout of Cluster API resources. For example: MachineDeployments.
clusterctl 명령어 전체 목록은 명령어를 참조하십시오.
1.1 GitHub 레이트 제한 회피
GitHub에서 호스팅되는 제공자를 사용하는 동안, clusterctl은 레이트 제한된 GitHub API를 호출합니다. 일반적인 사용에는 프리 티어면 충분하지만 clusterctl을 광범위하게 사용하면 사용자가 레이트 제한에 도달할 수 있습니다.
퍼블릭 리포에 대한 레이트 제한을 피하려면 GITHUB_TOKEN 환경변수를 세팅하십시오. 토큰을 생성하려면 이 문서를 따르세요. 토큰에는 clusterctl를 위한 repo 스코프만 필요합니다.
기본적으로 clusterctl은, GitHub API에 대한 추가 API 호출을 방지하기 위해, Go 프록시를 사용하여 사용가능한 버전을 감지합니다. go 자체에 대한 GOPROXY 변수(기본값은 https://proxy.golang.org )를 사용하여 go 프록시 URL을 설정할 수 있습니다. GitHub 클라이언트로 즉시 대체하고 go 프록시를 사용하지 않으려면 환경변수를 GOPROXY=off 또는 GOPROXY=direct로 설정할 수 있습니다. 제공자가 Go의 시맨틱 버저닝을 따르지 않으면, clusterctl이 올바른 버전을 감지하는 데 실패할 수 있습니다. 이러한 경우 GOPROXY=off를 통해 Go 프록시 기능을 비활성화하는 것을 고려해야 합니다.
2 clusterctl 설치
지침은 퀵스타트에서 확인할 수 있습니다.
3 참고
-
{{comment.page_title}} ―{{comment.name}}