ack-onepilot組件介紹、使用說明及變更記錄 - Container Service for Kubernetes

ack-onepilot是阿里雲ARMS針對Kubernetes應用接入情境提供的探針接入助手。本文介紹ack-onepilot組件的資訊、使用說明和變更記錄。

組件介紹

ack-onepilot是ACK面向ARMS與MSE使用者提供的系統組件，協助使用者更便捷地接入ARMS與MSE。組件提供以下功能。

在容器環境中自動添加探針上報所需的環境變數，並準備探針包，確保在容器環境中能夠高效、準確地收集和上報Java、Golang、Python應用的拓撲資料、介面調用、異常事務和慢事務等監控資料。
將部署在叢集中的Spring Cloud和Dubbo等微服務應用接入MSE治理中心，使用MSE提供的一系列服務治理能力，提升線上微服務的穩定性和開發效率，

關於ack-onepilot的基本原理，請參見ack-onepilot組件基本原理說明。

使用說明

ack-onepilot接入ARMS：
- ACK叢集中的Java應用接入應用監控，請參見Container ServiceACK環境自動安裝探針。
- ACK叢集中的Golang應用接入應用監控，請參見Container ServiceACK通過ack-onepilot組件安裝Go探針。
- ACK叢集中的Golang應用接入應用監控，請參見Container ServiceACK通過ack-onepilot組件安裝Python探針。
ack-onepilot接入MSE，請參見ACK微服務應用接入MSE治理中心。

變更記錄

2024年11月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.3.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.3

2024年11月21日

適配istio DNS代理情境下的探針接入。
調整ack-onepilot的健全狀態檢查時間，加速ack-onepilot的啟動。

此次升級不會對業務造成影響。

3.3.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.2

2024年11月07日

最佳化未接入MSE時MSE相關的日誌和事件提示邏輯。

此次升級不會對業務造成影響。

2024年10月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.3.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.1

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.1

2024年10月29日

無損下線Sidecar注入支援跳過。
增加日誌上報欄位。

此次升級不會對業務造成影響。

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.3.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.3.0

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.3.0

2024年10月11日

支援探針漸進式升級。
修複部分網路不通情況下接入失敗的問題。
修複部分情境下Helm解析失敗的問題。

此次升級不會對業務造成影響。

2024年09月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.2.5

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.5

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.5

2024年09月10日

修複使用MSE情境下的一個偶發重啟問題。

此次升級不會對業務造成影響。

3.2.4

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.4

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.4

2024年09月03日

支援Python語言應用的接入。
MSE修複無損上下線的部分Bug。

此次升級不會對業務造成影響。

2024年07月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.2.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.3

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.3

2024年07月30日

MSE支援Go語言服務端治理相關功能。

此次升級不會對業務造成影響。

3.2.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot:3.2.2

registry.{REGION}.aliyuncs.com/acs/ack-onepilot-init:3.2.2

2024年07月05日

修複ARMS參數異常導致應用啟動失敗的問題。

此次升級不會對業務造成影響。

2024年06月

版本號碼	鏡像地址	變更時間	變更內容	變更影響
3.2.0	registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.2.0 registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.2.0	2024年06月19日	支援Go語言應用的接入。 Java應用支援自動注入崩潰日誌收集參數。	此次升級不會對業務造成影響。
3.1.2	registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.1.2 registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.1.2	2024年06月19日	修複部分弱網情境下由於軟連結處理問題引起的接入失敗。	此次升級不會對業務造成影響。
3.1.1	registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.1.1 registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.1.1	2024年06月13日	修複網路不穩定情況下Agent包下載不完整的問題。修複使用pilotx時init-container被注入兩次的問題。	此次升級不會對業務造成影響。

2024年05月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.1.0

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.1.0

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.1.0

2024年05月30日

支援使用Jar包方式下載Agent包。
探針包名更改為aliyun-java-agent.jar，探針的全路徑更改為/home/admin/.opt/AliyunJavaAgent/aliyun-java-agent.jar。
init-container預設記憶體佔用從100MB增大到250MB。

3.1.0 ack-onepilot將不再支援2.7.3.5以下版本探針的接入，請使用以上探針版本的使用者升級探針版本或者不要升級到本ack-onepilot版本。

2024年04月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.20

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.20

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.20

2024年04月17日

修複開源Kubernetes叢集無法接入公網時ack-onepilot啟動失敗的問題。

此次升級不會對業務造成影響。

2024年03月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.19

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.19

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.19

2024年03月23日

修複新應用接入時偶發跳轉至ARMS控制台失敗的問題。
修複StatefulSet應用接入失敗的問題。
修複服務網格應用接入不生效的問題。

此次升級不會對業務造成影響。

2024年03月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.18

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.18

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.18

2024年03月13日

更新了K8s SDK版本，可支援gRPC健全狀態檢查。
自動適配服務網格網路環境。
修複arms.workload環境變數偶發注入為空白的問題。

此次升級不會對業務造成影響。

2023年12月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.17

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.17

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.17

2023年12月26日

支援下載新版本探針。
修複內網連線逾時問題。
新增更新版本時建立K8s事件的功能。

此次升級不會對業務造成影響。

2023年11月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.16

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.16

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.16

2023年11月28日

支援使用Tar包方式下載Agent包。

此次升級不會對業務造成影響。

2023年10月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.15

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.15

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.15

2023年10月18日

新增ack-onepilot資源配置。

此次升級不會對業務造成影響。

2023年09月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.14

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.14

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.14

2023年09月05日

新增支援優雅升級。
ARMS使用者支援通過跨帳號配置AccessKey ID和AccessKey Secret，實現接入。
MSE去除對AliyunMSEForECIRole的依賴。
修複Pod環境變數重複的問題。

此次升級不會對業務造成影響。

2023年08月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.13

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.13

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.13

2023年08月18日

新增支援Arm 64架構。
最佳化Metrics指標和監控Agent掛載成功率。
修複在Webhook階段同步建立Client逾時的問題。

此次升級不會對業務造成影響。

2023年06月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.12

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.12

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.12

2023年06月20日

最佳化ack-onepilot組件效能。

此次升級不會對業務造成影響。

2023年04月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.11

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.11

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.11

2023年04月20日

修複許可權問題。
支援環境變數設定CPU、MEM（記憶體）大小。

此次升級不會對業務造成影響。

2023年03月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.10

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot:3.0.10

registry.{REGION}.ack.aliyuncs.com/acs/ack-onepilot-init:3.0.10

2023年03月24日

修複環境變數問題。
修複Ingress支援問題。
完善國際化文檔支援。
添加對Helm2的支援。

此次升級不會對業務造成影響。

2023年02月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.9

2023年02月20日

支援通過Kubernetes的Namespace Label來控制接入的微服務命名空間。
修複ARMS接入問題。

此次升級不會對業務造成影響。

3.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.8

2023年02月08日

簡化部署Pod數量。
修複Service Mesh接入問題。

此次升級不會對業務造成影響。

2023年01月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.7

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.7

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.7

2023年01月16日

MSE微服務治理接入支援不同Namespace，可以通過Pod的mseNamespace來控制接入的微服務命名空間名字。

此次升級不會對業務造成影響。

2022年11月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.6

2022年11月17日

刪除廢棄組件mseruletrait。

此次升級不會對業務造成影響。

2022年10月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.5

2022年10月21日

支援阿里雲Ingress灰階。

此次升級不會對業務造成影響。

2022年08月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.4

2022年08月17日

標籤中心支援ACK環境下打標並同步部分標籤。

此次升級不會對業務造成影響。

2022年07月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.3

2022年07月19日

支援通過Pod的Label配置無損上線。

此次升級不會對業務造成影響。

3.0.2

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.2

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.2

2022年07月05日

修複prestop的問題。

此次升級不會對業務造成影響。

2022年06月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.1

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.1

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.1

2022年06月13日

支援MSE企業版接入，提供MSE流量防護能力。

此次升級不會對業務造成影響。

2022年05月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

3.0.0

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:3.0.0

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:3.0.0

2022年05月13日

支援Service Mesh
支援同步Kubernetes Service到MSE Nacos。

此次升級不會對業務造成影響。

2.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.9

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.9

2022年05月25日

修複下載逾時時間設定。
修複命名空間建立問題。
減少注入的JAVA_TOOL_OPTIONS長度。

此次升級不會對業務造成影響。

2022年04月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

2.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.8

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.8

2022年04月19日

支援AHAS流量防護。
最佳化日誌邏輯，輔助問題排查。

此次升級不會對業務造成影響。

2.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.6

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.6

2022年04月11日

支援按照應用程式名稱灰階Agent。

此次升級不會對業務造成影響。

2022年03月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

2.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.5

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.5

2022年03月17日

支援EDAS單獨版本的Agent。

此次升級不會對業務造成影響。

2022年02月

版本號碼

鏡像地址

變更時間

變更內容

變更影響

2.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.4

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.4

2022年02月28日

支援strict 模式，支援僅Label接入。

此次升級不會對業務造成影響。

2.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot:2.0.3

registry.{REGION}.ack.aliyuncs.com/ack-onepilot/ack-onepilot-init:2.0.3

2022年02月11日

添加readinessProbe就緒探針，防止升級期間Pilot服務中斷。

此次升級不會對業務造成影響。