Terway Edge is a container network plugin for Container Service for Kubernetes (ACK) Edge clusters. Built on Terway and Flannel (Route mode), it provides underlay network connectivity for containers across both cloud and edge node pools.
How it works
Terway Edge applies different network solutions depending on the node pool type.
Cloud node pool — uses a cloud-native approach. Each pod gets an IP address directly from an elastic network interface (ENI), a virtual NIC provided by Alibaba Cloud within your virtual private cloud (VPC). Pods don't need a CIDR block.
Edge node pool — requires a vSwitch CIDR block for pods. Containers get IP addresses from this CIDR block. Border Gateway Protocol (BGP) can advertise container routes to upstream switches.
Version compatibility
| terway-edge version | Kubernetes version |
|---|---|
| > v1.13 | ≥ 1.32 |
| v1.9 | ≥ 1.30 |
| v1.8 | ≥ 1.28 and < 1.32 |
Limitations
-
The container network plugin must be selected during cluster creation and cannot be changed later.
-
Only ACK Edge clusters running Kubernetes 1.28 or later are supported.
For setup instructions, see Usage guide for Terway Edge.
Release notes
April 2025
| Version | Change | Release date | Impact |
|---|---|---|---|
| v1.9.14 | Disabled source/destination IP check for cloud ENIs by default. | Apr. 1, 2025 | No impact on workloads. |
| v1.8.17 | Disabled source/destination IP check for cloud ENIs by default. | Apr. 1, 2025 | No impact on workloads. |
March 2025
| Version | Change | Release date | Impact |
|---|---|---|---|
| v1.13.6 | Breaking change: terway-edge-manager (the user-side control plane component) is removed. terway-edge-controlplane is now a mandatory system-managed component. |
Mar. 15, 2025 | BGP sessions may restart. Make sure graceful restart is configured on your BGP switches before upgrading. |
February 2025
| Version | Change | Release date | Impact |
|---|---|---|---|
| v1.9.13 | SNAT can now be enabled or disabled for pod egress traffic. BGP failure events are now reported. | Feb. 15, 2025 | BGP sessions may restart. Make sure graceful restart is configured on your BGP switches before upgrading. |
December 2024
| Version | Change | Release date | Impact |
|---|---|---|---|
| v1.8.15 | Pod vSwitch scaling in the Edge Node Service (ENS) network is now supported. Pod IP allocation efficiency in the ENS network is improved. Graceful restart in BGP advertisement is now supported. Rolling update is now supported. Network autonomy is supported when cloud-hub is version 0.12.3 or later. | Dec. 30, 2024 | BGP sessions may restart. Make sure graceful restart is configured on your BGP switches before upgrading. |
November 2024
| Version | Change | Release date | Impact |
|---|---|---|---|
| v1.8.13 | ENS network support is added. BGP advertisement is now supported. | Nov. 15, 2024 | BGP sessions may restart. Make sure graceful restart is configured on your BGP switches before upgrading. |
September 2024
| Version | Change | Release date | Impact |
|---|---|---|---|
| v1.8.6 | Underlay container network communication is now supported. BGP can now advertise container routes. | Sept. 15, 2024 | No impact on workloads. |