kubectl 详细介绍

最新推荐文章于 2024-09-19 21:56:07 发布
最新推荐文章于 2024-09-19 21:56:07 发布
阅读量2.1w 收藏 41
点赞数 3
文章标签： kubernetes
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/as_dingjia/article/details/120364679
版权

kubectl

kubectl 是 Kubernetes 的命令行工具（CLI），是 Kubernetes 用户和管理员必备的管理工具。

kubectl 提供了大量的子命令，方便管理 Kubernetes 集群中的各种功能。这里不再罗列各种子命令的格式，而是介绍下如何查询命令的帮助

  • kubectl -h 查看子命令列表
  • kubectl options 查看全局选项
  • kubectl <command> --help 查看子命令的帮助
  • kubectl [command] [PARAMS] -o=<format> 设置输出格式（如 json、yaml、jsonpath 等）
  • kubectl explain [RESOURCE] 查看资源的定义

配置

使用 kubectl 的第一步是配置 Kubernetes 集群以及认证方式，包括

  • cluster 信息：Kubernetes server 地址
  • 用户信息：用户名、密码或密钥
  • Context：cluster、用户信息以及 Namespace 的组合

示例

kubectl config set-credentials myself --username=admin --password=secret
kubectl config set-cluster local-server --server=http://localhost:8080
kubectl config set-context default-context --cluster=local-server --user=myself --namespace=default
kubectl config use-context default-context
kubectl config view

常用命令格式

  • 创建：kubectl run <name> --image=<image> 或者 kubectl create -f manifest.yaml
  • 查询：kubectl get <resource>
  • 更新 kubectl set 或者 kubectl patch
  • 删除：kubectl delete <resource> <name> 或者 kubectl delete -f manifest.yaml
  • 查询 Pod IP：kubectl get pod <pod-name> -o jsonpath='{.status.podIP}'
  • 容器内执行命令：kubectl exec -ti <pod-name> sh
  • 容器日志：kubectl logs [-f] <pod-name>
  • 导出服务：kubectl expose deploy <name> --port=80
  • Base64 解码：
kubectl get secret SECRET -o go-template='{{ .data.KEY | base64decode }}'

注意，kubectl run 仅支持 Pod、Replication Controller、Deployment、Job 和 CronJob 等几种资源。具体的资源类型是由参数决定的，默认为 Deployment：

创建的资源类型参数
Pod--restart=Never
Replication Controller--generator=run/v1
Deployment--restart=Always
Job--restart=OnFailure
CronJob--schedule=<cron>

命令行自动补全

Linux 系统 Bash：

source /usr/share/bash-completion/bash_completion
source <(kubectl completion bash)

MacOS zsh

source <(kubectl completion zsh)

自定义输出列

比如，查询所有 Pod 的资源请求和限制：

kubectl get pods --all-namespaces -o custom-columns=NS:.metadata.namespace,NAME:.metadata.name,"CPU(requests)":.spec.containers[*].resources.requests.cpu,"CPU(limits)":.spec.containers[*].resources.limits.cpu,"MEMORY(requests)":.spec.containers[*].resources.requests.memory,"MEMORY(limits)":.spec.containers[*].resources.limits.memory

日志查看

kubectl logs 用于显示 pod 运行中，容器内程序输出到标准输出的内容。跟 docker 的 logs 命令类似。

# Return snapshot logs from pod nginx with only one container
kubectl logs nginx

# Return snapshot of previous terminated ruby container logs from pod web-1
kubectl logs -p -c ruby web-1

# Begin streaming the logs of the ruby container in pod web-1
kubectl logs -f -c ruby web-1

注：kubectl 只可以查看单个容器的日志，如果想要同时查看多个 Pod 的日志，可以使用 stern。比如： stern --all-namespaces -l run=nginx。

连接到一个正在运行的容器

kubectl attach 用于连接到一个正在运行的容器。跟 docker 的 attach 命令类似。

  # Get output from running pod 123456-7890, using the first container by default
  kubectl attach 123456-7890

  # Get output from ruby-container from pod 123456-7890
  kubectl attach 123456-7890 -c ruby-container

  # Switch to raw terminal mode, sends stdin to 'bash' in ruby-container from pod 123456-7890
  # and sends stdout/stderr from 'bash' back to the client
  kubectl attach 123456-7890 -c ruby-container -i -t

Options:
  -c, --container='': Container name. If omitted, the first container in the pod will be chosen
  -i, --stdin=false: Pass stdin to the container
  -t, --tty=false: Stdin is a TTY

在容器内部执行命令

kubectl exec 用于在一个正在运行的容器执行命令。跟 docker 的 exec 命令类似。

多容器 Pod 可通过 kubectl.kubernetes.io/default-container annotation 配置 kubectl 命令的默认容器。

  # Get output from running 'date' from pod 123456-7890, using the first container by default
  kubectl exec 123456-7890 date

  # Get output from running 'date' in ruby-container from pod 123456-7890
  kubectl exec 123456-7890 -c ruby-container date

  # Switch to raw terminal mode, sends stdin to 'bash' in ruby-container from pod 123456-7890
  # and sends stdout/stderr from 'bash' back to the client
  kubectl exec 123456-7890 -c ruby-container -i -t -- bash -il

Options:
  -c, --container='': Container name. If omitted, the first container in the pod will be chosen
  -p, --pod='': Pod name
  -i, --stdin=false: Pass stdin to the container
  -t, --tty=false: Stdin is a TT

端口转发

kubectl port-forward 用于将本地端口转发到指定的 Pod。

# Listen on ports 5000 and 6000 locally, forwarding data to/from ports 5000 and 6000 in the pod
kubectl port-forward mypod 5000 6000

# Listen on port 8888 locally, forwarding to 5000 in the pod
kubectl port-forward mypod 8888:5000

# Listen on a random port locally, forwarding to 5000 in the pod
kubectl port-forward mypod :5000

# Listen on a random port locally, forwarding to 5000 in the pod
kubectl port-forward mypod 0:5000

也可以将本地端口转发到服务、复制控制器或者部署的端口。

# Forward to deployment
kubectl port-forward deployment/redis-master 6379:6379

# Forward to replicaSet
kubectl port-forward rs/redis-master 6379:6379

# Forward to service
kubectl port-forward svc/redis-master 6379:6379

API Server 代理

kubectl proxy 命令提供了一个 Kubernetes API 服务的 HTTP 代理。

$ kubectl proxy --port=8080
Starting to serve on 127.0.0.1:8080

可以通过代理地址 http://localhost:8080/api/ 来直接访问 Kubernetes API，比如查询 Pod 列表

curl http://localhost:8080/api/v1/namespaces/default/pods

注意，如果通过 --address 指定了非 localhost 的地址，则访问 8080 端口时会报未授权的错误，可以设置 --accept-hosts 来避免这个问题（ 不推荐生产环境这么设置 ）：

kubectl proxy --address='0.0.0.0' --port=8080 --accept-hosts='^*$'

文件拷贝

kubectl cp 支持从容器中拷贝，或者拷贝文件到容器中

  # Copy /tmp/foo_dir local directory to /tmp/bar_dir in a remote pod in the default namespace
  kubectl cp /tmp/foo_dir <some-pod>:/tmp/bar_dir

  # Copy /tmp/foo local file to /tmp/bar in a remote pod in a specific container
  kubectl cp /tmp/foo <some-pod>:/tmp/bar -c <specific-container>

  # Copy /tmp/foo local file to /tmp/bar in a remote pod in namespace <some-namespace>
  kubectl cp /tmp/foo <some-namespace>/<some-pod>:/tmp/bar

  # Copy /tmp/foo from a remote pod to /tmp/bar locally
  kubectl cp <some-namespace>/<some-pod>:/tmp/foo /tmp/bar

Options:
  -c, --container='': Container name. If omitted, the first container in the pod will be chosen

注意：文件拷贝依赖于 tar 命令，所以容器中需要能够执行 tar 命令

kubectl drain

kubectl drain NODE [Options]
  • 它会删除该 NODE 上由 ReplicationController, ReplicaSet, DaemonSet, StatefulSet or Job 创建的 Pod
  • 不删除 mirror pods（因为不可通过 API 删除 mirror pods）
  • 如果还有其它类型的 Pod（比如不通过 RC 而直接通过 kubectl create 的 Pod）并且没有 --force 选项，该命令会直接失败
  • 如果命令中增加了 --force 选项，则会强制删除这些不是通过 ReplicationController, Job 或者 DaemonSet 创建的 Pod

有的时候不需要 evict pod，只需要标记 Node 不可调用，可以用 kubectl cordon 命令。

恢复的话只需要运行 kubectl uncordon NODE 将 NODE 重新改成可调度状态。

权限检查

kubectl auth 提供了两个子命令用于检查用户的鉴权情况：

  • kubectl auth can-i 检查用户是否有权限进行某个操作，比如
  # Check to see if I can create pods in any namespace
  kubectl auth can-i create pods --all-namespaces

  # Check to see if I can list deployments in my current namespace
  kubectl auth can-i list deployments.extensions

  # Check to see if I can do everything in my current namespace ("*" means all)
  kubectl auth can-i '*' '*'

  # Check to see if I can get the job named "bar" in namespace "foo"
  kubectl auth can-i list jobs.batch/bar -n foo
  • kubectl auth reconcile 自动修复有问题的 RBAC 策略，如
  # Reconcile rbac resources from a file
  kubectl auth reconcile -f my-rbac-rules.yaml

模拟其他用户

kubectl 支持模拟其他用户或者组来进行集群管理操作，比如

kubectl drain mynode --as=superman --as-group=system:masters

这实际上就是在请求 Kubernetes API 时添加了如下的 HTTP HEADER：

Impersonate-User: superman
Impersonate-Group: system:masters

查看事件（events）

# 查看所有事件
kubectl get events --all-namespaces

# 查看名为nginx对象的事件
kubectl get events --field-selector involvedObject.name=nginx,involvedObject.namespace=default

# 查看名为nginx的服务事件
kubectl get events --field-selector involvedObject.name=nginx,involvedObject.namespace=default,involvedObject.kind=Service

# 查看Pod的事件
kubectl get events --field-selector involvedObject.name=nginx-85cb5867f-bs7pn,involvedObject.kind=Pod

# 按时间对events排序
kubectl get events --sort-by=.metadata.creationTimestamp

# 自定义events输出格式
kubectl get events  --sort-by='.metadata.creationTimestamp'  -o 'go-template={{range .items}}{{.involvedObject.name}}{{"\t"}}{{.involvedObject.kind}}{{"\t"}}{{.message}}{{"\t"}}{{.reason}}{{"\t"}}{{.type}}{{"\t"}}{{.firstTimestamp}}{{"\n"}}{{end}}'

kubectl 插件

kubectl 插件提供了一种扩展 kubectl 的机制，比如添加新的子命令。插件可以以任何语言编写，只需要满足以下条件即可

  • 插件放在 ~/.kube/plugins 或环境变量 KUBECTL_PLUGINS_PATH 指定的目录中
  • 插件的格式为 子目录 / 可执行文件或脚本 且子目录中要包括 plugin.yaml 配置文件

比如

$ tree
.
└── hello
    └── plugin.yaml

1 directory, 1 file

$ cat hello/plugin.yaml
name: "hello"
shortDesc: "Hello kubectl plugin!"
command: "echo Hello plugins!"

$ kubectl plugin hello
Hello plugins!

你也可以使用 krew 来管理 kubectl 插件。

原始 URI

kubectl 也可以用来直接访问原始 URI，比如要访问 Metrics API 可以

  • kubectl get --raw /apis/metrics.k8s.io/v1beta1/nodes
  • kubectl get --raw /apis/metrics.k8s.io/v1beta1/pods
  • kubectl get --raw /apis/metrics.k8s.io/v1beta1/nodes/<node-name>
  • kubectl get --raw /apis/metrics.k8s.io/v1beta1/namespaces/<namespace-name>/pods/<pod-name>

附录

kubectl 的安装方法

# OS X
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl

# Linux
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl

# Windows
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/rel
鞍山陆家嘴
关注
KubectlShortcuts:kubectl快捷方式
04-08
本篇文章将详细介绍 `kubectl` 的常用快捷方式和技巧，帮助你更高效地与 Kubernetes 集群交互。 ### 1. 查看集群信息 - `kubectl cluster-info`: 显示集群的基本信息，包括 API 服务器地址。 - `kubectl config ...
kubectl基础命令详解（一）
OSoooo的博客
11-02 2万+
文章目录1，kubectl概述2,命令1、基本信息查看 1，kubectl概述 陈述式资源管理方法（只能通过kubeclt调度apiserver）: 1.kubernetes集群管理集群资源的唯一入口是通过相应的方法调用apiserver的接口 2. kubectl 是官方的CLI命令行工具，用于与apiserver 进行通信，将用户在命令行输入的命令，组织并转化为apiserver能识别的信息，进而实现管理k8s 各种资源的一种有效途径 3. kubectl 的命令大全 kubectl --help k8
kubectl 详解
q1y2y3的博客
08-07 3928
kubernetes 集群管理集群资源的唯一入口是通过相应的方法调用 apiserver 的接口kubectl 是官方的CLI命令行工具，用于与 apiserver 进行通信，将用户在命令行输入的命令，组织并转化为 apiserver 能识别的信息，进而实现管理 k8s 各种资源的一种有效途径。对资源的增、删、查操作比较方便，但对改的操作就不容易了kubectl的使用学习kubectl --help 或 kubectl -h。
在 Kubernetes 中，kubectl create -f 命令与 kubectl apply –f的区别
最新发布
m0_54115953的博客
09-19 198
因为它提供了更大的灵活性和更好的错误处理机制。但是，在某些情况下，如果你确实需要确保某个资源只被创建一次（例如，创建一个唯一的。当你第一次将资源部署到集群中时，你会使用这个命令。然而，一旦资源被创建，如果你尝试再次使用相同的文件运行。不过，即使在这种情况下，也可以通过一些额外的逻辑（如检查资源是否存在）来安全地使用。它不仅可以用于资源的初始创建，还可以用于更新已存在的资源。会比较当前配置和你提供的配置文件之间的差异，并只应用必要的更改。，并且该资源已经存在，那么命令通常会失败，然而，需要注意的是，
四、Kubernetes（K8S）：kubectl概述、安装、设置
SteveRocket's-Blog
05-19 8168
kubectl是Kubernetes命令行工具。它允许用户与Kubernetes集群进行交互，并管理Kubernetes对象，如Pod、Service、Deployment等。kubectl可以在命令行界面中使用，也可以在脚本中使用，并将Kubernetes集群的状态和操作暴露给自动化工具和CI/CD管道。它是Kubernetes的重要组件之一，并被广泛用于管理容器化应用程序。 kubectl是kubernetes声明式 API的客户端，所以 kubectl 的主要功能就是用来操作对象的。
【kubectl详解】最全的kubectl命令用法
weixin_56364253的博客
07-05 3807
该文章详细对kubect命令行的参数进行讲解，并将api-resource的信息整理成列表，方便查看，同时通过一系列的实践操作的命令来进行举例，便于更深刻的了解和掌握该命令的用法。
【kubectl详解】
DiKL_Y的博客
08-11 1356
kubectl的详细解释
Kubernetes之kubectl常用命令使用指南.pdf
07-14
本文将介绍一些高频的 kubectl 命令，包括创建和删除相关的命令，并解释它们的使用场景和解决的问题。 kubectl run 命令 kubectl run 命令用于在集群上运行一个镜像，类似于 docker run 命令。例如，下面命令将...
kubectl-login:使用oidc与身份提供者进行kubectl身份验证
03-17
本文将详细介绍如何使用 `kubectl-login` 和 OIDC 进行 `kubectl` 身份验证，并探讨相关知识点。 首先，了解 `kubectl-login` 是关键。这是一个 Python 脚本，用于简化通过 OIDC 进行 `kubectl` 认证的过程。它的...
Kubernetes(k8s)基础介绍
09-30
在Kubernetes中，通常通过YAML文件定义资源对象，如Pod、Deployment、Service和Ingress，然后使用`kubectl apply`命令将这些配置应用到集群。YAML文件详细描述了资源的属性，包括容器镜像、副本数、端口映射等。 ...
kubernetes-vagrant：在虚拟机中启动单个kubernetes节点并使用kubectl对其进行管理
02-06
下面将详细介绍这个过程以及涉及的相关知识点： 1. **Kubernetes基础知识**： - **Pod**：Kubernetes的基本运行单元，包含一个或多个容器。 - **Service**：定义了访问Pod的逻辑抽象，确保即使Pod重启，服务仍可...
Kubernetes——Kubectl详解
一坨小橙子的博客
05-21 2159
Kubectl详解，使用陈述式管理办法和声明式管理办法对kubectl基础命令进行基础的增删改查的操作
Kubectl常用命令详解
热门推荐
ss810540895的博客
05-17 2万+
原文 Kubectl常用命令详解 本文介绍k8s集群管理命令Kubectl分类和命令详解。 内容 1. kubectl命令列表分类 （1）Basic Commands(Beginner)基础命令（初级） kubectl create 通过yaml/json 文件或者标准输入创建一个资源对象，支持很多子命令 例如namespace pod deployment service等 kubectl expose 将json/yaml文件中定义的资源对象的端口暴露给新的service资源对象 kubectl
Kubernetes之kubectl命令详解及常用示例
Java+GO+JS全栈工程师-鹤冲天的博客：编程辅导~商务合作~技术交流
02-08 9025
kubectl是操作k8s集群的命令行工具，kubectl通过与apiserver交互可以实现对k8s集群中各种资源的增删改查。接下来将会介绍kubectl语法，命令行的操作，并介绍常见的示例。
K8s之Kubectl 命令总结
果子哥丶的博客
04-23 1261
kubectl介绍工具使用参数使用相关配置创建资源对象查看资源对象查看资源描述更新修补资源删除资源对象编辑资源文件直接执行命令查看容器日志 介绍 kubectl 是 Kubernetes 自带的客户端，可以用它来直接操作 Kubernetes 集群。 Kubernetes API 是一个 HTTP REST API 服务，该 API 服务才是 Kubernetes 的真正用到的用户接口，所以 Kubernetes 通过该 API 进行实际的控制。这也就意味着每个 Kubernetes 的操作都会通过 API
【Kubernetes】什么是 kubectl
书山有路，学海无涯。记录成长，追逐梦想
12-30 1776
在学习如何更有效地使用 kubectl 之前，您应该对它是什么以及它如何工作有一个基本的了解。从用户的角度来看，kubectl 是你控制 Kubernetes 的驾驶舱。它允许您执行所有可能的 Kubernetes 操作。从技术角度来看，kubectl 是 Kubernetes API 的客户端。
kubectl常用命令大全详解
养歌的博客
07-18 1万+
这是我转载的一个博主写的 K8s 常用命令大全，看了我写的入门基础篇linkKubernetes kubectl 命令表【中文网址】 Kubernetes kubectl 命令表要使用和维护Kubernetes集群，最常用且直接的方式，就是使用自带的命令行工具Kubectl。 下面图片是一个总览，熟悉后可以用于勾起记忆。 [root@master ~]# kubectl create -f demo-deployment.yaml [root@master ~]# kubectl create -f dem
kubectl 命令详细介绍
wyq2070857323的博客
05-21 1921
kubectl exec可以跨主机登录容器，docker exec 只能在容器所在主机上登录命令作用查看版本信息查看资源对象简写node节点查看日志配置kubectl自动补全查看集群信息查看服务端点。
kubectl工具详解
qq_59323083的博客
07-17 1051
kubectl工具详解
给我详细介绍一下secret
02-06
secret 是 Kubernetes 中用来存储敏感信息（如密码、API 密钥等）的对象。它可以用来保存任何类型的数据，但是默认情况下它会将数据加密并保存在 Kubernetes 集群的 etcd 数据库中。使用 secret 对象可以更安全地管理敏感信息，而不用担心将其明文存储在配置文件或环境变量中。 secret 对象由两部分组成：数据和类型。数据是 key-value 形式的键值对，类型用来指定 secret 对象的用途。例如，类型可以是 "Opaque"（默认类型），也可以是 "kubernetes.io/tls"，表示 secret 对象存储的是 TLS 证书。 secret 对象可以通过 kubectl 命令创建和管理。例如，可以使用 "kubectl create secret" 命令创建 secret 对象，使用 "kubectl get secret" 查询 secret 对象，使用 "kubectl delete secret" 删除 secret 对象。 在 k8s 中，secret 对象可以被 pods 和 deployment 等资源使用，来保证敏感信息的安全性。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值