基于EDAS OPENAPI构建低成本云原生CICD

在企业级场景中，EDAS会被集成到客户侧的研发测试的IT流程中形成更加完整的企业IT云化整体解决方案，如对接到客户的CMP多云管理平台，被串联到客户的CICD流水线中，和客户的统一监控运维平台对接等。为方便EDAS更好的在各行业中使用和集成，我们基于多个真实项目经验输出了本次最佳实践，以供您参考。

背景信息

企业级分布式应用服务EDAS（Enterprise Distributed Application Service）是阿里云原生产品体系的核心产品之一，为复杂微服务的构建和托管提供端到端应用生命周期管理。

最佳实践概述

本次最佳实践通过打通客户侧GitLab、Jenkins与专有云企业版提供的EDAS和ACK来帮助客户构建端到端企业级云原生CICD流水线。具体实现思路为通过JAVA编写一个EDAS-SDK适配插件，Jenkins通过在脚本库预先设置的SHELL脚本来调用该插件，从而集成EDAS在持续交付层面的能力。在大中型场景中，我们推荐企业级开发测试云场景使用企业版或敏捷版中的云效+EDAS组合。

最佳实践价值

EDAS本身可以作为微服务精细化治理中心，并联动ACK容器服务支撑微服务的部署和运行，是一个非常完整优质的云原生解决方案(关于使用EDAS进行微服务开发的最佳实践将在另外的篇章中单独输出，在这里不做赘述)。通过企业版的POP 网关，您可以快速的调用EDAS-OpenAPI，从而将阿里侧云原生能力快速集成到企业的现有研发和运维IT流程中。

软件环境介绍

本最佳实践基于阿里云专有云企业版V3.9.0版，如下图为专有云企业版V3.9.0 Apsara Stack控制台界面。EDAS控制台由Apsara Stack控制台单点登录并跳转。

提交代码

本示例中代码管理在GitLab中。完成以下步骤提交代码：

1. 开发提交代码到git本地仓库。

2. 开发对需要发布的版本打上Tag。

3. 通过GitLab的tag push，将本地仓库代码同步到远程的gitLab服务上。

WebHook触发Jenkins的构建任务

前提条件：代码已提交到GitLab服务。

完成以下步骤，触发构建任务：

1. 在cicd的源码管理页面，配置git库地址。

2. 在cicd的构建触发器页面，配置触发器，并获取触发器的URL和Secret Token。

3. 在cicd的Settings页面，配置git库的WebHook。

说明 URL和Secret Token的值即上一步中获取的触发器的URL和Secret Token。

4. 在cicd的构建页面，配置构建镜像和推送镜像。

5. 执行如下命令配置触发调用EDAS Open API小程序对外暴露的请求地址，用于访问EDAS后台。

curl 192.XXX.XXX.XXX:XXX/aliyun/edas/deploy

准备工作

Jenkins构建完项目后，您需要按版本号通过以下步骤操作把镜像上传到镜像仓库，然后即可调用EDAS OpenAPI拉取镜像部署应用、通知相关人员等。

前提条件：

• 在JAVA项目工程中声明并引入EDAS-SDK。
• 获取EDAS-OpenAPI对外的服务域名，即专有云EDAS-endpoint地址。
• 在适配插件中拼装请求报文，完成API调用的指令。

背景条件：CICD流程调用EDAS OpenAPI接口：

• 调用GetK8sApplication接口获取容器服务K8s中部署的应用镜像URL信息。
• 调用DeployK8sApplication接口拉取应用镜像部署容器服务K8S应用。

1. 在适配插件中引入EDAS-SDK。
   在IDE工具上打开Maven项目下的pom.xml文件，在文件中添加​​sdk:aliyun-java-sdk-core​​和​​sdk：aliyun-java-sdk-edas​​依赖。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.4.3</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-edas</artifactId>
    <version>2.53.1</version>
</dependency>

2. 获取RegionId、AccessKey ID和AccessKey Secret。

登录Apsara Stack控制台，在左侧导航栏单击用户中心 > 部门管理，选择对应的部门，单击获取AccessKey 。

3. 获取EDAS API服务地址endpoint。

登录天基平台，单击报表 > 全部报表 > 资源申请报表，全局搜索edas-api，其中详情页面domain即endpoint的值。

获取容器服务中部署的应用信息

请求URL

/pop/v5/changeorder/co_application

请求参数

返回参数

请求示例

public class GetK8sApplicationSimpleInfo {


    public String getK8sApplication() throws ClientException {
        //请填写要执行 API 调用的应用所在地域 ID.
        String regionId = "your_ regionId";
        //请填写阿里云主账号或子账号 AccessKey ID.
        String accessKeyId = " your_accessKeyId ";
        //请填写阿里云主账号或子账号 AccessKey Secret.   
        String accessKeySecret = " your_accessKeySecret ";
        String productName = "Edas";
        String domain ="edas-api.console.cn-*******-****-***.com";
        DefaultProfile defaultProfile = DefaultProfile.getProfile(regionId,
accessKeyId, accessKeySecret);
        DefaultAcsClient defaultAcsClient = new DefaultAcsClient(defaultProfile);
        GetK8sApplicationRequest request = new GetK8sApplicationRequest();
        request.setAppId("f66a22ec-c98d-4b79-ab41-c8641bf9ac87");
        request.setEndpoint("edas-api.console. your_regionId.cloud.poc2.com");
        GetK8sApplicationResponse response;
        String resp = "";
        try {
            response = defaultAcsClient.getAcsResponse(request);
            resp = "返回码:" + response.getCode() + "----" + "返回信息:" + response.getMessage()
            + "镜像URL:" + response.getApplcation().getImageInfo().getImageUrl();          
            System.out.printf("返回码:" + response.getCode() + "----" + "返回信息:" + response.getMessage()
            + "镜像URL:" + response.getApplcation().getImageInfo().getImageUrl());
            } catch(ClientException e) {
                e.printStackTrace();
        }       
        return resp;


    }


}

返回示例

GetK8sApplicationResponse response;
        String resp = "";
        try {
            response = defaultAcsClient.getAcsResponse(request);
            resp = "返回码:" + response.getCode() + "----" + "返回信息:" + response.getMessage()
            + "镜像URL:" + response.getApplcation().getImageInfo().getImageUrl();          
            System.out.printf("返回码:" + response.getCode() + "----" + "返回信息:" + response.getMessage()
            + "镜像URL:" + response.getApplcation().getImageInfo().getImageUrl());
            } catch(ClientException e) {
                e.printStackTrace();
        }       
        return resp;

部署容器服务K8s应用

请求URL

/pop/v5/k8s/acs/k8s_apps

请求参数

返回参数

请求示例

public class DeployK8sApplictionSimpleInfo {
        public String deployK8sApplication() {
        //请填写阿里云主账号或子账号 AccessKey ID.
        String aliyun_user_ak = "your_ AccessKey ID ";
        //请填写阿里云主账号或子账号 AccessKey Secret.
        String aliyun_user_sk = "your_ AccessKey Secret ";
        //请填写要执行 API 调用的应用所在地域 ID.       
        String region_id = "your_regionid";       
        DefaultProfile defaultProfile = DefaultProfile.getProfile(region_id,
aliyun_user_ak, aliyun_user_sk);       
        DefaultAcsClient defaultAcsClient = new
        DefaultAcsClient(defaultProfile);     
        DeployK8sApplicationRequest request = new DeployK8sApplicationRequest();       
        request.setAppId("f66a22ec-c98d-4b79-ab41-c8641bf9ac87");       
        request.setEndpoint("edas-api.console. your_regionId.cloud.poc2.com");       
        request.setImage("cr.registry.cloud.poc2.com/pdsa/k8s-nacos-consumer:v2");       
        request.setImageTag("v2");       
        request.setJDK("Open JDK 8");       
        request.setEnvs("[{\"name\":\"updatetime\",\"value\":\""+ new Date() + "\"}]");       
        DeployK8sApplicationResponse response;       
        String resp = "";
        try {           
            response = defaultAcsClient.getAcsResponse(request);           
            resp = "返回码:" +response.getCode() + "----" + "返回信息:" + response.getMessage();
            System.out.printf("返回码:" + response.getCode() + "----" + "返回信息:" + response.getMessage());
        }catch (ClientException e) {           
            e.printStackTrace();
        }       
        return resp;
    }
}

返回示例

DeployK8sApplicationResponse response;       
String resp = "";
try {           
    response = defaultAcsClient.getAcsResponse(request);           
    resp = "返回码:" +response.getCode() + "----" + "返回信息:" + response.getMessage();
    System.out.printf("返回码:" + response.getCode() + "----" + "返回信息:" + response.getMessage());
}catch (ClientException e) {           
    e.printStackTrace();
}       
return resp;

​

关注公众号 soft张三丰