ack-onepilot add-on overview, usage, and release notes-Container Service for Kubernetes(ACK)-阿里云帮助中心

ack-onepilot is an ACK add-on that manages ARMS agent injection. Install the add-on for non-intrusive integration of Java, Go, and Python applications with ARMS.

Add-on overview

ack-onepilot is a system add-on that Container Service for Kubernetes (ACK) provides for ARMS and Microservices Engine (MSE) users to simplify integration with both services. The add-on provides the following capabilities:

In container environments, the add-on automatically adds the environment variables that probes require for reporting and prepares the probe packages. This ensures that monitoring data for Java, Go, and Python applications can be collected and reported efficiently and accurately. The monitoring data includes topology data, API calls, abnormal transactions, and slow transactions.
Connects microservice applications deployed in your clusters, such as Spring Cloud and Dubbo applications, to MSE Microservices Governance. MSE service governance capabilities can then improve the stability and development efficiency of your production microservices.

For more information about how ack-onepilot works, see How ack-onepilot works.

Usage

Connect to ARMS by using ack-onepilot:
- To connect Java applications in ACK clusters to Application Monitoring, see Install the ARMS Java agent in ACK and ACS clusters.
- To connect Go applications in ACK clusters to Application Monitoring, see Install the Go agent with ack-onepilot.
- To connect Python applications in ACK clusters to Application Monitoring, see Install the ARMS Python agent in ACK and ACS clusters.
To connect to MSE by using ack-onepilot, see Integrate ACK microservice applications with MSE Microservices Governance.

Release notes

September 2026

Version

Image address

Release date

Changes

Impact

5.3.2

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

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

September 18, 2026

Added CPU and memory settings for Sidecar injection.

This upgrade does not affect your business.

5.3.1

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

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

September 1, 2026

Changed the environment variable injection method and configuration.

This upgrade does not affect your business.

August 2026

Version

Image address

Release date

Changes

Impact

5.3.0

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

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

August 28, 2026

Fixed an issue in which the probe was not mounted when the liveness check timed out in local image mode.
Supports non-intrusive integration of Node.js probes.

This upgrade does not affect your business.

April 2026

Version

Image address

Release date

Changes

Impact

5.2.1

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

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

April 24, 2026

Fixed an issue in which the Pod graceful termination grace period (terminationGracePeriodSeconds) was not automatically extended to 60 seconds by default in MSE graceful shutdown scenarios.
Supports non-intrusive integration with application protection for Python and Node.js applications.

This upgrade does not affect your business.

March 2026

Version

Image address

Release date

Changes

Impact

5.2.0

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

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

March 27, 2026

Supports non-intrusive integration for OpenClaw: Integrate OpenClaw Applications.

This upgrade does not affect your business.

December 2025

Version

Image address

Release date

Changes

Impact

5.1.2

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

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

December 24, 2025

Fixed an issue in which disabling Application Monitoring integration through labels did not take effect in Enterprise Distributed Application Service (EDAS) scenarios.
Supports fully non-intrusive integration for Dify: Integrate Dify applications with ARMS application monitoring.

This upgrade does not affect your business.

September 2025

Version

Image address

Release date

Changes

Impact

5.1.1

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

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

September 11, 2025

Optimized Kubernetes probe parameter settings for Pod startup.
Pinned the cramjam dependency to 2.10.0 for non-intrusive Python integration to prevent integration version conflicts.
Automatically masks the AccessKey ID and AccessKey secret in your Helm configurations to improve security.
Improved the integration experience in Container Compute Service (ACS) scenarios.

This upgrade does not affect your business.

August 2025

Version

Image address

Release date

Changes

Impact

5.1.0

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

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

August 7, 2025

Supports full integration with CloudMonitor 2.0.
Supports Accelerate ack-onepilot integration with local image cache.
Fixed an issue in which the ack-onepilot add-on overwrote the user-defined terminationGracePeriodSeconds field.

For ACS clusters, install the add-on by using Automatically install the agent in a general-purpose Kubernetes environment.
For registered clusters, grant the add-on CloudMonitor (CMS)-related permissions again by using Connect a registered cluster to ARMS.

July 2025

Version

Image address

Release date

Changes

Impact

5.0.0

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

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

July 11, 2025

Supports fully non-intrusive integration of Python probes: Install the ARMS Python agent in ACK and ACS clusters.
Fixed an issue in which the label parameter settings for MSE graceful start and shutdown did not take effect.

This upgrade does not affect your business.

May 2025

Version

Image address

Release date

Changes

Impact

4.2.0

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

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

May 30, 2025

Supports connecting applications in multiple languages in Sidecar scenarios: Monitor multi-container applications in a single pod.

This upgrade does not affect your business.

4.1.2

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

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

May 8, 2025

Supports specifying the network mode of the ack-onepilot add-on: Network mode for the ack-onepilot component.
Supports recognizing Pod labels as application labels: Add and use tags.
Supports manually disabling annotation injection in Service Mesh environments: Install the Java agent for Istio-managed services.

This upgrade does not affect your business.

April 2025

Version

Image address

Release date

Changes

Impact

4.1.1

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

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

April 9, 2025

Supports specifying the probe version for integration at the cluster namespace level.
Applications are no longer created by default in ARMS EDAS scenarios where an APPID must be specified.
Fixed an issue in which MSE application profiling data was not reported.

This upgrade does not affect your business.

March 2025

Version

Image address

Release date

Changes

Impact

4.1.0

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

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

March 13, 2025

Fixed an issue in which injected environment variables were out of order.
Optimized the POP network liveness probe logic.
Fixed an issue in which the disable switch did not take effect during ARMS integration.
Supports a custom JAVA_TOOL_OPTIONS integration mode: Customize the mount path for a Java agent
Fixed resource discovery failures in the microservice governance control panel.
Supports log reporting from external nodes.

This upgrade does not affect your business.

February 2025

Version

Image address

Release date

Changes

Impact

4.0.1

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

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

February 27, 2025

Fixed an issue in which applications in MSE Microservices Governance Professional Edition namespaces were integrated as Enterprise Edition applications.

This upgrade does not affect your business.

January 2025

Version

Image address

Release date

Changes

Impact

4.0.0

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

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

January 9, 2025

Optimized ack-onepilot performance.
ARMS no longer supports integration through annotations. To integrate by adding labels, see Install the ARMS Java agent in ACK and ACS clusters.

This upgrade does not affect your business.

December 2024

Version

Image address

Release date

Changes

Impact

3.3.4

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

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

December 26, 2024

Fixed an issue in which your business applications failed to start when an earlier version of arms-pilot was present.
Fixed an issue in which a failure to modify probe package permissions in rare cases caused startup failures.
Removed invalid logic from Python probe integration to speed up the integration.
Optimized logs related to timeouts.

This upgrade does not affect your business.

November 2024

Version

Image address

Release date

Changes

Impact

3.3.3

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

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

November 21, 2024

Adapted probe integration for Istio DNS proxy scenarios.
Adjusted the health check interval of ack-onepilot to speed up its startup.

This upgrade does not affect your business.

3.3.2

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

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

November 7, 2024

Optimized MSE-related log and event notification logic when MSE is not integrated.

This upgrade does not affect your business.

October 2024

Version

Image address

Release date

Changes

Impact

3.3.1

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

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

October 29, 2024

Supports skipping Sidecar injection for graceful shutdown.
Added fields for log reporting.

This upgrade does not affect your business.

3.3.0

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

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

October 11, 2024

Supports progressive probe upgrades.
Fixed integration failures in some scenarios where the network was unreachable.
Fixed Helm parsing failures in some scenarios.

This upgrade does not affect your business.

September 2024

Version

Image address

Release date

Changes

Impact

3.2.5

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

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

September 10, 2024

Fixed an intermittent restart issue in MSE scenarios.

This upgrade does not affect your business.

3.2.4

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

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

September 3, 2024

Supports integrating Python applications.
Fixed some bugs in MSE graceful start and shutdown.

This upgrade does not affect your business.

July 2024

Version

Image address

Release date

Changes

Impact

3.2.3

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

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

July 30, 2024

MSE supports server-side governance features for Go applications.

This upgrade does not affect your business.

3.2.2

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

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

July 5, 2024

Fixed application startup failures caused by invalid ARMS parameters.

This upgrade does not affect your business.

June 2024

Version	Image address	Release date	Changes	Impact
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	June 19, 2024	Supports integrating Go applications. Java applications support automatic injection of crash log collection parameters.	This upgrade does not affect your business.
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	June 19, 2024	Fixed integration failures caused by symbolic link processing issues in some scenarios with poor network connectivity.	This upgrade does not affect your business.
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	June 13, 2024	Fixed an issue in which the agent package download was incomplete when the network was unstable. Fixed an issue in which the init-container was injected twice when pilotx was used.	This upgrade does not affect your business.

May 2024

Version

Image address

Release date

Changes

Impact

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

May 30, 2024

Supports downloading agent packages as JAR files.
Changed the probe package name to aliyun-java-agent.jar and the full probe path to /home/admin/.opt/AliyunJavaAgent/aliyun-java-agent.jar.
Increased the default memory usage of the init-container from 100 MB to 250 MB.

ack-onepilot 3.1.0 no longer supports integrating probes earlier than version 2.7.3.5. If you use an earlier probe version, upgrade the probe or do not upgrade to this ack-onepilot version.

April 2024

Version

Image address

Release date

Changes

Impact

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

April 17, 2024

Fixed an issue in which ack-onepilot failed to start in open-source Kubernetes clusters that cannot access the Internet.

This upgrade does not affect your business.

March 2024

Version

Image address

Release date

Changes

Impact

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

March 23, 2024

Fixed intermittent failures when redirecting to the ARMS console during new application integration.
Fixed StatefulSet application integration failures.
Fixed an issue in which service mesh application integration did not take effect.

This upgrade does not affect your business.

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

March 13, 2024

Updated the Kubernetes SDK version to support gRPC health checks.
Automatically adapts to service mesh network environments.
Fixed an issue in which the arms.workload environment variable was occasionally injected as empty.

This upgrade does not affect your business.

December 2023

Version

Image address

Release date

Changes

Impact

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

December 26, 2023

Supports downloading new probe versions.
Fixed internal network connection timeouts.
Added support for creating Kubernetes events during version updates.

This upgrade does not affect your business.

November 2023

Version

Image address

Release date

Changes

Impact

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

November 28, 2023

Supports downloading agent packages as TAR files.

This upgrade does not affect your business.

October 2023

Version

Image address

Release date

Changes

Impact

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

October 18, 2023

Added resource configuration for ack-onepilot.

This upgrade does not affect your business.

September 2023

Version

Image address

Release date

Changes

Impact

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

September 5, 2023

Added support for graceful upgrades.
ARMS users can integrate applications by configuring an AccessKey ID and AccessKey secret across accounts.
MSE removed the dependency on AliyunMSEForECIRole.
Fixed duplicate Pod environment variables.

This upgrade does not affect your business.

August 2023

Version

Image address

Release date

Changes

Impact

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

August 18, 2023

Added support for the Arm64 architecture.
Optimized metrics and the mount success rate of monitoring agents.
Fixed a timeout that occurred when synchronously creating a Client during the Webhook phase.

This upgrade does not affect your business.

June 2023

Version

Image address

Release date

Changes

Impact

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

June 20, 2023

Optimized the performance of the ack-onepilot add-on.

This upgrade does not affect your business.

April 2023

Version

Image address

Release date

Changes

Impact

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

April 20, 2023

Fixed a permission issue.
Supports setting the CPU and MEM (memory) sizes through environment variables.

This upgrade does not affect your business.

March 2023

Version

Image address

Release date

Changes

Impact

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

March 24, 2023

Fixed environment variable issues.
Fixed Ingress support issues.
Improved internationalization documentation support.
Added support for Helm 2.

This upgrade does not affect your business.

February 2023

Version

Image address

Release date

Changes

Impact

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

February 20, 2023

Supports using Kubernetes namespace labels to control which microservice namespaces are integrated.
Fixed ARMS integration issues.

This upgrade does not affect your business.

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

February 8, 2023

Reduced the number of Pods required for deployment.
Fixed Service Mesh integration issues.

This upgrade does not affect your business.

January 2023

Version

Image address

Release date

Changes

Impact

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

January 16, 2023

MSE Microservices Governance integration supports different namespaces. The mseNamespace of a Pod can control the name of the integrated microservice namespace.

This upgrade does not affect your business.

November 2022

Version

Image address

Release date

Changes

Impact

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

November 17, 2022

Removed the deprecated mseruletrait component.

This upgrade does not affect your business.

October 2022

Version

Image address

Release date

Changes

Impact

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

October 21, 2022

Supports canary releases for Alibaba Cloud Ingress.

This upgrade does not affect your business.

August 2022

Version

Image address

Release date

Changes

Impact

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

August 17, 2022

Tag Center supports adding labels in ACK environments and synchronizing some labels.

This upgrade does not affect your business.

July 2022

Version

Image address

Release date

Changes

Impact

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

July 19, 2022

Supports configuring graceful start through Pod labels.

This upgrade does not affect your business.

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

July 5, 2022

Fixed preStop issues.

This upgrade does not affect your business.

June 2022

Version

Image address

Release date

Changes

Impact

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

June 13, 2022

Supports MSE Enterprise Edition integration and provides MSE traffic protection.

This upgrade does not affect your business.

May 2022

Version

Image address

Release date

Changes

Impact

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

May 13, 2022

Supports Service Mesh.
Supports synchronizing Kubernetes Services to MSE Nacos.

This upgrade does not affect your business.

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

May 25, 2022

Fixed download timeout settings.
Fixed namespace creation issues.
Reduced the length of the injected JAVA_TOOL_OPTIONS.

This upgrade does not affect your business.

April 2022

Version

Image address

Release date

Changes

Impact

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

April 19, 2022

Supports Application High Availability Service (AHAS) traffic protection.
Optimized logging logic to help troubleshoot issues.

This upgrade does not affect your business.

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

April 11, 2022

Supports canary releases of agents by application name.

This upgrade does not affect your business.

March 2022

Version

Image address

Release date

Changes

Impact

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

March 17, 2022

Supports a dedicated agent version for EDAS.

This upgrade does not affect your business.

February 2022

Version

Image address

Release date

Changes

Impact

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

February 28, 2022

Supports strict mode and label-only integration.

This upgrade does not affect your business.

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

February 11, 2022

Added a readiness probe (readinessProbe) to prevent Pilot service interruptions during upgrades.

This upgrade does not affect your business.