Chuyển tới nội dung chính

Nâng cấp cluster Kubernetes

POST/v1/clusters/{cluster_ident}/actions/upgrade

Nâng cấp cluster lên phiên bản Kubernetes được định nghĩa trong một cluster template khác. Template chứa image, phiên bản và cấu hình node đích, nên hãy chuẩn bị template trước rồi truyền UUID của nó.

info

Request​

Tham số​

cluster_identstringbắt buộcpath

UUID hoặc tên của cluster.

cluster_templatestringbắt buộcbody

UUID của cluster template định nghĩa phiên bản đích.

max_batch_sizeintegerbody

Số node tối đa được nâng cấp cùng lúc. Mặc định: 1.

nodegroupstringbody

ID của node group cần nâng cấp.

Request mẫu​

curl -ks -X POST -H 'Content-Type: application/json' \
-H 'OpenStack-API-Version: container-infra 1.8' -H 'X-Auth-Token: gAAAAA<...>' \
-d '{
"cluster_template": "b5093d08-f9fd-4a7c-8f69-8cfeb3710e4e",
"max_batch_size": 1
}' https://api.vietnix.cloud:9513/v1/clusters/{cluster_ident}/actions/upgrade

Response​

Response mẫu​

{
"uuid": "01d0583d-e8b3-483f-896f-08d2260b0dea"
}

Mã trạng thái​

Thành công​

Mã trạng tháiMô tả
202 - AcceptedYêu cầu nâng cấp đã được nhận và đang xử lý.

Lỗi​

Mã trạng tháiMô tả
401 - UnauthorizedCần xác thực trước khi gửi request.
403 - ForbiddenPolicy không cho phép user hiện tại thực hiện thao tác này.
404 - Not FoundCluster hoặc template không tồn tại.
409 - ConflictCluster đang ở trạng thái không cho phép nâng cấp.
warning

Không thể rollback bản nâng cấp qua API. Hãy backup workload và etcd trước khi bắt đầu, và giữ max_batch_size là 1 cho tới khi kiểm tra xong node đầu tiên.

note

Template đích phải dùng image và phiên bản Kubernetes mới hơn cluster hiện tại. Không hỗ trợ hạ cấp.