Namespace

无论是在同一个集群隔离多套环境,还是隔离不同团队的资源,本质上都是将集群虚拟成几个隔离的“子集群”来使用。这种在同一个集群中提供的虚拟“子集群”的隔离能力,我们称为命名空间(Namespace)。

命名空间是集群的一种“软隔离”机制,它通过这种隔离机制,为我们管理和组织集群资源提供了便利,业务应用的工作负载以及其他的 K8s 对象可以部署在特定的命名空间中,在不同命名空间中,相同类型的资源可以重名。利用这种特性,我们可以把集群虚拟的命名空间和现实中的不同团队、不同应用在逻辑上联系起来。

创建和删除

在一个 K8s 集群中,命名空间可以划分为两种类型:系统级命名空间和用户自定义命名空间。

系统级的命名空间是 K8s 集群默认创建的命名空间,主要用来隔离系统级的对象和业务对象,系统级的命名空间有下面四种。

在这几个命名空间中,除了 default 命名空间,都不应该用来部署业务应用,也不要尝试去删除它们,删除很可能会导致集群异常。

在 K8s 集群中,可以使用 kubectl get ns 命令来查看 K8s 的命名空间:

$ kubectl get ns
NAME                 STATUS   AGE
NAME                 STATUS   AGE
default              Active   24h
flux-system          Active   23h
ingress-nginx        Active   24h
kube-node-lease      Active   24h
kube-public          Active   24h
kube-system          Active   24h
local-path-storage   Active   24h

在上面的结果中,有一个我们自己创建的 flux-system,还有我们之前部署的 Ingress-Nginx 也创建了自己专属的命名空间。

要获取 Namespace 的详情,例如获取命名空间级别的资源配额等详细信息,你可以使用 kubectl describe namespace 命令:

$ kubectl describe namespace default
Name:         default
Labels:       kubernetes.io/metadata.name=default
Annotations:  <none>
Status:       Active
No resource quota.
No LimitRange resource.

要创建一个命名空间,你可以使用 kubectl create namespace 命令:

$ kubectl create namespace my-namespace
namespace/my-namespace created

注意,命名空间的名字需要符合 DNS-1123 规范,其中最重要的点是字母只支持小写,另外除了特殊字符“-”以外,其他任何特殊字符都无法使用。当你尝试创建一个不符合规范的命名空间时,K8s 将返回错误:

$ kubectl create namespace my.namespace
The Namespace "my.namespace" is invalid: metadata.name: Invalid value: "my.namespace": a lowercase RFC 1123 label must consist of lower case alphanumeric characters or '-', and must start and end with an alphanumeric character (e.g. 'my-name',  or '123-abc', regex used for validation is '[a-z0-9]([-a-z0-9]*[a-z0-9])?')

除了使用 kubectl create namespace 命令,我们还可以通过 K8s Manifest 来创建命名空间,你需要将以下内容保存为 namespace.yaml:

apiVersion: v1
kind: Namespace
metadata:
  name: my-namespace

使用 kubectl apply -f namespace.yaml 命令应用这段 Manifest,它的效果和 kubectl create namespace 是一样的。

最后,要删除命名空间,可以使用 kubectl delete namespace 命令:

$ kubectl delete namespace my-namespace
namespace "my-namespace" deleted

删除命名空间将会删除该命名空间下的所有资源,所以在实际项目中请谨慎操作。另外,由于删除动作是异步的,因此删除中的命名空间状态会由正常的 Active 转变为 Terminating,也就是“终止中的状态”。

如何使用 my-namespace 部署应用

首先,要将 K8s 对象部署在我们指定的命名空间下,你可以在资源的 Manifest 中设置 Namespace 字段,以示例应用的前端 Deployment 工作负载为例:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: frontend
  namespace: example   # 设置 namesapce
  labels:
    app: frontend
spec:
  ......

从上面的内容可以看出,metadata.namespace 字段的值为 example,这意味着该资源将部署在指定 example 命名空间下。相反,如果不指定该字段,资源就会被部署到 default 命名空间下。

此外,我们还可以通过使用 kubectl apply -n 参数指定命名空间:

$ kubectl apply -f deploy -n example

还需要注意的是,在为资源指定非 default 命名空间时,需要确保这个命名空间已经存在,否则 K8s 将会返回错误。

我们把资源部署到特定的命名空间之后,如何查看它们呢?

这种方法可以一次性指定所有部署 K8s 资源的命名空间,这是一种更加常用的方案。

$ kubectl get deployment -n default

由于 default 是默认的命名空间,所以如果我们在部署、删除和查看 K8s 对象时没有指定命名空间,就会默认都指向 default。

但是如果我们要查看非 default 命名空间下的工作负载,自然就需要指定命名空间了。例如,要查看示例应用所在的 example 命名空间下所有 Deployment 工作负载:

$ kubectl get deploy -n flux-system
NAME                          READY   UP-TO-DATE   AVAILABLE   AGE
helm-controller               1/1     1            1           23h
image-automation-controller   1/1     1            1           23h
image-reflector-controller    1/1     1            1           23h
kustomize-controller          1/1     1            1           23h
notification-controller       1/1     1            1           23h
source-controller             1/1     1            1           23h

什么时候使用命名空间?

对于一些小型团队或者小型应用,直接使用 default 也是一种选择。不过,当你有下面的需求时,我建议你考虑使用命名空间。

如何跨命名空间通信?

在使用命名空间隔离资源之后,就会涉及到如何通信的问题。我们之前说命名空间是一种“软隔离”机制,既然是软隔离,那么不同命名空间完全是可以相互通信的。

当 K8s 创建 Service 时,会创建相应的 DNS 解析记录,格式为:<service-name>.<namespace-name>.svc.cluster.local。当业务容器需要和当前命名空间下其他服务通信时,则可以省略 <namespace-name>.svc.cluster.local,也就是缩写为 <service-name> 就可以了。

同理,要跨不同的命名空间通信,我们可以指定完整的 Service URL 来实现。例如,要访问 dev 命名空间下的 backend-service,完整的 URL 为:

backend-service.dev.svc.cluster.lcoal

当然,你也可以通过配置 K8s 的网络策略来限制这种访问方式。

如何规划命名空间?

合理的命名空间规划可以让资源管理变得更加轻松,命名空间可以对应到现实中不同的隔离逻辑,例如通过命名空间来区分环境、区分业务团队、区分业务用途等等。

所以,如何合理地规划命名空间是我们刚开始使用 K8s 就要考虑的问题。K8s 命名空间只提供一种组织方式,在实际的使用过程,你可以按照自己的团队情况、组织架构、业务线等维度来进行划分。

为了能让你在实际的工作中直接使用,我为你总结了以下几种 K8s 命名空间规划方案。

单一业务应用和团队

当团队规模在几人到十几人,业务应用只有 1-2 个时,

我们将 K8s 集群划分为 3 个命名空间,分别是 dev、testing 和 prod。

注意,为了让 K8s Manifest 能部署到多个命名空间,一般我们不直接在 Manifest 的 Namespace 字段里指定命名空间,而是在实际部署时指定命名空间:

$ kubectl apply -f deploy -n dev
deployment.apps/backend created
......
Error from server (BadRequest): error when creating "deploy/ingress.yaml": admission webhook "validate.nginx.ingress.kubernetes.io" denied the request: host "_" and path "/?(.*)" is already defined in ingress example/frontend-ingress

上面这段命令,实际上是将示例应用部署到了一个新的 dev 命名空间里。不过在你执行时会返回一个错误,这是因为在不同的命名空间下设置了相同的 Ingress 策略,我们可以暂时忽略它。在实际的业务场景中,**不同环境的访问域名是不同的**,自然也就不会出现这个问题。

这样,当需要将应用部署到 QA 环境时,只需要将 -n 参数替换为 testing 即可:

$ kubectl apply -f deploy -n testing

最后,再将应用部署到 Prod 生产环境,这样就完成了应用从开发、测试到上线的完整生命周期。

多业务应用和团队

在大型的组织架构下,往往会有多个业务应用和多个团队组成,他们开发的可能是同一个大型业务,也可能是独立的应用。在这种情况下,我建议你将团队和命名空间关联起来,并且在区分环境时使用不同的集群,具体规划方案可以参考下图:

这个方案的特点是,dev、testing、prod 环境分别用了 3 个独立的集群,然后会在每一个集群中为每个独立的团队分配一个命名空间,让团队和环境之间相互隔离。当然,如果不同的团队开发的是同一个业务,相当于只是给业务做了微服务的拆分,那么在 testing 和 prod 环境就不需要再划分独立命名空间,只需要有一个命名空间将所有微服务汇总部署起来即可。