命名空间

在 Kubernetes 中，*命名空间*提供了一种机制，用于在单个集群内隔离资源组。资源名称在命名空间内必须唯一，但跨命名空间不需要唯一。基于命名空间的作用域仅适用于命名空间范围的对象 （例如，部署、服务等），而不适用于集群范围的对象 （例如，StorageClass、节点、持久卷等）。

何时使用多个命名空间

命名空间旨在用于用户众多且分布在多个团队或项目中的环境。对于只有几个到几十个用户的集群，你根本不需要创建或考虑命名空间。当你需要命名空间提供的功能时，才开始使用它们。

命名空间为名称提供了一个作用域。资源名称在命名空间内必须唯一，但跨命名空间不需要唯一。命名空间不能嵌套在另一个命名空间内，并且每个 Kubernetes 资源只能在一个命名空间中。

命名空间是一种在多个用户之间划分集群资源的方法（通过资源配额）。

没有必要使用多个命名空间来分隔略有不同的资源，例如同一软件的不同版本：使用标签来区分同一命名空间内的资源。

初始命名空间

Kubernetes 从四个初始命名空间开始

default
Kubernetes 包含此命名空间，以便你可以在不先创建命名空间的情况下开始使用新集群。
kube-node-lease
此命名空间包含与每个节点关联的Lease 对象。节点租约允许 kubelet 发送心跳，以便控制平面可以检测节点故障。
kube-public
此命名空间可由*所有*客户端（包括未经身份验证的客户端）读取。此命名空间主要保留供集群使用，以防某些资源需要在整个集群中公开可见和可读。此命名空间的公共方面只是一种约定，而不是一项要求。
kube-system
由 Kubernetes 系统创建的对象的命名空间。

使用命名空间

命名空间的创建和删除在命名空间的管理员指南文档中进行了描述。

查看命名空间

你可以使用以下命令列出集群中的当前命名空间

kubectl get namespace

NAME              STATUS   AGE
default           Active   1d
kube-node-lease   Active   1d
kube-public       Active   1d
kube-system       Active   1d

为请求设置命名空间

要为当前请求设置命名空间，请使用 --namespace 标志。

例如

kubectl run nginx --image=nginx --namespace=<insert-namespace-name-here>
kubectl get pods --namespace=<insert-namespace-name-here>

设置命名空间偏好

你可以永久保存该上下文中所有后续 kubectl 命令的命名空间。

kubectl config set-context --current --namespace=<insert-namespace-name-here>
# Validate it
kubectl config view --minify | grep namespace:

命名空间和 DNS

当你创建一个Service 时，它会创建一个相应的DNS 记录。此记录的格式为 <服务名称>.<命名空间名称>.svc.cluster.local，这意味着如果容器仅使用 <服务名称>，它将解析为命名空间本地的服务。这对于在多个命名空间（例如开发、测试和生产）中使用相同的配置非常有用。如果要跨命名空间访问，则需要使用完全限定域名 (FQDN)。

因此，所有命名空间名称都必须是有效的RFC 1123 DNS 标签。

并非所有对象都在命名空间中

大多数 Kubernetes 资源（例如 Pod、服务、复制控制器和其他资源）都在某些命名空间中。但是，命名空间资源本身不在命名空间中。而低级资源（例如节点和持久卷）不在任何命名空间中。

要查看哪些 Kubernetes 资源在命名空间中，哪些不在命名空间中

# In a namespace
kubectl api-resources --namespaced=true

# Not in a namespace
kubectl api-resources --namespaced=false

自动标记

特性状态： Kubernetes 1.22 [稳定]

Kubernetes 控制平面在所有命名空间上设置一个不可变的标签 kubernetes.io/metadata.name。标签的值是命名空间名称。

后续步骤

上次修改时间：2024 年 6 月 12 日太平洋标准时间上午 11:05：修复指向节点心跳的断开链接 (c1d218e4d5)