해당 문서의 쿠버네티스 버전: v1.27
Kubernetes v1.27 문서는 더 이상 적극적으로 관리되지 않음. 현재 보고있는 문서는 정적 스냅샷임. 최신 문서를 위해서는, 다음을 참고. 최신 버전.
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_EXPLAIN_OPENAPIV3 |
`kubectl explain` 호출에 사용 가능한 새로운 OpenAPIv3 데이터 소스를 사용할지 여부를 전환. 쿠버네티스 1.24 이후로, OpenAPIV3 는 기본적으로 활성화 되어있다. |
더 보기
- 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 events - 이벤트 목록 나열
- 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)
최종 수정 February 23, 2023 at 9:03 AM PST: [ko] Update outdated files in dev-1.26-ko.1 (M112-M125) (41aeff23ce)