deployment.yaml文件詳解
apiVersion: extensions/v1beta1 #接口版本
kind: Deployment #接口類型
metadata:
name: cango-demo #Deployment名稱
namespace: cango-prd #命名空間
labels:
app: cango-demo #標(biāo)簽
spec:
replicas: 3
strategy:
rollingUpdate: ##由于replicas為3,則整個升級,pod個數(shù)在2-4個之間
maxSurge: 1 #滾動升級時會先啟動1個pod
maxUnavailable: 1 #滾動升級時允許的最大Unavailable的pod個數(shù)
template:
metadata:
labels:
app: cango-demo #模板名稱必填
sepc: #定義容器模板,該模板可以包含多個容器
containers:
- name: cango-demo #鏡像名稱
image: swr.cn-east-2.myhuaweicloud.com/cango-prd/cango-demo:0.0.1-SNAPSHOT #鏡像地址
command: [ "/bin/sh","-c","cat /etc/config/path/to/special-key" ] #啟動命令
args: #啟動參數(shù)
- '-storage.local.retention=$(STORAGE_RETENTION)'
- '-storage.local.memory-chunks=$(STORAGE_MEMORY_CHUNKS)'
- '-config.file=/etc/prometheus/prometheus.yml'
- '-alertmanager.url=http://alertmanager:9093/alertmanager'
- '-web.external-url=$(EXTERNAL_URL)'
#如果command和args均沒有寫,那么用Docker默認(rèn)的配置纺讲。
#如果command寫了像鸡,但args沒有寫钦睡,那么Docker默認(rèn)的配置會被忽略而且僅僅執(zhí)行.yaml文件的command(不帶任何參數(shù)的)洁闰。
#如果command沒寫,但args寫了洋只,那么Docker默認(rèn)配置的ENTRYPOINT的命令行會被執(zhí)行划乖,但是調(diào)用的參數(shù)是.yaml中的args贬养。
#如果如果command和args都寫了,那么Docker默認(rèn)的配置被忽略琴庵,使用.yaml的配置误算。
imagePullPolicy: IfNotPresent #如果不存在則拉取
livenessProbe: #表示container是否處于live狀態(tài)。如果LivenessProbe失敗迷殿,LivenessProbe將會通知kubelet對應(yīng)的container不健康了儿礼。隨后kubelet將kill掉container,并根據(jù)RestarPolicy進(jìn)行進(jìn)一步的操作庆寺。默認(rèn)情況下LivenessProbe在第一次檢測之前初始化值為Success蚊夫,如果container沒有提供LivenessProbe,則也認(rèn)為是Success懦尝;
httpGet:
path: /health #如果沒有心跳檢測接口就為/
port: 8080
scheme: HTTP
initialDelaySeconds: 60 ##啟動后延時多久開始運行檢測
timeoutSeconds: 5
successThreshold: 1
failureThreshold: 5
readinessProbe:
httpGet:
path: /health #如果沒有心跳檢測接口就為/
port: 8080
scheme: HTTP
initialDelaySeconds: 30 ##啟動后延時多久開始運行檢測
timeoutSeconds: 5
successThreshold: 1
failureThreshold: 5
resources: ##CPU內(nèi)存限制
requests:
cpu: 2
memory: 2048Mi
limits:
cpu: 2
memory: 2048Mi
env: ##通過環(huán)境變量的方式知纷,直接傳遞pod=自定義Linux OS環(huán)境變量
- name: LOCAL_KEY #本地Key
value: value
- name: CONFIG_MAP_KEY #局策略可使用configMap的配置Key,
valueFrom:
configMapKeyRef:
name: special-config #configmap中找到name為special-config
key: special.type #找到name為special-config里data下的key
ports:
- name: http
containerPort: 8080 #對service暴露端口
volumeMounts: #掛載volumes中定義的磁盤
- name: log-cache
mount: /tmp/log
- name: sdb #普通用法陵霉,該卷跟隨容器銷毀琅轧,掛載一個目錄
mountPath: /data/media
- name: nfs-client-root #直接掛載硬盤方法,如掛載下面的nfs目錄到/mnt/nfs
mountPath: /mnt/nfs
- name: example-volume-config #高級用法第1種踊挠,將ConfigMap的log-script,backup-script分別掛載到/etc/config目錄下的一個相對路徑path/to/...下乍桂,如果存在同名文件,直接覆蓋。
mountPath: /etc/config
- name: rbd-pvc #高級用法第2中模蜡,掛載PVC(PresistentVolumeClaim)
#使用volume將ConfigMap作為文件或目錄直接掛載,其中每一個key-value鍵值對都會生成一個文件扁凛,key為文件名忍疾,value為內(nèi)容,
volumes: # 定義磁盤給上面volumeMounts掛載
- name: log-cache
emptyDir: {}
- name: sdb #掛載宿主機(jī)上面的目錄
hostPath:
path: /any/path/it/will/be/replaced
- name: example-volume-config # 供ConfigMap文件內(nèi)容到指定路徑使用
configMap:
name: example-volume-config #ConfigMap中名稱
items:
- key: log-script #ConfigMap中的Key
path: path/to/log-script #指定目錄下的一個相對路徑path/to/log-script
- key: backup-script #ConfigMap中的Key
path: path/to/backup-script #指定目錄下的一個相對路徑path/to/backup-script
- name: nfs-client-root #供掛載NFS存儲類型
nfs:
server: 10.42.0.55 #NFS服務(wù)器地址
path: /opt/public #showmount -e 看一下路徑
- name: rbd-pvc #掛載PVC磁盤
persistentVolumeClaim:
claimName: rbd-pvc1 #掛載已經(jīng)申請的pvc磁盤
Pod yaml文件詳解
# yaml格式的pod定義文件完整內(nèi)容:
apiVersion: v1 #必選谨朝,版本號卤妒,例如v1
kind: Pod #必選,Pod
metadata: #必選字币,元數(shù)據(jù)
name: string #必選则披,Pod名稱
namespace: string #必選,Pod所屬的命名空間
labels: #自定義標(biāo)簽
- name: string #自定義標(biāo)簽名字
annotations: #自定義注釋列表
- name: string
spec: #必選洗出,Pod中容器的詳細(xì)定義
containers: #必選士复,Pod中容器列表
- name: string #必選,容器名稱
image: string #必選翩活,容器的鏡像名稱
imagePullPolicy: [Always | Never | IfNotPresent] #獲取鏡像的策略 Alawys表示下載鏡像 IfnotPresent表示優(yōu)先使用本地鏡像阱洪,否則下載鏡像,Nerver表示僅使用本地鏡像
command: [string] #容器的啟動命令列表菠镇,如不指定冗荸,使用打包時使用的啟動命令
args: [string] #容器的啟動命令參數(shù)列表
workingDir: string #容器的工作目錄
volumeMounts: #掛載到容器內(nèi)部的存儲卷配置
- name: string #引用pod定義的共享存儲卷的名稱,需用volumes[]部分定義的的卷名
mountPath: string #存儲卷在容器內(nèi)mount的絕對路徑利耍,應(yīng)少于512字符
readOnly: boolean #是否為只讀模式
ports: #需要暴露的端口庫號列表
- name: string #端口號名稱
containerPort: int #容器需要監(jiān)聽的端口號
hostPort: int #容器所在主機(jī)需要監(jiān)聽的端口號蚌本,默認(rèn)與Container相同
protocol: string #端口協(xié)議,支持TCP和UDP隘梨,默認(rèn)TCP
env: #容器運行前需設(shè)置的環(huán)境變量列表
- name: string #環(huán)境變量名稱
value: string #環(huán)境變量的值
resources: #資源限制和請求的設(shè)置
limits: #資源限制的設(shè)置
cpu: string #Cpu的限制程癌,單位為core數(shù),將用于docker run --cpu-shares參數(shù)
memory: string #內(nèi)存限制出嘹,單位可以為Mib/Gib席楚,將用于docker run --memory參數(shù)
requests: #資源請求的設(shè)置
cpu: string #Cpu請求,容器啟動的初始可用數(shù)量
memory: string #內(nèi)存清楚税稼,容器啟動的初始可用數(shù)量
livenessProbe: #對Pod內(nèi)個容器健康檢查的設(shè)置烦秩,當(dāng)探測無響應(yīng)幾次后將自動重啟該容器,檢查方法有exec郎仆、httpGet和tcpSocket只祠,對一個容器只需設(shè)置其中一種方法即可
exec: #對Pod容器內(nèi)檢查方式設(shè)置為exec方式
command: [string] #exec方式需要制定的命令或腳本
httpGet: #對Pod內(nèi)個容器健康檢查方法設(shè)置為HttpGet,需要制定Path扰肌、port
path: string
port: number
host: string
scheme: string
HttpHeaders:
- name: string
value: string
tcpSocket: #對Pod內(nèi)個容器健康檢查方式設(shè)置為tcpSocket方式
port: number
initialDelaySeconds: 0 #容器啟動完成后首次探測的時間抛寝,單位為秒
timeoutSeconds: 0 #對容器健康檢查探測等待響應(yīng)的超時時間,單位秒,默認(rèn)1秒
periodSeconds: 0 #對容器監(jiān)控檢查的定期探測時間設(shè)置盗舰,單位秒晶府,默認(rèn)10秒一次
successThreshold: 0
failureThreshold: 0
securityContext:
privileged:false
restartPolicy: [Always | Never | OnFailure]#Pod的重啟策略,Always表示一旦不管以何種方式終止運行钻趋,kubelet都將重啟川陆,OnFailure表示只有Pod以非0退出碼退出才重啟,Nerver表示不再重啟該Pod
nodeSelector: obeject #設(shè)置NodeSelector表示將該Pod調(diào)度到包含這個label的node上蛮位,以key:value的格式指定
imagePullSecrets: #Pull鏡像時使用的secret名稱较沪,以key:secretkey格式指定
- name: string
hostNetwork:false #是否使用主機(jī)網(wǎng)絡(luò)模式,默認(rèn)為false失仁,如果設(shè)置為true尸曼,表示使用宿主機(jī)網(wǎng)絡(luò)
volumes: #在該pod上定義共享存儲卷列表
- name: string #共享存儲卷名稱 (volumes類型有很多種)
emptyDir: {} #類型為emtyDir的存儲卷,與Pod同生命周期的一個臨時目錄萄焦。為空值
hostPath: string #類型為hostPath的存儲卷控轿,表示掛載Pod所在宿主機(jī)的目錄
path: string #Pod所在宿主機(jī)的目錄,將被用于同期中mount的目錄
secret: #類型為secret的存儲卷拂封,掛載集群與定義的secre對象到容器內(nèi)部
scretname: string
items:
- key: string
path: string
configMap: #類型為configMap的存儲卷解幽,掛載預(yù)定義的configMap對象到容器內(nèi)部
name: string
items:
- key: string
path: string
deployment和pod
pod是一個或一組容器的集合
deployment是pod版本管理的工具 用來區(qū)分不同版本的pod
pod是可以單獨創(chuàng)建并進(jìn)行生命周期管理的
單獨創(chuàng)建pod的時候不會創(chuàng)建deployment,
但是創(chuàng)建deployment的時候一定會創(chuàng)建pod,因為pod是一個基礎(chǔ)的單位烘苹。
任何的控制器單位的具體實現(xiàn)必須落到pod去實現(xiàn)