clusterctl 개요

1 개요[ | ]

Overview of clusterctl
clusterctl 개요

clusterctl CLI 도구는 Cluster API 관리 클러스터의 수명주기를 처리합니다.

clusterctl 명령줄 인터페이스는 간단한 "1일차 경험"과 Cluster API를 통한 퀵스타트를 제공하기 위해 특별히 설계되었습니다. 제공자 컴포넌트를 정의하는 YAML 파일을 가져오고 설치하는 작업을 자동화합니다.

또한 사용자의 잘못된 설정을 방지하거나 업그레이드와 같은 2일차 작업을 관리하는 데 도움이 되는 제공자 관리에 대한 일련의 모범사례를 내포합니다.

아래는 주요 clusterctl 명령어 목록입니다.

clusterctl init 관리 클러스터를 초기화합니다.
clusterctl upgrade plan 관리 클러스터에서 Cluster API 제공자를 업그레이드하기 위한 권장 대상 버전 목록을 제공합니다.
clusterctl upgrade apply 관리 클러스터에 Cluster API 코어 및 제공자의 새 버전을 적용합니다.
clusterctl delete 관리 클러스터에서 하나 이상의 제공자를 삭제합니다.
clusterctl generate cluster 워크로드 클러스터 생성을 위한 템플릿을 생성합니다.
clusterctl generate yaml clusterctl의 yaml 프로세서를 사용하여 yaml을 처리합니다.
clusterctl get kubeconfig 워크로드 클러스터에 액세스하기 위한 kubeconfig 파일을 얻습니다.
clusterctl move 관리 클러스터 간에 Cluster API 객체와 모든 해당 의존성을 이동시킵니다.
clusterctl alpha rollout 클러스터 API 리소스의 롤아웃을 관리합니다. 예: 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 같이 보기[ | ]

4 참고[ | ]

https://cluster-api.sigs.k8s.io/clusterctl/overview