• Annotation
    • 关联元数据到对象
    • 示例

    Annotation

    Annotation,顾名思义,就是注解。Annotation可以将Kubernetes资源对象关联到任意的非标识性元数据。使用客户端(如工具和库)可以检索到这些元数据。

    关联元数据到对象

    Label和Annotation都可以将元数据关联到Kubernetes资源对象。Label主要用于选择对象,可以挑选出满足特定条件的对象。相比之下,annotation 不能用于标识及选择对象。annotation中的元数据可多可少,可以是结构化的或非结构化的,也可以包含label中不允许出现的字符。

    annotation和label一样都是key/value键值对映射结构:

    1. "annotations": {
    2. "key1" : "value1",
    3. "key2" : "value2"
    4. }

    以下列出了一些可以记录在 annotation 中的对象信息:

    • 声明配置层管理的字段。使用annotation关联这类字段可以用于区分以下几种配置来源:客户端或服务器设置的默认值,自动生成的字段或自动生成的 auto-scaling 和 auto-sizing 系统配置的字段。
    • 创建信息、版本信息或镜像信息。例如时间戳、版本号、git分支、PR序号、镜像哈希值以及仓库地址。
    • 记录日志、监控、分析或审计存储仓库的指针
    • 可以用于debug的客户端(库或工具)信息,例如名称、版本和创建信息。
    • 用户信息,以及工具或系统来源信息、例如来自非Kubernetes生态的相关对象的URL信息。
    • 轻量级部署工具元数据,例如配置或检查点。
    • 负责人的电话或联系方式,或能找到相关信息的目录条目信息,例如团队网站。

    如果不使用annotation,您也可以将以上类型的信息存放在外部数据库或目录中,但这样做不利于创建用于部署、管理、内部检查的共享工具和客户端库。

    示例

    如 Istio 的 Deployment 配置中就使用到了 annotation:

    1. apiVersion: extensions/v1beta1
    2. kind: Deployment
    3. metadata:
    4. name: istio-manager
    5. spec:
    6. replicas: 1
    7. template:
    8. metadata:
    9. annotations:
    10. alpha.istio.io/sidecar: ignore
    11. labels:
    12. istio: manager
    13. spec:
    14. serviceAccountName: istio-manager-service-account
    15. containers:
    16. - name: discovery
    17. image: harbor-001.jimmysong.io/library/manager:0.1.5
    18. imagePullPolicy: Always
    19. args: ["discovery", "-v", "2"]
    20. ports:
    21. - containerPort: 8080
    22. env:
    23. - name: POD_NAMESPACE
    24. valueFrom:
    25. fieldRef:
    26. apiVersion: v1
    27. fieldPath: metadata.namespace
    28. - name: apiserver
    29. image: harbor-001.jimmysong.io/library/manager:0.1.5
    30. imagePullPolicy: Always
    31. args: ["apiserver", "-v", "2"]
    32. ports:
    33. - containerPort: 8081
    34. env:
    35. - name: POD_NAMESPACE
    36. valueFrom:
    37. fieldRef:
    38. apiVersion: v1
    39. fieldPath: metadata.namespace

    alpha.istio.io/sidecar 注解就是用来控制是否自动向 pod 中注入 sidecar 的。