Terway is an open source Container Network Interface (CNI) plug-in that is developed by Alibaba Cloud. Terway works with Virtual Private Cloud (VPC) and allows you to use standard Kubernetes network policies to control how containers communicate with each other. You can use Terway to set up network connectivity within a Kubernetes cluster. The topic introduces Terway and describes the usage notes and release notes for Terway.
Introduction
Terway is a CNI plug-in developed by Container Service for Kubernetes (ACK). The plug-in builds networks based on elastic network interfaces (ENIs) of Alibaba Cloud to make full use of cloud resources. Terway supports the use of extended Berkeley Packet Filter (eBPF) to accelerate network traffic and reduce latency. Terway supports standard Kubernetes network policies that define how containers communicate with each other.
In a cluster that has Terway installed, each pod has a separate network stack and is assigned a separate IP address. Pods on the same Elastic Compute Service (ECS) instance communicate with each other by forwarding packets inside the ECS instance. Pods on different ECS instances communicate with each other through ENIs in the VPC in which the ECS instances are deployed. This improves communication efficiency because no tunneling technologies, such as Virtual Extensible Local Area Network (VXLAN), are required to encapsulate packets.
Supported Kubernetes versions
Terway versions | Kuebrnetes versions |
v1.11 and v1.10 | ≥ Kubernetes 1.31 |
v1.9 | ≥ Kubernetes 1.30 |
v1.8 | ≥ Kubernetes 1.24 |
Usage notes
For more information about how to use Terway, see Work with Terway.
Release notes
October 2024
Version | Image address | Release date | Description | Impact |
v1.11.3 | registry-cn-hangzhou.ack.aliyuncs.com/acs/terway:v1.11.3 | 2024-10-28 | Note This version is in canary release. The issue that deleting the CNI may affect existing pods is fixed. | This update has no negative impact on workloads. |
v1.9.8 | registry-cn-hangzhou.ack.aliyuncs.com/acs/terway:v1.9.8 | 2024-10-17 | The issue that NetworkPolicy cannot handle external IP is fixed. | This update has no negative impact on workloads. |
v1.11.2 | registry-cn-hangzhou.ack.aliyuncs.com/acs/terway:v1.11.2 | 2024-10-15 | The issue that NetworkPolicy cannot handle external IP is fixed. | This update has no negative impact on workloads. |
September 2024
Version | Image address | Release date | Description | Impact |
v1.11.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.11.1 | 2024-09-23 | The issue that | This update has no negative impact on workloads. |
v1.11.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.11.0 | 2024-09-13 |
| This update has no negative impact on workloads. |
v1.9.7 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.9.7 | 2024-09-13 |
| This update has no negative impact on workloads. |
v1.8.13 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.13 | 2024-09-13 |
| This update has no negative impact on workloads. |
August 2024
Version | Image address | Release date | Description | Impact |
v1.10.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.10.0 | 2024-08-29 | Terway 1.10.0 and later versions support only Kubernetes 1.31 and later versions. |
|
v1.8.12 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.12 | 2024-08-29 |
| This update has no negative impact on workloads. |
v1.8.11 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.11 | 2024-08-12 | The issue that you cannot create an ENI if the vSwitch does not have sufficient EIPs is fixed. | This update has no negative impact on workloads. |
July 2024
Version | Image address | Release date | Description | Impact |
v1.9.6 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.9.6 | 2024-07-25 |
| If your cluster is large, the loads of kube-apiserver may increase within a short period of time during the update. We recommend that you pay attention to the load on kube-apiserver. |
June 2024
Version | Image address | Release date | Description | Impact |
v1.9.4 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.9.4 | 2024-06-27 | ACK NetworkPolicy is supported. | This update has no negative impact on workloads. |
v1.8.9 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.9 | 2024-06-06 | The issue that duplicate IP addresses are allocated is fixed. | This update has no negative impact on workloads. |
May 2024
Version | Image address | Release date | Description | Impact |
v1.9.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.9.3 | 2024-05-29 | The way how CNI handles the | This update has no negative impact on workloads. |
v1.9.2 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.9.2 | 2024-05-16 |
|
|
v1.8.8 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.8 | 2024-05-16 |
| This update has no negative impact on workloads. |
v1.8.6 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.6 | 2024-05-07 |
| This update has no negative impact on workloads. |
April 2024
Version | Image address | Release date | Description | Impact |
v1.8.4 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.4 | 2024-04-22 |
| This update has no negative impact on workloads. |
v1.8.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.3 | 2024-04-10 |
| This update has no negative impact on workloads. |
March 2024
Version | Image address | Release date | Description | Impact |
v1.8.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.8.0 | 2024-03-18 |
| If you select DataPathV2 or IPvlan when you create a cluster, DataPathV2 is enabled. |
v1.7.4 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.7.4 | 2024-03-18 | The issue that tokens may not be updated is fixed. | This update has no negative impact on workloads. |
v1.7.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.7.3 | 2024-03-11 |
| This update has no negative impact on workloads. |
February 2024
Version | Image address | Release date | Description | Impact |
v1.7.2 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.7.2 | 2024-02-28 |
| This update has no negative impact on workloads. |
v1.7.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.7.0 | 2024-02-18 |
| EIPs are no longer supported by Terway. For more information, see Migrate EIPs from Terway to ack-extend-network-controller. If your cluster is large, the loads of kube-apiserver may increase within a short period of time during the update. We recommend that you pay attention to the load on kube-apiserver. A RAM role that is associated with the node is used for API authentication in a dedicated ACK cluster. Clusters that are created before March 1, 2020 may not have the |
January 2024
Version | Image address | Release date | Description | Impact |
v1.6.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.6.3 | 2024-01-24 |
| This update has no negative impact on workloads. |
November 2023
Version | Image address | Release date | Description | Impact |
v1.6.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.6.1 | 2023-11-21 |
| This update has no negative impact on workloads. |
v1.4.9 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.9 | 2023-11-21 | The issue that duplicate IP addresses are allocated is fixed. | This update has no negative impact on workloads. |
October 2023
Version | Image address | Release date | Description | Impact |
v1.6.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.6.0 | 2023-10-10 |
| This update has no negative impact on workloads. |
August 2023
Version | Image address | Release date | Description | Impact |
v1.5.7 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.7 | 2023-08-24 |
| This update has no negative impact on workloads. |
July 2023
Version | Image address | Release date | Description | Impact |
v1.5.6 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.6 | 2023-07-30 | This update has no negative impact on workloads. | |
v1.5.5 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.5 | 2023-07-06 | This update has no negative impact on workloads. |
June 2023
Version | Image address | Release date | Description | Impact |
v1.5.4 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.4 | 2023-06-01 | The issue that network jitters may occur during updates when Terway runs in IPVLAN mode is fixed. | This update has no negative impact on workloads. |
v1.4.8 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.8 | 2023-06-01 | The issue that network jitters may occur during updates when Terway runs in IPVLAN mode is fixed. | This update has no negative impact on workloads. |
May 2023
Version | Image address | Release date | Description | Impact |
v1.5.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.3 | 2023-05-16 | The issue that you may fail to access an external IP address when Terway 1.4.4 is used is fixed. | This update has no negative impact on workloads. |
v1.5.2 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.2 | 2023-05-10 |
| This update has no negative impact on workloads. |
v1.4.6 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.6 | 2023-05-10 | The issue that nodes may enter the NotReady state when the Terway update fails is fixed. | This update has no negative impact on workloads. |
April 2023
Version | Image address | Release date | Description | Impact |
v1.5.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.1 | 2023-04-28 |
| This update has no negative impact on workloads. |
March 2023
Version | Image address | Release date | Description | Impact |
v1.4.5 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.5 | 2023-03-31 | Role-based access control (RBAC) permissions of Terway are reduced. | This update has no negative impact on workloads. |
v1.4.4 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.4 | 2023-03-14 |
| In IPVLAN mode, if |
December 2022
Version | Image address | Release date | Description | Impact |
v1.4.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.3 | 2022-12-23 |
| This update has no negative impact on workloads. |
November 2022
Version | Image address | Release date | Description | Impact |
v1.4.2 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.2 | 2022-11-21 |
| This update has no negative impact on workloads. |
September 2022
Version | Image address | Release date | Description | Impact |
v1.4.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.1 | 2022-09-28 |
| This update has no negative impact on workloads. |
August 2022
Version | Image address | Release date | Description | Impact |
v1.4.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.4.0 | 2022-08-29 |
| After you enable the IPVLAN mode for a cluster, CustomResourceDefinitions (CRDs) that are created for Cilium are automatically updated when you update the cluster. This may rapidly increase the load on kube-apiserver if the cluster size is large. In this case, we recommend that you pay attention to the load on kube-apiserver. This update has no negative impact on workloads. |
July 2022
Version | Image address | Release date | Description | Impact |
v1.3.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.3.0 | 2022-07-22 | Quality of service (QoS) management is supported for pods. For more information, see Configure QoS for pods. | This update has no negative impact on workloads. |
June 2022
Version | Image address | Release date | Description | Impact |
v1.2.4 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.2.4 | 2022-06-28 |
| This update has no negative impact on workloads. |
May 2022
Version | Image address | Release date | Description | Impact |
v1.2.3 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.2.3 | 2022-05-26 |
| This update has no negative impact on workloads. |
March 2022
Version | Image address | Release date | Description | Impact |
v1.2.2 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.2.2 | 2022-03-31 | The ARP probe issue in VLAN mode is fixed. | This update has no negative impact on workloads. |
v1.2.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.2.1 | 2022-03-15 |
| This update has no negative impact on workloads. |
January 2022
Version | Image address | Release date | Description | Impact |
v1.2.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.2.0 | 2022-01-11 |
| This update has no negative impact on workloads. |
December 2021
Version | Image address | Release date | Description | Impact |
v1.1.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.1.1 | 2021-12-20 |
| This update has no negative impact on workloads. |
November 2021
Version | Image address | Release date | Description | Impact |
v1.1.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.1.0 | 2021-11-22 |
|
|
September 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.443-gaa1bfcc-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.443-gaa1bfcc-aliyun | 2021-09-14 | Network latency is reduced. This update is applicable only to the exclusive ENI mode of Terway. You do not need to update the plug-in if you use other modes. | This update has no negative impact on workloads. |
August 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.398-g63d2e57-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.398-g63d2e57-aliyun | 2021-08-04 |
| After you enable the IPVLAN mode for a cluster, CRDs that are created for Cilium are automatically updated when you update the cluster. This may rapidly increase the load on kube-apiserver if the cluster size is large. In this case, we recommend that you pay attention to the load on kube-apiserver. This update has no negative impact on workloads. |
July 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.390-g5f3c461-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.390-g5f3c461-aliyun | 2021-07-02 |
| This update has no negative impact on workloads. |
May 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.368-g2890967-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.368-g2890967-aliyun | 2021-05-24 |
| This update has no negative impact on workloads. |
April 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.333-gfd2b7b8-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.333-gfd2b7b8-aliyun | 2021-04-26 |
| This update has no negative impact on workloads. |
March 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.323-g778c128-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.323-g778c128-aliyun | 2021-03-22 |
| This update has no negative impact on workloads. |
February 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.317-g0652857-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.317-g0652857-aliyun | 2021-02-22 |
| This update has no negative impact on workloads. |
v1.0.10.309-g5314eee-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.309-g5314eee-aliyun | 2021-02-05 |
| This update has no negative impact on workloads. |
January 2021
Version | Image address | Release date | Description | Impact |
v1.0.10.301-g0115576-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.301-g0115576-aliyun | 2021-01-21 | New features:
Fixed issues:
| This update has no negative impact on workloads. |
December 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.280-gdc2cb6c-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.280-gdc2cb6c-aliyun | 2020-12-25 |
| This update has no negative impact on workloads. |
v1.0.10.263-gdbe50a9-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.263-gdbe50a9-aliyun | 2020-12-03 | The Terway error that occurs in exclusive ENI mode is fixed. | This update has no negative impact on workloads. |
November 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.261-g8342155-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.261-g8342155-aliyun | 2020-11-27 |
| This update has no negative impact on workloads. |
v1.0.10.250-gb7bb10a-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.250-gb7bb10a-aliyun | 2020-11-23 |
| This update has no negative impact on workloads. |
October 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.247-g4cb77d0-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.247-g4cb77d0-aliyun | 2020-10-26 | ECS instances that are deployed on dedicated hosts are supported. | This update has no negative impact on workloads. |
September 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.237-g6a0f948-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.237-g6a0f948-aliyun | 2020-09-16 | The time required to bind ENIs to pods is reduced. | This update has no negative impact on workloads. |
August 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.221-g8d6386a-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.221-g8d6386a-aliyun | 2020-08-11 | IPvlan and the eBPF are supported for network virtualization. | This update has no negative impact on workloads. |
v1.0.10.213-g27145cc-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.213-g27145cc-aliyun | 2020-08-04 | The pod network issue that occurs due to occasional ENI failures is fixed. | This update has no negative impact on workloads. |
July 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.208-gf3144bf-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.208-gf3144bf-aliyun | 2020-07-20 |
| This update has no negative impact on workloads. |
v1.0.10.211-gef088a4-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.211-gef088a4-aliyun | 2020-07-24 | Cluster ID tags can be added to ENIs. | This update has no negative impact on workloads. |
April 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.156-g8660a0f-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.156-g8660a0f-aliyun | 2020-04-22 |
| This update has no negative impact on workloads. |
February 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.139-g14a4f84-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.139-g14a4f84-aliyun | 2020-02-12 | The issue that pod creation requests occasionally time out is fixed. | This update has no negative impact on workloads. |
January 2020
Version | Image address | Release date | Description | Impact |
v1.0.10.133-g001396b-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.133-g001396b-aliyun | 2020-01-10 |
| This update has no negative impact on workloads. |
December 2019
Version | Image address | Release date | Description | Impact |
v1.0.10.122-gd0be015-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.122-gd0be015-aliyun | 2019-12-24 | The efficiency of IP address allocation is optimized in inclusive ENI mode. | This update has no negative impact on workloads. |
October 2019
Version | Image address | Release date | Description | Impact |
v1.0.10.100-g92a3fa5-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.10.100-g92a3fa5-aliyun | 2019-10-11 | The issue that the host node enters the NotReady state when a large number of jobs concurrently request resources is fixed. | This update has no negative impact on workloads. |
August 2019
Version | Image address | Release date | Description | Impact |
v1.0.9.20-g35ae000-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.9.20-g35ae000-aliyun | 2019-08-23 | Kubernetes 1.14.6 is supported. | This update has no negative impact on workloads. |
April 2019
Version | Image address | Release date | Description | Impact |
v1.0.9.15-g3957085-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.9.15-g3957085-aliyun | 2019-04-11 | The issue that the Terway update occasionally fails is fixed. | This update has no negative impact on workloads. |
March 2019
Version | Image address | Release date | Description | Impact |
v1.0.9.14-ga0346bb-aliyun | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.0.9.14-ga0346bb-aliyun | 2019-03-28 |
| This update has no negative impact on workloads. |