해당 문서의 쿠버네티스 버전: v1.26

Kubernetes v1.26 문서는 더 이상 적극적으로 관리되지 않음. 현재 보고있는 문서는 정적 스냅샷임. 최신 문서를 위해서는, 다음을 참고. 최신 버전.

kubectl

시놉시스

kubectl은 쿠버네티스 클러스터 관리자를 제어한다.

자세한 정보는 kubectl 개요를 확인한다.

kubectl [flags]

옵션

--add-dir-header
true인 경우, 로그 메시지의 헤더에 파일 디렉터리를 추가한다.
--alsologtostderr
표준 에러와 파일에 로그를 기록한다.
--as string
작업을 수행할 사용자 이름
--as-group stringArray
작업을 수행할 그룹. 이 플래그를 반복해서 여러 그룹을 지정할 수 있다.
--azure-container-registry-config string
Azure 컨테이너 레지스트리 구성 정보가 포함된 파일의 경로이다.
--cache-dir string     기본값: "$HOME/.kube/cache"
기본 캐시 디렉터리
--certificate-authority string
인증 기관의 인증서에 대한 파일 경로
--client-certificate string
TLS용 클라이언트 인증서의 파일 경로
--client-key string
TLS용 클라이언트 키의 파일 경로
--cloud-provider-gce-l7lb-src-cidrs cidrs     기본값: 130.211.0.0/22,35.191.0.0/16
L7 LB 트래픽 프록시 및 상태 확인을 위해 GCE 방화벽에서 오픈된 CIDR
--cloud-provider-gce-lb-src-cidrs cidrs     기본값: 130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
L4 LB 트래픽 프록시 및 상태 확인을 위해 GCE 방화벽에서 오픈된 CIDR
--cluster string
사용할 kubeconfig 클러스터의 이름
--context string
사용할 kubeconfig 콘텍스트의 이름
--default-not-ready-toleration-seconds int     기본값: 300
아직 톨러레이션(toleration)이 없는 모든 파드에 기본적으로 추가되는 notReady:NoExecute에 대한 톨러레이션의 tolerationSeconds를 나타낸다.
--default-unreachable-toleration-seconds int     기본값: 300
아직 톨러레이션이 없어서 기본인 unreachable:NoExecute가 추가된 모든 파드에 대한 톨러레이션의 tolerationSeconds를 나타낸다.
-h, --help
kubectl에 대한 도움말
--insecure-skip-tls-verify
true인 경우, 서버 인증서의 유효성을 확인하지 않는다. 이렇게 하면 사용자의 HTTPS 연결이 안전하지 않게 된다.
--kubeconfig string
CLI 요청에 사용할 kubeconfig 파일의 경로이다.
--log-backtrace-at traceLocation     기본값: :0
로깅이 file:N에 도달했을 때 스택 트레이스를 내보낸다.
--log-dir string
비어 있지 않으면, 이 디렉터리에 로그 파일을 작성한다.
--log-file string
비어 있지 않으면, 이 로그 파일을 사용한다.
--log-file-max-size uint     기본값: 1800
로그 파일이 커질 수 있는 최대 크기를 정의한다. 단위는 메가 바이트이다. 값이 0이면, 파일의 최대 크기는 무제한이다.
--log-flush-frequency duration     기본값: 5s
로그를 비우는 간격의 최대 시간(초)
--logtostderr     기본값: true
파일 대신 표준 에러에 기록
--match-server-version
클라이언트 버전과 일치하는 서버 버전 필요
-n, --namespace string
지정된 경우, 해당 네임스페이스가 CLI 요청의 범위가 됨
--one-output
true이면, 로그를 기본 심각도 수준으로만 기록한다(그렇지 않으면 각각의 더 낮은 심각도 수준에도 기록함).
--password string
API 서버에 대한 기본 인증을 위한 비밀번호
--profile string     기본값: "none"
캡처할 프로파일의 이름. (none|cpu|heap|goroutine|threadcreate|block|mutex) 중 하나
--profile-output string     기본값: "profile.pprof"
프로파일을 쓸 파일의 이름
--request-timeout string     기본값: "0"
단일 서버 요청을 포기하기 전에 대기하는 시간이다. 0이 아닌 값에는 해당 시간 단위(예: 1s, 2m, 3h)가 포함되어야 한다. 값이 0이면 요청 시간이 초과되지 않는다.
-s, --server string
쿠버네티스 API 서버의 주소와 포트
--skip-headers
true이면, 로그 메시지에서 헤더 접두사를 사용하지 않는다.
--skip-log-headers
true이면, 로그 파일을 열 때 헤더를 사용하지 않는다.
--stderrthreshold severity     기본값: 2
이 임계값 이상의 로그는 표준 에러로 이동한다.
--tls-server-name string
서버 인증서 유효성 검사에 사용할 서버 이름. 제공되지 않으면, 서버에 접속하는 데 사용되는 호스트 이름이 사용된다.
--token string
API 서버 인증을 위한 베어러(Bearer) 토큰
--user string
사용할 kubeconfig 사용자의 이름
--username string
API 서버에 대한 기본 인증을 위한 사용자 이름
-v, --v Level
로그 수준의 자세한 정도를 나타내는 숫자
--version version[=true]
버전 정보를 출력하고 종료
--vmodule moduleSpec
파일 필터링 로깅을 위한 쉼표로 구분된 pattern=N 설정 목록
--warnings-as-errors
서버에서 받은 경고를 오류로 처리하고 0이 아닌 종료 코드로 종료

환경 변수

KUBECONFIG
kubectl 구성 ("kubeconfig") 파일 경로. 기본: "$HOME/.kube/config"
KUBECTL_COMMAND_HEADERS
false로 설정하면, 호출된 kubectl 명령(쿠버네티스 버전 v1.22 이상)을 자세히 설명하는 추가 HTTP 헤더를 해제

더 보기

  • kubectl annotate - 리소스에 대한 어노테이션 업데이트
  • kubectl api-resources - 서버에서 지원되는 API 리소스 출력
  • kubectl api-versions - "그룹/버전" 형식으로 서버에서 지원되는 API 버전을 출력
  • kubectl apply - 파일명 또는 표준 입력으로 리소스에 구성 적용
  • kubectl attach - 실행 중인 컨테이너에 연결
  • kubectl auth - 권한 검사
  • kubectl autoscale - 디플로이먼트(Deployment), 레플리카셋(ReplicaSet) 또는 레플리케이션컨트롤러(ReplicationController) 자동 스케일링
  • kubectl certificate - 인증서 리소스 수정
  • kubectl cluster-info - 클러스터 정보 표시
  • kubectl completion - 지정된 셸(bash 또는 zsh)에 대한 셸 완성 코드 출력
  • kubectl config - kubeconfig 파일 수정
  • kubectl cordon - 노드를 unschedulable로 표시
  • kubectl cp - 컨테이너 간에 파일과 디렉터리 복사
  • kubectl create - 파일 또는 표준 입력에서 리소스를 생성
  • kubectl debug - 워크로드와 노드의 문제 해결을 위한 디버깅 세션 생성
  • kubectl delete - 파일명, 표준 입력, 리소스 및 이름, 또는 리소스 및 레이블 셀렉터로 리소스 삭제
  • kubectl describe - 특정 리소스 또는 리소스 그룹의 세부 정보를 표시
  • kubectl diff - 적용 예정 버전과 라이브 버전 비교
  • kubectl drain - 유지 보수 준비 중 노드 드레인
  • kubectl edit - 서버에서 리소스 편집
  • kubectl exec - 컨테이너에서 커맨드 실행
  • kubectl explain - 리소스의 문서
  • kubectl expose - 레플리케이션 컨트롤러, 서비스, 디플로이먼트 또는 파드를 가져와서 새로운 쿠버네티스 서비스로 노출
  • kubectl get - 하나 이상의 리소스 표시
  • kubectl kustomize - 디렉터리 또는 원격 URL에서 kustomization 대상을 빌드
  • kubectl label - 리소스의 레이블 업데이트
  • kubectl logs - 파드의 컨테이너에 대한 로그 출력
  • kubectl options - 모든 커맨드에서 상속된 플래그 목록을 출력
  • kubectl patch - 리소스 필드를 업데이트
  • kubectl plugin - 플러그인과 상호 작용하기 위한 유틸리티를 제공
  • kubectl port-forward - 하나 이상의 로컬 포트를 파드로 전달
  • kubectl proxy - 쿠버네티스 API 서버에 대한 프록시 실행
  • kubectl replace - 파일명 또는 표준 입력으로 리소스 교체
  • kubectl rollout - 리소스 롤아웃 관리
  • kubectl run - 클러스터에서 특정 이미지 실행
  • kubectl scale - 디플로이먼트, 레플리카셋 또는 레플리케이션 컨트롤러의 새 크기 설정
  • kubectl set - 오브젝트에 특정 기능 설정
  • kubectl taint - 하나 이상의 노드에서 테인트(taint) 업데이트
  • kubectl top - 리소스(CPU/메모리/스토리지) 사용량을 표시
  • kubectl uncordon - 노드를 schedulable로 표시
  • kubectl version - 클라이언트 및 서버 버전 정보 출력
  • kubectl wait - 실험적(experimental) 기능: 하나 이상의 리소스에 대해서 특정 조건이 만족될 때까지 대기(wait)
최종 수정 July 01, 2022 at 10:35 AM PST: [ko] Update links heading to the moved pages (57a7b502b6)