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.
Usage notes
For more information about how to use Terway, see Work with Terway.
Release notes
October 2023
Version number | Image address | Release date | Description | Impact |
v1.6.0 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.6.0 | 2023-10-10 |
| No impact on workloads |
August 2023
Version number | Image address | Release date | Description | Impact |
v1.5.7 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.7 | 2023-08-24 |
| No impact on workloads |
July 2023
Version number | Image address | Release date | Description | Impact |
v1.5.6 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.6 | 2023-07-30 | No impact on workloads | |
v1.5.5 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.5 | 2023-07-06 | No 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 Terway updates in IPVLAN mode is fixed. | No 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. | No 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. | No impact on workloads |
v1.5.2 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.5.2 | 2023-05-10 |
| No 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. | No 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 |
| No 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. | No 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 |
| No 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 |
| No 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 |
| No 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. | No 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 |
| No 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 |
| No 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. | No impact on workloads |
v1.2.1 | registry.cn-hangzhou.aliyuncs.com/acs/terway:v1.2.1 | 2022-03-15 |
| No 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 |
| No 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 |
| No 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 applies only to the exclusive ENI mode. Other modes do not require this update. | No 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 |
| No 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 |
| No 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 |
| No 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 |
| No 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 |
| No 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 |
| No 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:
| No 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 |
| No 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. | No 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 |
| No 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 |
| No 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. | No 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. | No 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. | No 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. | No 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 |
| No 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. | No 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 |
| No 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. | No 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 |
| No 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. | No 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. | No 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. | No 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. | No 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 |
| No impact on workloads |