Information in this document may be out of date
This document has an older update date than the original, so the information it contains may be out of date. If you're able to read English, see the English version for the most up-to-date information: kubectl
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)