本文介紹如何使用EDAS提供的Java SDK調用API在EDAS ECS環(huán)境中創(chuàng)建應用。
前提條件
在EDAS ECS環(huán)境中創(chuàng)建應用前，您必須提前完成以下準備工作：
- 安裝EDAS的Java SDK。更多信息，請參見Java SDK接入指南。
確定創(chuàng)建應用的地域，假設為cn-hangzhou。
創(chuàng)建微服務空間。具體操作，請參見創(chuàng)建命名空間。
如果已經存在命名空間，您可以調用ListUserDefineRegion接口查詢用戶自定義命名空間列表，獲取目標命名空間的RegionId。
- 創(chuàng)建ECS集群，具體操作，請參見使用API創(chuàng)建ECS集群。
如果您已經創(chuàng)建了ECS集群，則可以調用ListCluster接口查詢集群列表，獲取目標ECS集群的集群ID（ClusterId），假設為369d06d7-450b-4f3d-bf75-9536fcd9****。
在ECS集群中添加ECS實例，具體操作，請參見使用API擴容ECS集群。
調用ListScaleOutEcu接口從指定ECS集群中查詢ECU列表，獲取ECU的唯一標識ID（EcuId），假設為82a0ac57-433d-4ad1-ae89-0c6fcb70****和e2674482-1214-4c93-b767-9b6405e2****。
如果需要創(chuàng)建HSF應用，則需要調用ListBuildPack接口查詢容器版本列表，獲取容器版本（ConfigId）參數，假設為57。
創(chuàng)建應用
以下代碼適用于在EDAS ECS集群中快速創(chuàng)建應用。代碼中未設置掛載腳本信息和JVM參數信息，如需了解更多API參數信息，請參見InsertApplication。
以下代碼適用于創(chuàng)建Spring Cloud和Dubbo應用，如需創(chuàng)建HSF應用，則需要在代碼中增加EDAS-Container信息：
//EDAS-Container構建包號，當創(chuàng)建HSF應用時，該參數必須指定。可以調用ListBuildPack接口獲取，對應ConfigId參數。
request.setBuildPackId(57);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.InsertApplicationRequest;
import com.aliyuncs.edas.model.v20170801.InsertApplicationResponse;
public class InsertApplication {
public static void main(String[] args) {
// 阿里云賬號AccessKey擁有所有API的訪問權限，風險很高。強烈建議您創(chuàng)建并使用RAM用戶進行API訪問或日常運維，請登錄RAM控制臺創(chuàng)建RAM用戶。
// 此處以把AccessKey和AccessKeySecret保存在環(huán)境變量為例說明。您可以根據業(yè)務需要，保存到配置文件里。
// 強烈建議不要把AccessKey和AccessKeySecret保存到代碼里，會存在密鑰泄漏風險。
String aliyun_user_ak = System.getenv("ACCESS_KEY_ID");
String aliyun_user_sk = System.getenv("ACCESS_KEY_SECRET");
//要執(zhí)行API調用的應用所在地域ID。
String region_id = "cn-hangzhou";
DefaultProfile defaultProfile = DefaultProfile.getProfile(region_id, aliyun_user_ak, aliyun_user_sk);
DefaultAcsClient client = new DefaultAcsClient(defaultProfile);
//創(chuàng)建API請求，并設置參數。
InsertApplicationRequest request = new InsertApplicationRequest();
//目標ECS集群的集群ID。
request.setClusterId("369d06d7-450b-4f3d-bf75-9536fcd993dc");
//應用描述信息。
request.setDescription("create by edas pop api");
//自定義的應用名稱。應用名稱必須以字母開頭，允許數字、字母、下劃線（_）以及短劃線（-）組合，最多支持36個字符。
request.setApplicationName("ECSAPP_API");
//微服務空間的RegionId。
request.setLogicalRegionId("cn-hangzhou:doc");
//ECS集群中的ECS實例的ecu_id（導入EDAS的ECS實例在EDAS中的唯一身份），多個ecu_id用半角逗號（,）分開。
request.setEcuInfo("82a0ac57-433d-4ad1-ae89-0c6fcb70****,e2674482-1214-4c93-b767-9b6405e2****");
//應用部署包格式，可設置為war或者jar。
request.setPackageType("jar");
//應用組件ID。您創(chuàng)建Spring Cloud、Spring Boot或Dubbo應用時需要指定組件ID，創(chuàng)建HSF應用時無需設置。
//4代表Apache Tomcat 7.0.91，7代表Apache Tomcat 8.5.42，5代表OpenJDK 1.8.x，6代表OpenJDK 1.7.x。
request.setComponentIds("5");
//是否啟用健康檢查URL,true代表啟用，false代表不啟用。
request.setEnableUrlCheck(true);
//應用健康檢查URL。
request.setHealthCheckUrl("http://127.0.0.1:8080/_ehc.html");
try {
InsertApplicationResponse response = client.getAcsResponse(request);
System.out.println("Message=" + response.getMessage() + "\nAppName=" + response.getApplicationInfo().getAppName() + "\nAppId=" + response.getApplicationInfo().getAppId());
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}運行程序，返回的執(zhí)行結果如下所示：
Message=success
AppName=ECSAPP_API
AppId=6275ffd0-d577-4b5a-894f-e92991b8****結果驗證
在EDAS ECS環(huán)境中創(chuàng)建應用后，您可以調用ListApplication接口獲取應用列表。根據AppId和AppName等參數，判斷應用是否已經創(chuàng)建成功。
調用ListApplication接口，返回的結果如下：
{
"Message": "success",
"RequestId": "9363A94A-96C5-4B41-93A9-001A4E9DDEE1",
"ApplicationList": {
"Application": [
{
"BuildPackageId": 0,
"ApplicationType": "FatJar",
"AppId": "6275ffd0-d577-4b5a-894f-e92991b8****",
"ResourceGroupId": "rg-acfm3umruf2****",
"ClusterId": "369d06d7-450b-4f3d-bf75-9536fcd9****",
"RegionId": "cn-hangzhou:doc",
"ClusterType": 2,
"RunningInstanceCount": 0,
"Name": "ECSAPP_API"
}
]
},
"Code": 200
}