本文介紹如何使用EDAS提供的Java SDK調用API在K8s集群中終止應用升級變更流程并回滾。
前提條件
在終止應用升級變更流程并回滾前,您必須提前完成以下準備工作:
- 安裝EDAS的Java SDK。更多信息,請參見Java SDK接入指南。
確保目標應用處于升級變更流程中,請根據實際需求選擇應用升級方式:
可選:調用ListRecentChangeOrder接口,查詢應用變更記錄,獲取應用正在升級變更的變更單流程ID(ChangeOrderId)。假設為47e2b863-adc8-4a0e-ac23-8361b95a****。
如果您在升級應用時已經記錄變更單流程ID(ChangeOrderId),則無需調用該接口。
示例代碼
以下代碼適用于在EDAS K8s集群中快速終止應用升級變更流程并回滾。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.edas.model.v20170801.AbortAndRollbackChangeOrderRequest;
import com.aliyuncs.edas.model.v20170801.AbortAndRollbackChangeOrderResponse;
public class AbortAndRollbackChangeOrder {
public static void main(String[] args) {
// 阿里云賬號AccessKey擁有所有API的訪問權限,風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維,請登錄RAM控制臺創建RAM用戶。
// 此處以把AccessKey和AccessKeySecret保存在環境變量為例說明。您可以根據業務需要,保存到配置文件里。
// 強烈建議不要把AccessKey和AccessKeySecret保存到代碼里,會存在密鑰泄漏風險。
String aliyun_user_ak = System.getenv("ACCESS_KEY_ID");
String aliyun_user_sk = System.getenv("ACCESS_KEY_SECRET");
//應用所在地域ID。
String region_id = "cn-hangzhou";
DefaultProfile defaultProfile = DefaultProfile.getProfile(region_id, aliyun_user_ak, aliyun_user_sk);
DefaultAcsClient client = new DefaultAcsClient(defaultProfile);
//創建API請求,并設置參數。
AbortAndRollbackChangeOrderRequest request = new AbortAndRollbackChangeOrderRequest();
//應用的升級變更單流程ID。
request.setChangeOrderId("47e2b863-adc8-4a0e-ac23-8361b95a****");
try {
AbortAndRollbackChangeOrderResponse response = client.getAcsResponse(request);
System.out.println("ChangeOrderId=" + response.getData().getChangeOrderId() + "\nMessage=" + response.getMessage() + "\nTraceId=" + response.getTraceId());
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}
運行程序,返回的執行結果如下:
ChangeOrderId=aef94ee3-3142-4abc-9d7c-57249686****
Message=success
TraceId=210e815316184954351417778d****
結果驗證
您在終止應用升級變更流程并回滾后,可以調用GetChangeOrderInfo接口查看變更流程詳情,獲取回滾應用的變更狀態。具體API參數詳情,請參見GetChangeOrderInfo。
調用GetChangeOrderInfo接口查看變更流程詳情,返回的執行結果如下:
{
"Message": "success",
"RequestId": "92C41E0B-949F-44A2-A386-AECA8909225E",
"Code": 200,
"changeOrderInfo": {
"Status": 2,
"Desc": "Deployment Method: Phased Release | Version: 2021-04-15 14:01:12 | Package Name: sc-consumer-D-0.0.1-SNAPSHOT.jar",
"PipelineInfoList": {
"PipelineInfo": [
{
"PipelineStatus": 2,
"PipelineName": "Batch 1 Change",
......
"TaskMessage": "Apply success. <br>application is ready at desired state, version: 22"
......
//此處未羅列全部執行結果,僅供參考。
請查看上述執行結果中的changeOrderInfo.Status參數值,通過該值判斷回滾應用的變更是否成功。changeOrderInfo.Status的取值如下:
0:準備
1:執行中
2:執行成功
3:執行失敗
6:終止
8:手動分批發布模式下,等待手工確認執行下一批。
9:自動分批發布模式下,等待下一批執行中。
10:系統異常執行失敗
說明
如果返回結果中的changeOrderInfo.Status值為3,即表示終止應用變更并回滾失敗。您可以根據返回結果中的TaskMessage參數的值分析錯誤原因,解決問題后重新升級應用。
文檔內容是否對您有幫助?