（一百五）深度剖析：ArkCompiler 持续部署（CD）工具与自动化部署实践 原创

深度剖析：ArkCompiler 持续部署（CD）工具与自动化部署实践

在软件开发生命周期里，持续部署（CD）作为衔接开发与生产环节的关键阶段，发挥着不可或缺的作用。对于运用 ArkCompiler 开展 HarmonyOS 应用开发的团队而言，借助 CD 工具实现自动化部署，不仅能够大幅缩短应用上线周期，降低人为失误，还能增强产品的稳定性和可靠性。本文将深入探讨适用于 ArkCompiler 开发的 CD 工具集成方法，以及如何搭建自动化部署流程。

一、CD 工具的集成

1. Jenkins 集成

Jenkins 凭借丰富的插件生态和高度的可定制性，成为实现持续部署的热门选择。在已完成 ArkCompiler 项目持续集成配置的基础上，进一步配置持续部署功能。

安装与配置插件

进入 Jenkins 的 “插件管理” 页面，安装 “Publish Over SSH” 插件。该插件允许 Jenkins 通过 SSH 协议将构建产物传输到目标服务器。安装完成后，在 “系统设置” 中配置 SSH 服务器信息，包括服务器地址、端口、用户名和密码或密钥。

创建部署任务

在 Jenkins 中新建一个任务，任务类型建议选择 “Freestyle project”。在 “源码管理” 部分沿用之前项目的配置，确保能够拉取到最新代码。在 “构建后操作” 中，添加 “Send files or execute commands over SSH” 步骤，配置如下：

​​Source files: <构建产物路径>​​

​​Remove prefix: <需移除的路径前缀>​​

​​Remote directory: <目标服务器的部署目录>​​

​​Exec command: <部署后执行的命令，如重启服务>​​

将<构建产物路径>替换为实际的 ArkCompiler 构建产物路径，例如app/build/outputs/apk/release/app-release.apk；<需移除的路径前缀>根据项目情况填写；<目标服务器的部署目录>指定服务器上存放构建产物的位置；<部署后执行的命令，如重启服务>按需配置，若部署的是 HarmonyOS 服务，可使用命令重启服务。

2. GitLab CI/CD 集成

GitLab CI/CD 作为 GitLab 平台内置的 CI/CD 解决方案，与代码仓库紧密集成，能够简化部署流程。

扩展.gitlab-ci.yml 文件

在项目根目录下的.gitlab-ci.yml文件中，添加部署阶段和任务。假设采用 SSH 方式部署到服务器，示例配置如下：

​​image: alpine:latest​​

​​stages:​​

​​- build​​

​​- deploy​​

​​build_job:​​

​​stage: build​​

​​script:​​

​​- cd <your_project_directory>​​

​​- ./gradlew build​​

​​deploy_job:​​

​​stage: deploy​​

​​script:​​

​​- apk add openssh-client​​

​​- eval $(ssh-agent -s)​​

​​- echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -​​

​​- mkdir -p ~/.ssh​​

​​- chmod 700 ~/.ssh​​

​​- ssh -o StrictHostKeyChecking=no <username>@<server_ip> "mkdir -p <remote_directory>"​​

​​- scp -o StrictHostKeyChecking=no <your_project_directory>/<build_output> <username>@<server_ip>:<remote_directory>​​

​​- ssh -o StrictHostKeyChecking=no <username>@<server_ip> "<deploy_command>"​​

​​environment:​​

​​name: production​​

​​when: manual​​

将<your_project_directory>替换为项目的实际路径；<build_output>为构建产物路径；<username>为目标服务器的用户名；<server_ip>为服务器 IP 地址；<remote_directory>为服务器上的部署目录；<deploy_command>为部署后执行的命令。when: manual表示该部署任务需手动触发，也可根据需求改为自动触发。

二、如何实现自动化部署

1. 部署前准备

服务器环境配置

在目标服务器上安装运行 HarmonyOS 应用所需的环境，如 Java 运行时环境、ArkCompiler 运行依赖等。同时，配置好防火墙规则，确保服务器能够接收来自 Jenkins 或 GitLab CI/CD 的连接，并正常访问应用所需的资源。

配置环境变量

在 CI/CD 工具中配置与部署相关的环境变量，如服务器地址、用户名、密码或密钥等。在 Jenkins 中，可在 “系统设置” 或任务配置的 “环境变量” 部分进行设置；在 GitLab CI/CD 中，可在项目的 “Settings” -> “CI/CD” -> “Variables” 中添加环境变量。

2. 自动化部署流程

构建与测试

在自动化部署流程中，首先触发 ArkCompiler 项目的构建任务，并运行单元测试和 UI 测试，确保代码质量。如前文所述，在 Jenkins 中通过配置构建步骤执行 Gradle 构建和测试命令；在 GitLab CI/CD 中，在.gitlab-ci.yml文件的build_job中定义构建和测试脚本。

部署到目标服务器

测试通过后，CI/CD 工具将构建产物传输到目标服务器，并执行部署命令。在 Jenkins 中，通过 “Publish Over SSH” 插件实现文件传输和命令执行；在 GitLab CI/CD 中，通过.gitlab-ci.yml文件中的deploy_job完成部署操作。

验证部署结果

部署完成后，可通过编写脚本来验证应用是否正常运行。例如，发送 HTTP 请求到应用的接口，检查响应状态码；或者检查服务器日志，确认应用是否成功启动。在 Jenkins 或 GitLab CI/CD 的部署任务中添加验证步骤，若验证失败，可发送通知给开发团队。

三、总结

通过将 Jenkins、GitLab CI/CD 等 CD 工具集成到 ArkCompiler 开发流程中，并搭建自动化部署体系，开发团队能够实现从代码提交到应用上线的全流程自动化，提升开发效率，降低运维成本，增强产品的竞争力。在实际应用中，需根据项目的规模、需求和技术架构，选择合适的 CD 工具和部署策略，持续优化部署流程，为用户提供更优质的 HarmonyOS 应用。