K8s-对象

对象的spec和status

  • spec：操作员所期望的状态
  • status：实际上集群中的状态

必填字段

在上述的 .yaml 文件中，如下字段是必须填写的：

  • apiVersion 用来创建对象时所使用的Kubernetes API版本
  • kind 被创建对象的类型
  • metadata 用于唯一确定该对象的元数据：包括 name 和 namespace，如果 namespace 为空，则默认值为 default
  • spec 描述您对该对象的期望状态

名称

Kubernetes REST API 中，所有的对象都是通过 name 和 UID 唯一性确定。

Names

可以通过 namespace + name 唯一性地确定一个 RESTFUL 对象，例如：

/api/v1/namespaces/{namespace}/pods/{name}

同一个名称空间下，同一个类型的对象，可以通过 name 唯一性确定。如果删除该对象之后，可以再重新创建一个同名对象。

下面是三种广泛使用的资源名称的限制类型:

DNS Subdomain Names

绝大部分资源类型的名称必须符合 DNS subdomain 命名规则 RFC 1123 (opens new window)，具体如下：

  • 最长不超过 253个字符
  • 必须由小写字母、数字、减号 -、小数点 . 组成
  • 由字母开始
  • 由字母结束

DNS Label Names

部分类型的资源要求其名称符合 DNS Label 的命名规则 RFC 1123 (opens new window)，具体如下：

  • 最长不超过 63个字符
  • 必须由小写字母、数字、减号 -、小数点 . 组成
  • 由字母开始
  • 由字母结束

Path Segment Names

部分类型的资源要求其名称可以被编码到路径中。换句话说，名称中不能包含 .、..、/、%。

UIDs

UID 是由 Kubernetes 系统生成的，唯一标识某个 Kubernetes 对象的字符串。

Kubernetes集群中，每创建一个对象，都有一个唯一的 UID。用于区分多次创建的同名对象（如前所述，按照名字删除对象后，重新再创建同名对象时，两次创建的对象 name 相同，但是 UID 不同。）

Kubernetes 中的 UID 是全局唯一的标识符（UUIDs，符合规范 ISO/IEC 9834-8 以及 ITU-T X.667）

名称（命名）空间

可以通过 set-context 命令改变当前 kubectl 上下文 的名称空间，后续所有命令都默认在此名称空间下执行。

kubectl config set-context --current --namespace=<您的名称空间>
# 验证结果
kubectl config view --minify | grep namespace:

名称空间与DNS

当您创建一个 Service 时，Kubernetes 为其创建一个对应的 DNS 条目。该 DNS 记录的格式为 <service-name>.<namespace-name>.svc.cluster.local，也就是说，如果在容器中只使用 <service-name>，其DNS将解析到同名称空间下的 Service。这个特点在多环境的情况下非常有用，例如将开发环境、测试环境、生产环境部署在不同的名称空间下，应用程序只需要使用 <service-name> 即可进行服务发现，无需为不同的环境修改配置。如果您想跨名称空间访问服务，则必须使用完整的域名（fully qualified domain name，FQDN

并非所有对象都在名称空间里

大部分的 Kubernetes 对象（例如，Pod、Service、Deployment、StatefulSet等）都必须在名称空间里。但是某些更低层级的对象，是不在任何名称空间中的，例如 nodes、persistentVolumes、storageClass 等

# 在名称空间里
kubectl api-resources --namespaced=true

# 不在名称空间里
kubectl api-resources --namespaced=false

使用命名空间共享集群

Kubernetes 安装成功后，默认有初始化了三个名称空间：

  • default 默认名称空间，如果 Kubernetes 对象中不定义 metadata.namespace 字段，该对象将放在此名称空间下
  • kube-system Kubernetes系统创建的对象放在此名称空间下
  • kube-public 此名称空间自动在安装集群是自动创建，并且所有用户都是可以读取的（即使是那些未登录的用户）。主要是为集群预留的，例如，某些情况下，某些Kubernetes对象应该被所有集群用户看到。

命名空间拥有Resource Quota 和 resource limit range：

  • Resource quota 汇总了名称空间中使用的资源总量，并指定了集群管理员定义该名称空间最多可以使用的资源量
  • Limit range 定义了名称空间中某种具体的资源类型的最大、最小值

注解annotation

注解（annotation）可以用来向 Kubernetes 对象的 metadata.annotations 字段添加任意的信息。Kubernetes 的客户端或者自动化工具可以存取这些信息以实现其自定义的逻辑

Example:

apiVersion: v1
kind: Pod
metadata:
  name: annotations-demo
  annotations:
    imageregistry: "https://hub.docker.com/"
spec:
  containers:
  - name: nginx
    image: nginx:1.7.9
    ports:
    - containerPort: 80

字段选择器

字段选择器（Field Selector）可以用来基于的一个或多个字段的取值来选取一组Kubernetes对象。下面有一些示例性的字段选择器：

# 下面的 kubectl 命令选择了所有字段 status.phase 的取值为 Running 的 Pod：
不一样。所有的对象类型都支持的两个字段是 metadata.name 和 metadata.namespace
kubectl get pods --field-selector status.phase=Running