2017-11-09 16:48:38 +08:00
<!DOCTYPE HTML>
< html lang = "zh-hans" >
< head >
< meta charset = "UTF-8" >
< meta content = "text/html; charset=utf-8" http-equiv = "Content-Type" >
< title > 2.2.20 Annotation · Kubernetes Handbook< / title >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" / >
< meta name = "description" content = "" >
< meta name = "generator" content = "GitBook 3.2.2" >
< meta name = "author" content = "Jimmy Song" >
< link rel = "stylesheet" href = "../gitbook/style.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-splitter/splitter.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-page-toc-button/plugin.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-image-captions/image-captions.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-back-to-top-button/plugin.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-search-plus/search.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-tbfed-pagefooter/footer.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-highlight/website.css" >
< link rel = "stylesheet" href = "../gitbook/gitbook-plugin-fontsettings/website.css" >
< meta name = "HandheldFriendly" content = "true" / >
< meta name = "viewport" content = "width=device-width, initial-scale=1, user-scalable=no" >
< meta name = "apple-mobile-web-app-capable" content = "yes" >
< meta name = "apple-mobile-web-app-status-bar-style" content = "black" >
< link rel = "apple-touch-icon-precomposed" sizes = "152x152" href = "../gitbook/images/apple-touch-icon-precomposed-152.png" >
< link rel = "shortcut icon" href = "../gitbook/images/favicon.ico" type = "image/x-icon" >
< link rel = "next" href = "../guide/" / >
< link rel = "prev" href = "network-policy.html" / >
< link rel = "shortcut icon" href = '../favicon.ico' type = "image/x-icon" >
< link rel = "bookmark" href = '../favicon.ico' type = "image/x-icon" >
< style >
@media only screen and (max-width: 640px) {
.book-header .hidden-mobile {
display: none;
}
}
< / style >
< script >
window["gitbook-plugin-github-buttons"] = {"repo":"rootsongjc/kubernetes-handbook","types":["star"],"size":"small"};
< / script >
< / head >
< body >
< div class = "book" >
< div class = "book-summary" >
< div id = "book-search-input" role = "search" >
< input type = "text" placeholder = "输入并搜索" / >
< / div >
< nav role = "navigation" >
< ul class = "summary" >
< li >
< a href = "https://jimmysong.io" target = "_blank" class = "custom-link" > Home< / a >
< / li >
< li class = "divider" > < / li >
< li class = "chapter " data-level = "1.1" data-path = "../" >
< a href = "../" >
序言
< / a >
< / li >
< li class = "chapter " data-level = "1.2" data-path = "../cloud-native/kubernetes-and-cloud-native-app-overview.html" >
< a href = "../cloud-native/kubernetes-and-cloud-native-app-overview.html" >
1. Kubernetes与云原生应用概览
< / a >
< / li >
< li class = "chapter " data-level = "1.3" data-path = "./" >
< a href = "./" >
2. 概念原理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.1" data-path = "concepts.html" >
< a href = "concepts.html" >
2.1 设计理念
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2" data-path = "objects.html" >
< a href = "objects.html" >
2.2 Objects
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.2.1" data-path = "pod-overview.html" >
< a href = "pod-overview.html" >
2.2.1 Pod
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.2.1.1" data-path = "pod.html" >
< a href = "pod.html" >
2.2.1.1 Pod解析
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.1.2" data-path = "init-containers.html" >
< a href = "init-containers.html" >
2.2.1.2 Init容器
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.1.3" data-path = "pod-security-policy.html" >
< a href = "pod-security-policy.html" >
2.2.1.3 Pod安全策略
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.1.4" data-path = "pod-lifecycle.html" >
< a href = "pod-lifecycle.html" >
2.2.1.4 Pod的生命周期
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3.2.2" data-path = "node.html" >
< a href = "node.html" >
2.2.2 Node
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.3" data-path = "namespace.html" >
< a href = "namespace.html" >
2.2.3 Namespace
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.4" data-path = "service.html" >
< a href = "service.html" >
2.2.4 Service
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.5" data-path = "volume.html" >
< a href = "volume.html" >
2.2.5 Volume和Persistent Volume
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.6" data-path = "deployment.html" >
< a href = "deployment.html" >
2.2.6 Deployment
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.7" data-path = "secret.html" >
< a href = "secret.html" >
2.2.7 Secret
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.8" data-path = "statefulset.html" >
< a href = "statefulset.html" >
2.2.8 StatefulSet
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.9" data-path = "daemonset.html" >
< a href = "daemonset.html" >
2.2.9 DaemonSet
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.10" data-path = "serviceaccount.html" >
< a href = "serviceaccount.html" >
2.2.10 ServiceAccount
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.11" data-path = "replicaset.html" >
< a href = "replicaset.html" >
2.2.11 ReplicationController和ReplicaSet
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.12" data-path = "job.html" >
< a href = "job.html" >
2.2.12 Job
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.13" data-path = "cronjob.html" >
< a href = "cronjob.html" >
2.2.13 CronJob
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.14" data-path = "ingress.html" >
< a href = "ingress.html" >
2.2.14 Ingress
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.15" data-path = "configmap.html" >
< a href = "configmap.html" >
2.2.15 ConfigMap
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.3.2.15.1" data-path = "configmap-hot-update.html" >
< a href = "configmap-hot-update.html" >
2.2.15.1 ConfigMap的热更新
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.3.2.16" data-path = "horizontal-pod-autoscaling.html" >
< a href = "horizontal-pod-autoscaling.html" >
2.2.16 Horizontal Pod Autoscaling
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.17" data-path = "label.html" >
< a href = "label.html" >
2.2.17 Label
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.18" data-path = "garbage-collection.html" >
< a href = "garbage-collection.html" >
2.2.18 垃圾收集
< / a >
< / li >
< li class = "chapter " data-level = "1.3.2.19" data-path = "network-policy.html" >
< a href = "network-policy.html" >
2.2.19 NetworkPolicy
< / a >
< / li >
< li class = "chapter active" data-level = "1.3.2.20" data-path = "annotation.html" >
< a href = "annotation.html" >
2.2.20 Annotation
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4" data-path = "../guide/" >
< a href = "../guide/" >
3. 用户指南
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.1" data-path = "../guide/resource-configuration.html" >
< a href = "../guide/resource-configuration.html" >
3.1 资源对象配置
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.1.1" data-path = "../guide/configure-liveness-readiness-probes.html" >
< a href = "../guide/configure-liveness-readiness-probes.html" >
3.1.1 配置Pod的liveness和readiness探针
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.2" data-path = "../guide/configure-pod-service-account.html" >
< a href = "../guide/configure-pod-service-account.html" >
3.1.2 配置Pod的Service Account
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.3" data-path = "../guide/secret-configuration.html" >
< a href = "../guide/secret-configuration.html" >
3.1.3 Secret配置
< / a >
< / li >
< li class = "chapter " data-level = "1.4.1.4" data-path = "../guide/resource-quota-management.html" >
< a href = "../guide/resource-quota-management.html" >
3.2.3 管理namespace中的资源配额
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.2" data-path = "../guide/command-usage.html" >
< a href = "../guide/command-usage.html" >
3.2 命令使用
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.2.1" data-path = "../guide/docker-cli-to-kubectl.html" >
< a href = "../guide/docker-cli-to-kubectl.html" >
3.2.1 docker用户过度到kubectl命令行指南
< / a >
< / li >
< li class = "chapter " data-level = "1.4.2.2" data-path = "../guide/using-kubectl.html" >
< a href = "../guide/using-kubectl.html" >
3.2.2 kubectl命令概览
< / a >
< / li >
< li class = "chapter " data-level = "1.4.2.3" data-path = "../guide/kubectl-cheatsheet.html" >
< a href = "../guide/kubectl-cheatsheet.html" >
3.2.3 kubectl命令技巧大全
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.3" data-path = "../guide/cluster-security-management.html" >
< a href = "../guide/cluster-security-management.html" >
3.3 集群安全性管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.3.1" data-path = "../guide/managing-tls-in-a-cluster.html" >
< a href = "../guide/managing-tls-in-a-cluster.html" >
3.3.1 管理集群中的TLS
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.2" data-path = "../guide/kubelet-authentication-authorization.html" >
< a href = "../guide/kubelet-authentication-authorization.html" >
3.3.2 kubelet的认证授权
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.3" data-path = "../guide/tls-bootstrapping.html" >
< a href = "../guide/tls-bootstrapping.html" >
3.3.3 TLS bootstrap
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.4" data-path = "../guide/kubectl-user-authentication-authorization.html" >
< a href = "../guide/kubectl-user-authentication-authorization.html" >
3.3.4 创建用户认证授权的kubeconfig文件
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.5" data-path = "../guide/rbac.html" >
< a href = "../guide/rbac.html" >
3.3.5 RBAC——基于角色的访问控制
< / a >
< / li >
< li class = "chapter " data-level = "1.4.3.6" data-path = "../guide/ip-masq-agent.html" >
< a href = "../guide/ip-masq-agent.html" >
3.3.6 IP伪装代理
< / a >
2017-11-10 23:22:45 +08:00
< / li >
< li class = "chapter " data-level = "1.4.3.7" data-path = "../guide/auth-with-kubeconfig-or-token.html" >
< a href = "../guide/auth-with-kubeconfig-or-token.html" >
3.3.7 使用kubeconfig或token进行用户身份认证
< / a >
2017-11-09 16:48:38 +08:00
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.4" data-path = "../guide/access-kubernetes-cluster.html" >
< a href = "../guide/access-kubernetes-cluster.html" >
3.4 访问 Kubernetes 集群
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.4.1" data-path = "../guide/access-cluster.html" >
< a href = "../guide/access-cluster.html" >
3.4.1 访问集群
< / a >
< / li >
< li class = "chapter " data-level = "1.4.4.2" data-path = "../guide/authenticate-across-clusters-kubeconfig.html" >
< a href = "../guide/authenticate-across-clusters-kubeconfig.html" >
3.4.2 使用 kubeconfig 文件配置跨集群认证
< / a >
< / li >
< li class = "chapter " data-level = "1.4.4.3" data-path = "../guide/connecting-to-applications-port-forward.html" >
< a href = "../guide/connecting-to-applications-port-forward.html" >
3.4.3 通过端口转发访问集群中的应用程序
< / a >
< / li >
< li class = "chapter " data-level = "1.4.4.4" data-path = "../guide/service-access-application-cluster.html" >
< a href = "../guide/service-access-application-cluster.html" >
3.4.4 使用 service 访问群集中的应用程序
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.4.5" data-path = "../guide/application-development-deployment-flow.html" >
< a href = "../guide/application-development-deployment-flow.html" >
3.5 在kubernetes中开发部署应用
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.4.5.1" data-path = "../guide/deploy-applications-in-kubernetes.html" >
< a href = "../guide/deploy-applications-in-kubernetes.html" >
3.5.1 适用于kubernetes的应用开发部署流程
< / a >
< / li >
< li class = "chapter " data-level = "1.4.5.2" data-path = "../guide/migrating-hadoop-yarn-to-kubernetes.html" >
< a href = "../guide/migrating-hadoop-yarn-to-kubernetes.html" >
3.5.2 迁移传统应用到kubernetes中——以Hadoop YARN为例
< / a >
< / li >
< li class = "chapter " data-level = "1.4.5.3" data-path = "../guide/using-statefulset.html" >
< a href = "../guide/using-statefulset.html" >
3.5.3 使用StatefulSet部署用状态应用
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5" data-path = "../practice/" >
< a href = "../practice/" >
4. 最佳实践
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.1" data-path = "../practice/install-kbernetes1.6-on-centos.html" >
< a href = "../practice/install-kbernetes1.6-on-centos.html" >
4.1 在CentOS上部署kubernetes1.6集群
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.1.1" data-path = "../practice/create-tls-and-secret-key.html" >
< a href = "../practice/create-tls-and-secret-key.html" >
4.1.1 创建TLS证书和秘钥
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.2" data-path = "../practice/create-kubeconfig.html" >
< a href = "../practice/create-kubeconfig.html" >
4.1.2 创建kubeconfig文件
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.3" data-path = "../practice/etcd-cluster-installation.html" >
< a href = "../practice/etcd-cluster-installation.html" >
4.1.3 创建高可用etcd集群
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.4" data-path = "../practice/kubectl-installation.html" >
< a href = "../practice/kubectl-installation.html" >
4.1.4 安装kubectl命令行工具
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.5" data-path = "../practice/master-installation.html" >
< a href = "../practice/master-installation.html" >
4.1.5 部署master节点
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.6" data-path = "../practice/node-installation.html" >
< a href = "../practice/node-installation.html" >
4.1.6 部署node节点
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.7" data-path = "../practice/kubedns-addon-installation.html" >
< a href = "../practice/kubedns-addon-installation.html" >
4.1.7 安装kubedns插件
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.8" data-path = "../practice/dashboard-addon-installation.html" >
< a href = "../practice/dashboard-addon-installation.html" >
4.1.8 安装dashboard插件
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.9" data-path = "../practice/heapster-addon-installation.html" >
< a href = "../practice/heapster-addon-installation.html" >
4.1.9 安装heapster插件
< / a >
< / li >
< li class = "chapter " data-level = "1.5.1.10" data-path = "../practice/efk-addon-installation.html" >
< a href = "../practice/efk-addon-installation.html" >
4.1.10 安装EFK插件
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.2" data-path = "../practice/service-discovery-and-loadbalancing.html" >
< a href = "../practice/service-discovery-and-loadbalancing.html" >
4.2 服务发现与负载均衡
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.2.1" data-path = "../practice/traefik-ingress-installation.html" >
< a href = "../practice/traefik-ingress-installation.html" >
4.2.1 安装Traefik ingress
< / a >
< / li >
< li class = "chapter " data-level = "1.5.2.2" data-path = "../practice/distributed-load-test.html" >
< a href = "../practice/distributed-load-test.html" >
4.2.2 分布式负载测试
< / a >
< / li >
< li class = "chapter " data-level = "1.5.2.3" data-path = "../practice/network-and-cluster-perfermance-test.html" >
< a href = "../practice/network-and-cluster-perfermance-test.html" >
4.2.3 网络和集群性能测试
< / a >
< / li >
< li class = "chapter " data-level = "1.5.2.4" data-path = "../practice/edge-node-configuration.html" >
< a href = "../practice/edge-node-configuration.html" >
4.2.4 边缘节点配置
< / a >
< / li >
< li class = "chapter " data-level = "1.5.2.5" data-path = "../practice/nginx-ingress-installation.html" >
< a href = "../practice/nginx-ingress-installation.html" >
4.2.5 安装Nginx ingress
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.3" data-path = "../practice/operation.html" >
< a href = "../practice/operation.html" >
4.3 运维管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.3.1" data-path = "../practice/service-rolling-update.html" >
< a href = "../practice/service-rolling-update.html" >
4.3.1 服务滚动升级
< / a >
< / li >
< li class = "chapter " data-level = "1.5.3.2" data-path = "../practice/app-log-collection.html" >
< a href = "../practice/app-log-collection.html" >
4.3.2 应用日志收集
< / a >
< / li >
< li class = "chapter " data-level = "1.5.3.3" data-path = "../practice/configuration-best-practice.html" >
< a href = "../practice/configuration-best-practice.html" >
4.3.3 配置最佳实践
< / a >
< / li >
< li class = "chapter " data-level = "1.5.3.4" data-path = "../practice/monitor.html" >
< a href = "../practice/monitor.html" >
4.3.4 集群及应用监控
< / a >
< / li >
< li class = "chapter " data-level = "1.5.3.5" data-path = "../practice/data-persistence-problem.html" >
< a href = "../practice/data-persistence-problem.html" >
4.3.6 数据持久化问题
< / a >
< / li >
< li class = "chapter " data-level = "1.5.3.6" data-path = "../practice/manage-compute-resources-container.html" >
< a href = "../practice/manage-compute-resources-container.html" >
4.3.7 管理容器的计算资源
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.4" data-path = "../practice/storage.html" >
< a href = "../practice/storage.html" >
4.4 存储管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.4.1" data-path = "../practice/glusterfs.html" >
< a href = "../practice/glusterfs.html" >
4.4.1 GlusterFS
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.4.1.1" data-path = "../practice/using-glusterfs-for-persistent-storage.html" >
< a href = "../practice/using-glusterfs-for-persistent-storage.html" >
4.4.1.1 使用GlusterFS做持久化存储
< / a >
< / li >
< li class = "chapter " data-level = "1.5.4.1.2" data-path = "../practice/storage-for-containers-using-glusterfs-with-openshift.html" >
< a href = "../practice/storage-for-containers-using-glusterfs-with-openshift.html" >
4.4.1.2 在OpenShift中使用GlusterFS做持久化存储
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.4.2" data-path = "../practice/cephfs.html" >
< a href = "../practice/cephfs.html" >
4.4.2 CephFS
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.4.2.1" data-path = "../practice/using-ceph-for-persistent-storage.html" >
< a href = "../practice/using-ceph-for-persistent-storage.html" >
4.4.2.1 使用Ceph做持久化存储
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.5" data-path = "../practice/monitoring.html" >
< a href = "../practice/monitoring.html" >
4.5 集群与应用监控
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.5.1" data-path = "../practice/heapster.html" >
< a href = "../practice/heapster.html" >
4.5.1 Heapster
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.5.1.1" data-path = "../practice/using-heapster-to-get-object-metrics.html" >
< a href = "../practice/using-heapster-to-get-object-metrics.html" >
4.5.1.1 使用Heapster获取集群和对象的metric数据
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.5.2" data-path = "../practice/prometheus.html" >
< a href = "../practice/prometheus.html" >
4.5.2 Prometheus
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.5.2.1" data-path = "../practice/using-prometheus-to-monitor-kuberentes-cluster.html" >
< a href = "../practice/using-prometheus-to-monitor-kuberentes-cluster.html" >
4.5.2.1 使用Prometheus监控kubernetes集群
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.6" data-path = "../practice/services-management-tool.html" >
< a href = "../practice/services-management-tool.html" >
4.6 服务编排管理
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.6.1" data-path = "../practice/helm.html" >
< a href = "../practice/helm.html" >
4.6.1 使用Helm管理kubernetes应用
< / a >
< / li >
< li class = "chapter " data-level = "1.5.6.2" data-path = "../practice/create-private-charts-repo.html" >
< a href = "../practice/create-private-charts-repo.html" >
4.6.2 构建私有Chart仓库
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.7" data-path = "../practice/ci-cd.html" >
< a href = "../practice/ci-cd.html" >
4.7 持续集成与发布
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.7.1" data-path = "../practice/jenkins-ci-cd.html" >
< a href = "../practice/jenkins-ci-cd.html" >
4.7.1 使用Jenkins进行持续集成与发布
< / a >
< / li >
< li class = "chapter " data-level = "1.5.7.2" data-path = "../practice/drone-ci-cd.html" >
< a href = "../practice/drone-ci-cd.html" >
4.7.2 使用Drone进行持续集成与发布
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.5.8" data-path = "../practice/update-and-upgrade.html" >
< a href = "../practice/update-and-upgrade.html" >
4.8 更新与升级
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.5.8.1" data-path = "../practice/manually-upgrade.html" >
< a href = "../practice/manually-upgrade.html" >
4.8.1 手动升级kubernetes集群
< / a >
< / li >
< li class = "chapter " data-level = "1.5.8.2" data-path = "../practice/dashboard-upgrade.html" >
< a href = "../practice/dashboard-upgrade.html" >
4.8.2 升级dashboard
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.6" data-path = "../usecases/" >
< a href = "../usecases/" >
5. 领域应用
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.1" data-path = "../usecases/microservices.html" >
< a href = "../usecases/microservices.html" >
5.1 微服务架构
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.1.1" data-path = "../usecases/service-discovery-in-microservices.html" >
< a href = "../usecases/service-discovery-in-microservices.html" >
5.1.1 微服务中的服务发现
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.6.2" data-path = "../usecases/service-mesh.html" >
< a href = "../usecases/service-mesh.html" >
5.2 Service Mesh 服务网格
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.2.1" data-path = "../usecases/istio.html" >
< a href = "../usecases/istio.html" >
5.1.1 Istio
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.2.1.1" data-path = "../usecases/istio-installation.html" >
< a href = "../usecases/istio-installation.html" >
5.1.1.1 安装并试用Istio service mesh
< / a >
< / li >
< li class = "chapter " data-level = "1.6.2.1.2" data-path = "../usecases/configuring-request-routing.html" >
< a href = "../usecases/configuring-request-routing.html" >
5.1.1.2 配置请求的路由规则
< / a >
< / li >
< li class = "chapter " data-level = "1.6.2.1.3" data-path = "../usecases/install-and-expand-istio-mesh.html" >
< a href = "../usecases/install-and-expand-istio-mesh.html" >
5.1.1.3 安装和拓展Istio service mesh
< / a >
< / li >
< li class = "chapter " data-level = "1.6.2.1.4" data-path = "../usecases/integrating-vms.html" >
< a href = "../usecases/integrating-vms.html" >
5.1.1.4 集成虚拟机
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.6.2.2" data-path = "../usecases/linkerd.html" >
< a href = "../usecases/linkerd.html" >
5.1.2 Linkerd
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.2.2.1" data-path = "../usecases/linkerd-user-guide.html" >
< a href = "../usecases/linkerd-user-guide.html" >
5.1.2.1 Linkerd 使用指南
< / a >
< / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.6.3" data-path = "../usecases/big-data.html" >
< a href = "../usecases/big-data.html" >
5.2 大数据
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.6.3.1" data-path = "../usecases/spark-standalone-on-kubernetes.html" >
< a href = "../usecases/spark-standalone-on-kubernetes.html" >
5.2.1 Spark standalone on Kubernetes
< / a >
< / li >
< li class = "chapter " data-level = "1.6.3.2" data-path = "../usecases/running-spark-with-kubernetes-native-scheduler.html" >
< a href = "../usecases/running-spark-with-kubernetes-native-scheduler.html" >
5.2.2 运行支持kubernetes原生调度的Spark程序
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.6.4" data-path = "../usecases/serverless.html" >
< a href = "../usecases/serverless.html" >
5.3 Serverless架构
< / a >
< / li >
< li class = "chapter " data-level = "1.6.5" data-path = "../usecases/edge-computing.html" >
< a href = "../usecases/edge-computing.html" >
5.4 边缘计算
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.7" data-path = "../develop/" >
< a href = "../develop/" >
6. 开发指南
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.7.1" data-path = "../develop/developing-environment.html" >
< a href = "../develop/developing-environment.html" >
6.1 开发环境搭建
< / a >
< / li >
< li class = "chapter " data-level = "1.7.2" data-path = "../develop/testing.html" >
< a href = "../develop/testing.html" >
6.2 单元测试和集成测试
< / a >
< / li >
< li class = "chapter " data-level = "1.7.3" data-path = "../develop/client-go-sample.html" >
< a href = "../develop/client-go-sample.html" >
6.3 client-go示例
< / a >
< / li >
< li class = "chapter " data-level = "1.7.4" data-path = "../develop/contribute.html" >
< a href = "../develop/contribute.html" >
6.4 社区贡献
< / a >
< / li >
< li class = "chapter " data-level = "1.7.5" data-path = "../develop/minikube.html" >
< a href = "../develop/minikube.html" >
6.5 Minikube
< / a >
< / li >
< / ul >
< / li >
< li class = "chapter " data-level = "1.8" data-path = "../appendix/" >
< a href = "../appendix/" >
7. 附录
< / a >
< ul class = "articles" >
< li class = "chapter " data-level = "1.8.1" data-path = "../appendix/docker-best-practice.html" >
< a href = "../appendix/docker-best-practice.html" >
7.1 Docker最佳实践
< / a >
< / li >
< li class = "chapter " data-level = "1.8.2" data-path = "../appendix/issues.html" >
< a href = "../appendix/issues.html" >
7.2 问题记录
< / a >
< / li >
< li class = "chapter " data-level = "1.8.3" data-path = "../appendix/tricks.html" >
< a href = "../appendix/tricks.html" >
7.3 使用技巧
< / a >
< / li >
< li class = "chapter " data-level = "1.8.4" data-path = "../appendix/debug-kubernetes-services.html" >
< a href = "../appendix/debug-kubernetes-services.html" >
7.4 kubernetes中的应用故障排查
< / a >
< / li >
< li class = "chapter " data-level = "1.8.5" data-path = "../appendix/material-share.html" >
< a href = "../appendix/material-share.html" >
7.5 Kubernetes相关资讯和情报链接
< / a >
< / li >
< / ul >
< / li >
< li class = "divider" > < / li >
< li >
< a href = "https://www.gitbook.com" target = "blank" class = "gitbook-link" >
本书使用 GitBook 发布
< / a >
< / li >
< / ul >
< / nav >
< / div >
< div class = "book-body" >
< div class = "body-inner" >
< div class = "book-header" role = "navigation" >
<!-- Title -->
< h1 >
< i class = "fa fa-circle-o-notch fa-spin" > < / i >
< a href = ".." > 2.2.20 Annotation< / a >
< / h1 >
< / div >
< div class = "page-wrapper" tabindex = "-1" role = "main" >
< div class = "page-inner" >
< div class = "search-plus" id = "book-search-results" >
< div class = "search-noresults" >
< section class = "normal markdown-section" >
< h1 id = "annotation" > Annotation< / h1 >
< p > Annotation， 顾 名 思 义 ， 就 是 注 解 。 Annotation可 以 将 Kubernetes资 源 对 象 关 联 到 任 意 的 非 标 识 性 元 数 据 。 使 用 客 户 端 （ 如 工 具 和 库 ） 可 以 检 索 到 这 些 元 数 据 。 < / p >
< h2 id = "关联元数据到对象" > 关 联 元 数 据 到 对 象 < / h2 >
< p > Label和 Annotation都 可 以 将 元 数 据 关 联 到 Kubernetes资 源 对 象 。 Label主 要 用 于 选 择 对 象 ， 可 以 挑 选 出 满 足 特 定 条 件 的 对 象 。 相 比 之 下 ， annotation 不 能 用 于 标 识 及 选 择 对 象 。 annotation中 的 元 数 据 可 多 可 少 ， 可 以 是 结 构 化 的 或 非 结 构 化 的 ， 也 可 以 包 含 label中 不 允 许 出 现 的 字 符 。 < / p >
< p > annotation和 label一 样 都 是 key/value键 值 对 映 射 结 构 ： < / p >
< pre > < code class = "lang-json" > < span class = "hljs-string" > " annotations" < / span > : {
< span class = "hljs-string" > " key1" < / span > : < span class = "hljs-string" > " value1" < / span > ,
< span class = "hljs-string" > " key2" < / span > : < span class = "hljs-string" > " value2" < / span >
}
< / code > < / pre >
< p > 以 下 列 出 了 一 些 可 以 记 录 在 annotation 中 的 对 象 信 息 ： < / p >
< ul >
< li > 声 明 配 置 层 管 理 的 字 段 。 使 用 annotation关 联 这 类 字 段 可 以 用 于 区 分 以 下 几 种 配 置 来 源 ： 客 户 端 或 服 务 器 设 置 的 默 认 值 ， 自 动 生 成 的 字 段 或 自 动 生 成 的 auto-scaling 和 auto-sizing 系 统 配 置 的 字 段 。 < / li >
< li > 创 建 信 息 、 版 本 信 息 或 镜 像 信 息 。 例 如 时 间 戳 、 版 本 号 、 git分 支 、 PR序 号 、 镜 像 哈 希 值 以 及 仓 库 地 址 。 < / li >
< li > 记 录 日 志 、 监 控 、 分 析 或 审 计 存 储 仓 库 的 指 针 < / li >
< / ul >
< ul >
< li > 可 以 用 于 debug的 客 户 端 （ 库 或 工 具 ） 信 息 ， 例 如 名 称 、 版 本 和 创 建 信 息 。 < / li >
< li > 用 户 信 息 ， 以 及 工 具 或 系 统 来 源 信 息 、 例 如 来 自 非 Kubernetes生 态 的 相 关 对 象 的 URL信 息 。 < / li >
< li > 轻 量 级 部 署 工 具 元 数 据 ， 例 如 配 置 或 检 查 点 。 < / li >
< li > 负 责 人 的 电 话 或 联 系 方 式 ， 或 能 找 到 相 关 信 息 的 目 录 条 目 信 息 ， 例 如 团 队 网 站 。 < / li >
< / ul >
< p > 如 果 不 使 用 annotation， 您 也 可 以 将 以 上 类 型 的 信 息 存 放 在 外 部 数 据 库 或 目 录 中 ， 但 这 样 做 不 利 于 创 建 用 于 部 署 、 管 理 、 内 部 检 查 的 共 享 工 具 和 客 户 端 库 。 < / p >
< h2 id = "示例" > 示 例 < / h2 >
< p > 如 Istio 的 Deployment 配 置 中 就 使 用 到 了 annotation： < / p >
< pre > < code class = "lang-yaml" > < span class = "hljs-attr" > apiVersion:< / span > extensions/v1beta1
< span class = "hljs-attr" > kind:< / span > Deployment
< span class = "hljs-attr" > metadata:< / span >
< span class = "hljs-attr" > name:< / span > istio-manager
< span class = "hljs-attr" > spec:< / span >
< span class = "hljs-attr" > replicas:< / span > < span class = "hljs-number" > 1< / span >
< span class = "hljs-attr" > template:< / span >
< span class = "hljs-attr" > metadata:< / span >
< span class = "hljs-attr" > annotations:< / span >
alpha.istio.io/sidecar: ignore
< span class = "hljs-attr" > labels:< / span >
< span class = "hljs-attr" > istio:< / span > manager
< span class = "hljs-attr" > spec:< / span >
< span class = "hljs-attr" > serviceAccountName:< / span > istio-manager-service-account
< span class = "hljs-attr" > containers:< / span >
< span class = "hljs-attr" > - name:< / span > discovery
< span class = "hljs-attr" > image:< / span > sz-pg-oam-docker-hub< span class = "hljs-bullet" > -001.< / span > tendcloud.com/library/manager:< span class = "hljs-number" > 0.1< / span > < span class = "hljs-number" > .5< / span >
< span class = "hljs-attr" > imagePullPolicy:< / span > Always
< span class = "hljs-attr" > args:< / span > [< span class = "hljs-string" > " discovery" < / span > , < span class = "hljs-string" > " -v" < / span > , < span class = "hljs-string" > " 2" < / span > ]
< span class = "hljs-attr" > ports:< / span >
< span class = "hljs-attr" > - containerPort:< / span > < span class = "hljs-number" > 8080< / span >
< span class = "hljs-attr" > env:< / span >
< span class = "hljs-attr" > - name:< / span > POD_NAMESPACE
< span class = "hljs-attr" > valueFrom:< / span >
< span class = "hljs-attr" > fieldRef:< / span >
< span class = "hljs-attr" > apiVersion:< / span > v1
< span class = "hljs-attr" > fieldPath:< / span > metadata.namespace
< span class = "hljs-attr" > - name:< / span > apiserver
< span class = "hljs-attr" > image:< / span > sz-pg-oam-docker-hub< span class = "hljs-bullet" > -001.< / span > tendcloud.com/library/manager:< span class = "hljs-number" > 0.1< / span > < span class = "hljs-number" > .5< / span >
< span class = "hljs-attr" > imagePullPolicy:< / span > Always
< span class = "hljs-attr" > args:< / span > [< span class = "hljs-string" > " apiserver" < / span > , < span class = "hljs-string" > " -v" < / span > , < span class = "hljs-string" > " 2" < / span > ]
< span class = "hljs-attr" > ports:< / span >
< span class = "hljs-attr" > - containerPort:< / span > < span class = "hljs-number" > 8081< / span >
< span class = "hljs-attr" > env:< / span >
< span class = "hljs-attr" > - name:< / span > POD_NAMESPACE
< span class = "hljs-attr" > valueFrom:< / span >
< span class = "hljs-attr" > fieldRef:< / span >
< span class = "hljs-attr" > apiVersion:< / span > v1
< span class = "hljs-attr" > fieldPath:< / span > metadata.namespace
< / code > < / pre >
< p > < code > alpha.istio.io/sidecar< / code > 注 解 就 是 用 来 控 制 是 否 自 动 向 pod 中 注 入 sidecar 的 。 参 考 ： < a href = "http://istio.doczh.cn/docs/setup/kubernetes/sidecar-injection.html" target = "_blank" > 安 装 Istio sidecar - istio.doczh.cn< / a > 。 < / p >
< footer class = "page-footer" > < span class = "copyright" > Copyright © jimmysong.io 2017 all right reserved， powered by Gitbook< / span > < span class = "footer-modification" > Updated:
2017-11-09 16:42:47
< / span > < / footer >
< / section >
< / div >
< div class = "search-results" >
< div class = "has-results" >
< h1 class = "search-results-title" > < span class = 'search-results-count' > < / span > results matching "< span class = 'search-query' > < / span > "< / h1 >
< ul class = "search-results-list" > < / ul >
< / div >
< div class = "no-results" >
< h1 class = "search-results-title" > No results matching "< span class = 'search-query' > < / span > "< / h1 >
< / div >
< / div >
< / div >
< / div >
< / div >
< / div >
< a href = "network-policy.html" class = "navigation navigation-prev " aria-label = "Previous page: 2.2.19 NetworkPolicy" >
< i class = "fa fa-angle-left" > < / i >
< / a >
< a href = "../guide/" class = "navigation navigation-next " aria-label = "Next page: 3. 用户指南" >
< i class = "fa fa-angle-right" > < / i >
< / a >
< / div >
< script >
var gitbook = gitbook || [];
gitbook.push(function() {
2017-11-11 10:21:07 +08:00
gitbook.page.hasChanged({"page":{"title":"2.2.20 Annotation","level":"1.3.2.20","depth":3,"next":{"title":"3. 用户指南","level":"1.4","depth":1,"path":"guide/index.md","ref":"guide/index.md","articles":[{"title":"3.1 资源对象配置","level":"1.4.1","depth":2,"path":"guide/resource-configuration.md","ref":"guide/resource-configuration.md","articles":[{"title":"3.1.1 配置Pod的liveness和readiness探针","level":"1.4.1.1","depth":3,"path":"guide/configure-liveness-readiness-probes.md","ref":"guide/configure-liveness-readiness-probes.md","articles":[]},{"title":"3.1.2 配置Pod的Service Account","level":"1.4.1.2","depth":3,"path":"guide/configure-pod-service-account.md","ref":"guide/configure-pod-service-account.md","articles":[]},{"title":"3.1.3 Secret配置","level":"1.4.1.3","depth":3,"path":"guide/secret-configuration.md","ref":"guide/secret-configuration.md","articles":[]},{"title":"3.2.3 管理namespace中的资源配额","level":"1.4.1.4","depth":3,"path":"guide/resource-quota-management.md","ref":"guide/resource-quota-management.md","articles":[]}]},{"title":"3.2 命令使用","level":"1.4.2","depth":2,"path":"guide/command-usage.md","ref":"guide/command-usage.md","articles":[{"title":"3.2.1 docker用户过度到kubectl命令行指南","level":"1.4.2.1","depth":3,"path":"guide/docker-cli-to-kubectl.md","ref":"guide/docker-cli-to-kubectl.md","articles":[]},{"title":"3.2.2 kubectl命令概览","level":"1.4.2.2","depth":3,"path":"guide/using-kubectl.md","ref":"guide/using-kubectl.md","articles":[]},{"title":"3.2.3 kubectl命令技巧大全","level":"1.4.2.3","depth":3,"path":"guide/kubectl-cheatsheet.md","ref":"guide/kubectl-cheatsheet.md","articles":[]}]},{"title":"3.3 集群安全性管理","level":"1.4.3","depth":2,"path":"guide/cluster-security-management.md","ref":"guide/cluster-security-management.md","articles":[{"title":"3.3.1 管理集群中的TLS","level":"1.4.3.1","depth":3,"path":"guide/managing-tls-in-a-cluster.md","ref":"guide/managing-tls-in-a-cluster.md","articles":[]},{"title":"3.3.2 kubelet的认证授权","level":"1.4.3.2","depth":3,"path":"guide/kubelet-authentication-authorization.md","ref":"guide/kubelet-authentication-authorization.md","articles":[]},{"title":"3.3.3 TLS bootstrap","level":"1.4.3.3","depth":3,"path":"guide/tls-bootstrapping.md","ref":"guide/tls-bootstrapping.md","articles":[]},{"title":"3.3.4 创建用户认证授权的kubeconfig文件","level":"1.4.3.4","depth":3,"path":"guide/kubectl-user-authentication-authorization.md","ref":"guide/kubectl-user-authentication-authorization.md","articles":[]},{"title":"3.3.5 RBAC——基于角色的访问控制","level":"1.4.3.5","depth":3,"path":"guide/rbac.md","ref":"guide/rbac.md","articles":[]},{"title":"3.3.6 IP伪装代理","level":"1.4.3.6","depth":3,"path":"guide/ip-masq-agent.md","ref":"guide/ip-masq-agent.md","articles":[]},{"title":"3.3.7 使用kubeconfig或token进行用户身份认证","level":"1.4.3.7","depth":3,"path":"guide/auth-with-kubeconfig-or-token.md","ref":"guide/auth-with-kubeconfig-or-token.md","articles":[]}]},{"title":"3.4 访问 Kubernetes 集群","level":"1.4.4","depth":2,"path":"guide/access-kubernetes-cluster.md","ref":"guide/access-kubernetes-cluster.md","articles":[{"title":"3.4.1 访问集群","level":"1.4.4.1","depth":3,"path":"guide/access-cluster.md","ref":"guide/access-cluster.md","articles":[]},{"title":"3.4.2 使用 kubeconfig 文件配置跨集群认证","level":"1.4.4.2","depth":3,"path":"guide/authenticate-across-clusters-kubeconfig.md","ref":"guide/authenticate-across-clusters-kubeconfig.md","articles":[]},{"title":"3.4.3 通过端口转发访问集群中的应用程序","level":"1.4.4.3","depth":3,"path":"guide/connecting-to-applications-port-forward.md","ref":"guide/connecting-to-applications-port-forward.md","articles":[]},{"title":"3.4.4 使用 service 访问群集中的应用程序","level":"1.4.4.4","depth":3,"path":"guide/service-access-application-cluster.md","ref":"guide/service-access-application-cluster.md","articles":[]}]},{"title":"3.5 在kubernetes中开发部署
2017-11-09 16:48:38 +08:00
});
< / script >
< / div >
< script src = "../gitbook/gitbook.js" > < / script >
< script src = "../gitbook/theme.js" > < / script >
< script src = "../gitbook/gitbook-plugin-github/plugin.js" > < / script >
< script src = "../gitbook/gitbook-plugin-splitter/splitter.js" > < / script >
< script src = "../gitbook/gitbook-plugin-page-toc-button/plugin.js" > < / script >
< script src = "../gitbook/gitbook-plugin-editlink/plugin.js" > < / script >
< script src = "../gitbook/gitbook-plugin-back-to-top-button/plugin.js" > < / script >
< script src = "../gitbook/gitbook-plugin-search-plus/jquery.mark.min.js" > < / script >
< script src = "../gitbook/gitbook-plugin-search-plus/search.js" > < / script >
< script src = "../gitbook/gitbook-plugin-github-buttons/plugin.js" > < / script >
< script src = "../gitbook/gitbook-plugin-3-ba/plugin.js" > < / script >
< script src = "../gitbook/gitbook-plugin-sharing/buttons.js" > < / script >
< script src = "../gitbook/gitbook-plugin-fontsettings/fontsettings.js" > < / script >
< / body >
< / html >
