"Clusterctl 개요"의 두 판 사이의 차이

 
(같은 사용자의 중간 판 5개는 보이지 않습니다)
4번째 줄: 4번째 줄:
;clusterctl 개요
;clusterctl 개요


The clusterctl CLI tool handles the lifecycle of a Cluster API management cluster.
<code>clusterctl</code> CLI 도구는 Cluster API [[Cluster API 용어집#관리 클러스터|관리 클러스터]]의 수명주기를 처리합니다.


The clusterctl command line interface is specifically designed for providing a simple “day 1 experience” and a quick start with Cluster API. It automates fetching the YAML files defining provider components and installing them.
<code>clusterctl</code> 명령줄 인터페이스는 간단한 "1일차 경험"과 Cluster API를 통한 퀵스타트를 제공하기 위해 특별히 설계되었습니다. [[Cluster API 용어집#제공자 컴포넌트|제공자 컴포넌트]]를 정의하는 YAML 파일을 가져오고 설치하는 작업을 자동화합니다.


Additionally it encodes a set of best practices in managing providers, that helps the user in avoiding mis-configurations or in managing day 2 operations such as upgrades.
또한 사용자의 잘못된 설정을 방지하거나 업그레이드와 같은 2일차 작업을 관리하는 데 도움이 되는 제공자 관리에 대한 일련의 모범사례를 내포합니다.


Below you can find a list of main clusterctl commands:
아래는 주요 clusterctl 명령어 목록입니다.
* <code>clusterctl init</code> 관리 클러스터를 초기화합니다.
* <code>clusterctl upgrade plan</code> 관리 클러스터에서 Cluster API 제공자를 업그레이드하기 위한 권장 대상 버전 목록을 제공합니다.
* <code>clusterctl upgrade apply</code> 관리 클러스터에 Cluster API 코어 및 제공자의 새 버전을 적용합니다.
* <code>clusterctl delete</code> 관리 클러스터에서 하나 이상의 제공자를 삭제합니다.
* <code>clusterctl generate cluster </code> 워크로드 클러스터 생성을 위한 템플릿을 생성합니다.
* <code>clusterctl generate yaml</code> clusterctl의 yaml 프로세서를 사용하여 yaml을 처리합니다.
* <code>clusterctl get kubeconfig</code> 워크로드 클러스터에 액세스하기 위한 kubeconfig 파일을 얻습니다.
* <code>clusterctl move</code> 관리 클러스터 간에 Cluster API 객체와 모든 해당 의존성을 이동시킵니다.
* <code>clusterctl alpha rollout</code> 클러스터 API 리소스의 롤아웃을 관리합니다. 예: MachineDeployments.


* clusterctl init Initialize a management cluster.
clusterctl 명령어 전체 목록은 [[clusterctl 명령어|명령어]]를 참조하십시오.
* clusterctl upgrade plan Provide a list of recommended target versions for upgrading Cluster API providers in a management cluster.
* clusterctl upgrade apply Apply new versions of Cluster API core and providers in a management cluster.
* clusterctl delete Delete one or more providers from the management cluster.
* clusterctl generate cluster Generate templates for creating workload clusters.
* clusterctl generate yaml Process yaml using clusterctl’s yaml processor.
* clusterctl get kubeconfig Gets the kubeconfig file for accessing a workload cluster.
* clusterctl move Move Cluster API objects and all their dependencies between management clusters.
* clusterctl alpha rollout Manages the rollout of Cluster API resources. For example: MachineDeployments.
For the full list of clusterctl commands please refer to commands.


===GitHub 레이트 제한 회피===
===GitHub 레이트 제한 회피===
28번째 줄: 28번째 줄:
퍼블릭 리포에 대한 레이트 제한을 피하려면 <code>GITHUB_TOKEN</code> 환경변수를 세팅하십시오. 토큰을 생성하려면 [https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token 이 문서를 따르세요]. 토큰에는 clusterctl를 위한 <code>repo</code> 스코프만 필요합니다.
퍼블릭 리포에 대한 레이트 제한을 피하려면 <code>GITHUB_TOKEN</code> 환경변수를 세팅하십시오. 토큰을 생성하려면 [https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token 이 문서를 따르세요]. 토큰에는 clusterctl를 위한 <code>repo</code> 스코프만 필요합니다.


기본적으로 <code>clusterctl</code>은, GitHub API에 대한 추가 API 호출을 방지하기 위해, Go 프록시를 사용하여 사용가능한 버전을 감지합니다. go 자체에 대한 <code>GOPROXY</code> 변수(기본값은 https://proxy.golang.org)를 사용하여 go 프록시 URL을 설정할 수 있습니다. GitHub 클라이언트로 즉시 대체하고 go 프록시를 사용하지 않으려면 환경변수를 <code>GOPROXY=off</code> 또는 <code>GOPROXY=direct</code>로 설정할 수 있습니다. 제공자가 Go의 시맨틱 버저닝을 따르지 않으면, <code>clusterctl</code>이 올바른 버전을 감지하는 데 실패할 수 있습니다. 이러한 경우 <code>GOPROXY=off</code>를 통해 Go 프록시 기능을 비활성화하는 것을 고려해야 합니다.
기본적으로 <code>clusterctl</code>은, GitHub API에 대한 추가 API 호출을 방지하기 위해, Go 프록시를 사용하여 사용가능한 버전을 감지합니다. go 자체에 대한 <code>GOPROXY</code> 변수(기본값은 https://proxy.golang.org )를 사용하여 go 프록시 URL을 설정할 수 있습니다. GitHub 클라이언트로 즉시 대체하고 go 프록시를 사용하지 않으려면 환경변수를 <code>GOPROXY=off</code> 또는 <code>GOPROXY=direct</code>로 설정할 수 있습니다. 제공자가 Go의 시맨틱 버저닝을 따르지 않으면, <code>clusterctl</code>이 올바른 버전을 감지하는 데 실패할 수 있습니다. 이러한 경우 <code>GOPROXY=off</code>를 통해 Go 프록시 기능을 비활성화하는 것을 고려해야 합니다.


==clusterctl 설치==
==clusterctl 설치==
Instructions are available in the Quick Start.
지침은 [[Cluster API 퀵스타트#clusterctl 설치|퀵스타트]]에서 확인할 수 있습니다.
 
==같이 보기==
* [[kubectl]]
* [[clusterctl 명령어]]
* [[clusterctl config]]


==참고==
==참고==

2024년 5월 4일 (토) 11:15 기준 최신판

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 참고[ | ]

문서 댓글 ({{ doc_comments.length }})
{{ comment.name }} {{ comment.created | snstime }}