新聞中心
注解
你可以使用 Kubernetes 注解為對(duì)象附加任意的非標(biāo)識(shí)的元數(shù)據(jù)??蛻舳顺绦颍ɡ绻ぞ吆蛶欤┠軌颢@取這些元數(shù)據(jù)信息。

為對(duì)象附加元數(shù)據(jù)
你可以使用標(biāo)簽或注解將元數(shù)據(jù)附加到 Kubernetes 對(duì)象。 標(biāo)簽可以用來選擇對(duì)象和查找滿足某些條件的對(duì)象集合。 相反,注解不用于標(biāo)識(shí)和選擇對(duì)象。 注解中的元數(shù)據(jù),可以很小,也可以很大,可以是結(jié)構(gòu)化的,也可以是非結(jié)構(gòu)化的,能夠包含標(biāo)簽不允許的字符。
注解和標(biāo)簽一樣,是鍵/值對(duì):
"metadata": {
"annotations": {
"key1" : "value1",
"key2" : "value2"
}
}
Map 中的鍵和值必須是字符串。 換句話說,你不能使用數(shù)字、布爾值、列表或其他類型的鍵或值。
以下是一些例子,用來說明哪些信息可以使用注解來記錄:
- 由聲明性配置所管理的字段。 將這些字段附加為注解,能夠?qū)⑺鼈兣c客戶端或服務(wù)端設(shè)置的默認(rèn)值、 自動(dòng)生成的字段以及通過自動(dòng)調(diào)整大小或自動(dòng)伸縮系統(tǒng)設(shè)置的字段區(qū)分開來。
- 構(gòu)建、發(fā)布或鏡像信息(如時(shí)間戳、發(fā)布 ID、Git 分支、PR 數(shù)量、鏡像哈希、倉庫地址)。
- 指向日志記錄、監(jiān)控、分析或?qū)徲?jì)倉庫的指針。
- 可用于調(diào)試目的的客戶端庫或工具信息:例如,名稱、版本和構(gòu)建信息。
- 用戶或者工具/系統(tǒng)的來源信息,例如來自其他生態(tài)系統(tǒng)組件的相關(guān)對(duì)象的 URL。
- 輕量級(jí)上線工具的元數(shù)據(jù)信息:例如,配置或檢查點(diǎn)。
- 負(fù)責(zé)人員的電話或呼機(jī)號(hào)碼,或指定在何處可以找到該信息的目錄條目,如團(tuán)隊(duì)網(wǎng)站。
- 從用戶到最終運(yùn)行的指令,以修改行為或使用非標(biāo)準(zhǔn)功能。
你可以將這類信息存儲(chǔ)在外部數(shù)據(jù)庫或目錄中而不使用注解, 但這樣做就使得開發(fā)人員很難生成用于部署、管理、自檢的客戶端共享庫和工具。
語法和字符集
注解(Annotations) 存儲(chǔ)的形式是鍵/值對(duì)。有效的注解鍵分為兩部分: 可選的前綴和名稱,以斜杠(?/?)分隔。 名稱段是必需項(xiàng),并且必須在63個(gè)字符以內(nèi),以字母數(shù)字字符(?[a-z0-9A-Z]?)開頭和結(jié)尾, 并允許使用破折號(hào)(?-?),下劃線(?_?),點(diǎn)(?.?)和字母數(shù)字。 前綴是可選的。如果指定,則前綴必須是DNS子域:一系列由點(diǎn)(?.?)分隔的DNS標(biāo)簽, 總計(jì)不超過253個(gè)字符,后跟斜杠(?/?)。 如果省略前綴,則假定注解鍵對(duì)用戶是私有的。 由系統(tǒng)組件添加的注解 (例如,?kube-scheduler?,?kube-controller-manager?,?kube-apiserver?,?kubectl? 或其他第三方組件),必須為終端用戶添加注解前綴。
?kubernetes.io/? 和 ?K8S.io/? 前綴是為Kubernetes核心組件保留的。
例如,下面是一個(gè) Pod 的配置文件,其注解中包含 ?imageregistry: https://hub.docker.com/?:
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 分享文章:創(chuàng)新互聯(lián)kubernetes教程:Kubernetes注解
當(dāng)前網(wǎng)址:http://m.fisionsoft.com.cn/article/ccegdcc.html


咨詢
建站咨詢
