# Multi-AZ Control Plane

## Tổng quan

**Multi-AZ Control Plane** là tính năng cho phép triển khai Kubernetes Cluster với Control Plane được phân bổ trên nhiều Availability Zones (AZ) khác nhau, đảm bảo **High Availability** (HA) cho cluster của bạn.

### Multi-AZ Control Plane là gì?

Trong mô hình Multi-AZ, các thành phần của Control Plane (API Server, Controller Manager, Scheduler, etcd) được triển khai trên nhiều AZ. Điều này đảm bảo rằng:

* Nếu một AZ gặp sự cố, Control Plane vẫn hoạt động bình thường từ các AZ còn lại
* Tự động failover mà không cần can thiệp thủ công
* Đáp ứng yêu cầu compliance về disaster recovery

Để khởi tạo một Multi-AZ Cluster, vui lòng tham khảo hướng dẫn tại [đây](https://docs.vngcloud.vn/vng-cloud-document/vn/vks/getting-started/khoi-tao-mot-multi-az-cluster).

### So sánh Single-AZ và Multi-AZ Cluster

| Đặc điểm                       | Single-AZ                            | Multi-AZ                                                                              |
| ------------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------- |
| **Control Plane Availability** | Tiêu chuẩn                           | Cao hơn                                                                               |
| **Khả năng chịu lỗi**          | Single point of failure tại AZ level | Chịu được lỗi ở cấp độ AZ                                                             |
| **Chi phí**                    | Thấp hơn                             | Miễn phí trong giai đoạn đầu release (có phát sinh chi phí Private Service Endpoints) |
| **Độ trễ (Latency)**           | Thấp (cùng AZ)                       | Cao hơn một chút (cross-AZ cho Control Plane)                                         |
| **Private DNS (VPC)**          | Tùy chọn                             | Bắt buộc (prerequisite)                                                               |
| **Use Case**                   | Development, Testing                 | Production, Mission-critical                                                          |
| **Yêu cầu Subnet**             | 1 subnet                             | Tối thiểu 2 subnets từ 2 AZ khác nhau                                                 |
| **Node Group**                 | 1 AZ (1 subnet)                      | 1 AZ per Node Group (chọn 1 subnet từ danh sách subnets của cluster)                  |

### Khi nào nên sử dụng Multi-AZ Cluster?

* **Production workloads**: Các ứng dụng yêu cầu uptime cao và không chấp nhận downtime
* **Mission-critical applications**: Hệ thống thanh toán, giao dịch, dữ liệu quan trọng
* **Enterprise requirements**: Tuân thủ các yêu cầu compliance về disaster recovery
* **High Availability**: Khi cần đảm bảo cluster vẫn hoạt động ngay cả khi một AZ gặp sự cố

{% hint style="info" %}
**Lưu ý:**

* **Single-AZ Cluster** phù hợp cho môi trường **development** và **testing** do chi phí thấp hơn
* **Multi-AZ Cluster** được khuyến nghị cho môi trường **production**
  {% endhint %}

***

## Kiến trúc Multi-AZ Control Plane

Sơ đồ dưới đây minh họa kiến trúc của Multi-AZ Cluster:

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2F5JHfF94ARFFWwIRrEyAu%2FVKS_HA%26Multi%20AZ.png?alt=media&#x26;token=b87c701f-b1c2-455b-b4c5-ff65b1b3b279" alt=""><figcaption></figcaption></figure>

**Các thành phần chính:**

* **Control Plane**: Được phân bổ trên nhiều AZ, bao gồm API Server, Controller Manager, Scheduler, etcd
* **etcd cluster**: Được replicate across AZs để đảm bảo data consistency
* **vLB Multi-AZ**: Load Balancer phân phối traffic đến Control Plane nodes trên các AZ

***

## Quản lý Multi-AZ Cluster

### Xem thông tin Cluster trên trang danh sách

Tại trang danh sách Kubernetes Cluster, bạn có thể nhận biết Multi-AZ Cluster thông qua cột **Control Plane Availability**:

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2FKupq6ObeA6giQMeMg4Zx%2Fvks-multi-az-cluster-list-page.png?alt=media&#x26;token=58a6dd5e-266a-4eca-9123-867473908bb2" alt=""><figcaption></figcaption></figure>

| Badge                             | Ý nghĩa                             |
| --------------------------------- | ----------------------------------- |
| **Single-AZ** (badge màu xám)     | Control Plane nằm trong 1 AZ        |
| **Multi-AZ** (badge màu xanh đậm) | Control Plane phân bổ trên nhiều AZ |

### Xem chi tiết Cluster

Khi truy cập vào trang chi tiết của Multi-AZ Cluster:

**1. General Information**

Hiển thị thêm trường **Control Plane Availability** với giá trị **Multi-AZ** (badge màu xanh đậm)

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fr5aXRR8AIn1GaxsFHIwK%2Fvks-multi-az-cluster-detail-general-info.png?alt=media&#x26;token=164554f5-220d-4b9c-ade4-1f2ab752657d" alt=""><figcaption></figcaption></figure>

**2. Network Section**

Hiển thị danh sách **Subnets** đang sử dụng với thông tin chi tiết:

```
Subnets (2)
├── sub-85ba01f6-02ec-4dfc-8884-ee0036c68a5b
│   Name: sub-1A (10.60.0.0/24) | AZ: HCM-1A
└── sub-12345678-abcd-efgh-ijkl-mnopqrstuvwx
    Name: sub-1B (10.60.1.0/24) | AZ: HCM-1B
```

* Click vào icon **copy** bên cạnh Subnet ID để copy vào clipboard

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgi426ttp9yHD2njcMUhb%2Fvks-multi-az-cluster-detail-network.png?alt=media&#x26;token=85b30fc2-b795-42a2-a13c-12e3f933a018" alt=""><figcaption></figcaption></figure>

**3. Node Group Tab**

Thông tin chi tiết Node Group hiển thị **Subnet** kèm theo **AZ** tương ứng, giúp bạn xác định Node Group đang triển khai ở AZ nào.

### Upgrade Control Plane

Quy trình upgrade Control Plane cho Multi-AZ Cluster **không khác biệt** so với Single-AZ Cluster:

1. Truy cập vào trang chi tiết cluster
2. Thực hiện upgrade Control Plane lên version mới theo hướng dẫn tại [đây](https://docs.vngcloud.vn/vng-cloud-document/vn/vks/clusters/upgrading-control-plane-version)

{% hint style="info" %}
**Đặc điểm upgrade Multi-AZ Cluster:**

* Hệ thống thực hiện **rolling upgrade** trên tất cả các AZ
* Cluster vẫn **available** trong quá trình upgrade
* Các workload hiện có **không bị gián đoạn**
*

{% endhint %}

### Xóa Cluster

Quy trình xóa Multi-AZ Cluster **tương tự** như Single-AZ Cluster:

1. Truy cập vào <https://vks.console.vngcloud.vn/k8s-cluster>
2. Chọn cluster muốn xóa và chọn **Delete**
3. Xác nhận xóa

{% hint style="warning" %}
**Lưu ý khi xóa Multi-AZ Cluster:**

Khi xóa cluster, hệ thống sẽ:

* Xóa tất cả **Control Plane components** trên **mọi AZ**
* Xóa tất cả **Node Groups** và **Worker Nodes**
* Giải phóng **network resources** (subnets vẫn còn trong VPC)
* Xóa **Security Group** mặc định của cluster
* Xóa **Load Balancer** mặc định của cluster

Các tài nguyên sau **có thể không bị xóa tự động**:

* Load Balancer được integrate vào cluster bởi bạn
* Persistent Volume được integrate vào cluster bởi bạn
  {% endhint %}

***

## Giới hạn và Lưu ý

### Giới hạn hiện tại

| Giới hạn                       | Mô tả                                                                                   |
| ------------------------------ | --------------------------------------------------------------------------------------- |
| **Không thể chuyển đổi**       | Không thể chuyển đổi cluster từ Single-AZ sang Multi-AZ (hoặc ngược lại) sau khi đã tạo |
| **Không thể thay đổi subnets** | Không thể thêm/bớt subnet sau khi đã tạo Multi-AZ cluster                               |
| **Node Group vẫn Single-AZ**   | Mỗi Node Group chỉ hỗ trợ triển khai trong 1 subnet (1 AZ)                              |
| **VPC DNS bắt buộc**           | VPC phải bật DNS để tạo Multi-AZ Cluster                                                |

### Lưu ý quan trọng

{% hint style="success" %}
**Về chi phí:**

Trong giai đoạn đầu release, tính năng Multi-AZ Control Plane được cung cấp **miễn phí**. Chi phí chính thức sẽ được cập nhật trong thời gian tới. Vui lòng theo dõi trang [Thông báo và Cập nhật](https://docs.vngcloud.vn/vng-cloud-document/vn/vks/announcements) để nắm thông tin mới nhất.

Lưu ý: Multi-AZ Cluster hoạt động trên luồng private nên sẽ phát sinh chi phí cho **4 Private Service Endpoints** (IAM, vCR, vServer, vStorage).
{% endhint %}

{% hint style="warning" %}
**Về Private Service Endpoint:**

Multi-AZ Cluster sử dụng **Private Service Endpoint (PSE) thế hệ mới**, hoạt động ở **cấp độ VPC** — khác biệt so với PSE của Private Cluster trước đây. Mức độ ảnh hưởng của PSE trong Multi-AZ **cao hơn đáng kể**:

* **Cluster và Node Group không có outbound internet access**: Các nodes trong cluster không thể kết nối ra internet. Mọi kết nối tới các dịch vụ GreenNode đều đi qua PSE.
* **Pull image từ vCR**: Các nodes cần pull container image từ **vContainer Registry (vCR)** thông qua PSE. Không thể pull image từ các registry bên ngoài (Docker Hub, ghcr.io, quay.io...).
* **Operators và dịch vụ nội bộ**: Các operators trên cluster cần truy cập các dịch vụ như **vServer**, **IAM**, **vStorage** thông qua PSE để hoạt động.
* **Ảnh hưởng toàn bộ VPC**: PSE hoạt động ở cấp độ VPC, do đó **tất cả resources trong VPC** (kể cả các resources không thuộc cluster) khi gọi đến các dịch vụ vCR, IAM, vServer, vStorage **đều đi qua PSE**. Đây là điểm khác biệt quan trọng so với Private Cluster trước đây.
* **Không xóa PSE**: Việc xóa PSE sẽ ảnh hưởng không chỉ cluster mà còn toàn bộ các resources khác trong VPC đang sử dụng các dịch vụ này.
* Để truy cập **kube-api**, bạn cần **đứng trong VPC** mà cluster sử dụng.
* Chi tiết tham khảo tại [Khởi tạo một Multi-AZ Cluster](https://docs.vngcloud.vn/vng-cloud-document/vn/vks/getting-started/khoi-tao-mot-multi-az-cluster)
  {% endhint %}

{% hint style="info" %}
**Về Node Group:**

* Khi tạo cluster, Node Group đầu tiên chỉ có thể chọn 1 subnet từ danh sách subnets đã cấu hình cho cluster
* Để đảm bảo HA cho workloads, bạn nên tạo thêm Node Group ở các AZ khác sau khi cluster được tạo
  {% endhint %}

{% hint style="info" %}
**Về cross-AZ latency:**

Traffic giữa các AZ có thể có độ trễ cao hơn một chút so với traffic trong cùng AZ. Điều này là bình thường và được chấp nhận để đổi lấy khả năng High Availability.
{% endhint %}

***

## FAQ

### 1. Tôi có thể chuyển cluster từ Single-AZ sang Multi-AZ không?

**Không.** Hiện tại VKS không hỗ trợ chuyển đổi Control Plane Availability sau khi cluster đã được tạo. Bạn cần tạo mới cluster với cấu hình Multi-AZ.

### 2. Node Group của tôi có tự động phân bổ trên nhiều AZ không?

**Không.** Mỗi Node Group chỉ triển khai trong 1 AZ (1 subnet). Để phân bổ workloads trên nhiều AZ, bạn cần tạo nhiều Node Group ở các AZ khác nhau.

### 3. Điều gì xảy ra khi một AZ gặp sự cố?

Khi 1 AZ gặp sự cố:

* **Control Plane** vẫn hoạt động bình thường từ các AZ còn lại
* **Node Groups** ở AZ đó sẽ không available
* Kubernetes sẽ tự động reschedule các pods sang các nodes ở AZ khác (nếu có Node Group ở các AZ khác)

### 4. Tại sao VPC của tôi không hiển thị khi tạo Multi-AZ Cluster?

VPC của bạn chưa bật **DNS**. Vui lòng bật DNS cho VPC tại portal vServer trước khi tạo Multi-AZ Cluster.

### 5. Tôi có thể chọn nhiều subnet cùng AZ cho Multi-AZ Cluster không?

Bạn có thể chọn nhiều subnet, nhưng phải đảm bảo các subnet thuộc **ít nhất 2 AZ khác nhau**. Nếu tất cả subnet đều thuộc cùng 1 AZ, hệ thống sẽ báo lỗi validation.

### 6. Chi phí Multi-AZ Cluster như thế nào?

Trong giai đoạn đầu release, tính năng Multi-AZ Control Plane được cung cấp **miễn phí**. Chi phí chính thức sẽ được cập nhật trong thời gian tới. Lưu ý rằng Multi-AZ Cluster hoạt động trên luồng private nên sẽ phát sinh chi phí cho 4 Private Service Endpoints. Vui lòng tham khảo trang [Cách tính giá](https://docs.vngcloud.vn/vng-cloud-document/vn/vks/cach-tinh-gia) và [Thông báo và Cập nhật](https://docs.vngcloud.vn/vng-cloud-document/vn/vks/announcements) để biết chi tiết.