calicoctl 사용자 참조

명령줄 도구 calicoctl은 Calico 네트워크와 보안 정책, 그리고 그 밖의 Calico 구성을 쉽게 관리하게 해 줘요. 이 문서는 명령 계층 구조로 정리한 calicoctl 명령줄 참조예요. 전체 명령 목록, 도움말 구조, 리소스 별칭 표까지 담고 있으니 calicoctl을 처음 접할 때 한 번쯤 훑어보면 좋아요.

출처: 문서

본문

명령줄 도구인 calicoctl은 Calico 네트워크와 보안 정책, 그리고 그 밖의 Calico 구성을 쉽게 관리하게 해 줘요.

관리할 수 있는 리소스의 전체 목록과 각 리소스의 설명은 리소스 정의 섹션에 정리되어 있어요.

SECONDARY: 이 섹션은 calicoctl의 전체 참조 정보를 제공해요. calicoctl을 설치하고 구성하는 방법은 calicoctl 설치하기를 참고하세요.

calicoctl 명령줄 인터페이스는 여러 리소스 관리 명령을 제공해서 다양한 Calico 리소스를 만들고, 수정하고, 삭제하고, 볼 수 있게 해 줘요. 이 섹션은 명령 계층 구조를 기준으로 정리한 calicoctl 명령줄 참조예요.

최상위 도움말

calicoctl --help를 실행하면 다음과 같은 최상위 calicoctl 명령 도움말 메뉴가 표시돼요.

The calicoctl command line tool is used to manage Calico network and security
policy, to view and manage endpoint configuration, and to manage a Calico
node instance.

Usage:
  calicoctl [command]

Available Commands:
  apply       Apply a resource by file, directory or stdin
  cluster     Access cluster information
  completion  Generate the autocompletion script for the specified shell
  create      Create a resource by file, directory or stdin
  datastore   Calico datastore management
  delete      Delete a resource by file, directory, stdin, or type and name
  get         Get a resource by file, directory, stdin, or type and name
  help        Help about any command
  ipam        IP address management
  label       Add or update labels of resources
  node        Calico node management
  patch       Patch a pre-existing resource in place
  replace     Replace a resource by file, directory or stdin
  validate    Validate a resource by file, directory or stdin without applying it
  version     Display the version of this binary

Flags:
      --allow-version-mismatch   Allow client and cluster versions mismatch
      --context string           The name of the kubeconfig context to use
  -h, --help                     help for calicoctl
  -l, --log-level string         Set the log level (panic, fatal, error, warn, info, debug) (default "panic")

Use "calicoctl [command] --help" for more information about a command.

SECONDARY: 멀티 클러스터 환경에서 여러 클러스터 컨텍스트를 담은 kubeconfig 파일을 사용 중이라면, calicoctl --context 인자로 컨텍스트를 직접 바꿀 수 있어요.

SECONDARY: Calico와 calicoctl의 버전은 같아야 하고, 버전이 맞지 않으면 calicoctl 호출이 실패해요. 필요하다면 --allow-version-mismatch 인자로 이 동작을 재정의할 수 있어요.

최상위 명령줄 옵션

calicoctl 명령의 세부 내용은 아래 문서에 최상위 명령별로 정리되어 있어요.

• calicoctl create
• calicoctl replace
• calicoctl apply
• calicoctl patch
• calicoctl delete
• calicoctl get
• calicoctl label
• calicoctl validate
• calicoctl ipam
• calicoctl node
• calicoctl datastore
• calicoctl cluster
• calicoctl version

저수준 컴포넌트 구성 수정하기

저수준 Felix 또는 BGP 설정(FelixConfiguration과 BGPConfiguration 리소스 타입)을 업데이트하려면:

1. calicoctl get <resource type> <resource name> -o yaml --export > config.yaml처럼 실행해서 해당 리소스를 가져오고 yaml 출력을 파일에 저장해요.
2. 저장한 리소스 파일을 수정해요.
3. calicoctl replace -f config.yaml처럼 apply 또는 replace 명령으로 리소스를 업데이트해요.

자세한 내용은 Felix 구성하기를 참고하세요.

지원되는 리소스 정의 별칭

다음 표는 calicoctl 사용 시 지원되는 Calico 리소스 별칭을 나열해요. 모든 별칭은 대소문자를 구분하지 않아요.

더 알아보기 (Learn more)

calicoctl은 kubectl과 비슷한 선언형 명령 세트를 제공하지만 Calico 리소스 전용이라는 점이 다르죠. 멀티 클러스터를 다룰 때는 --context 인자가 유용해요. 리소스별 세부 명령 문서와 리소스 정의 문서를 함께 보면 실무에서 바로 활용할 수 있어요.