缓存目录使用说明
CodeArts Build在部分构建步骤中提供了依赖缓存的能力,能够极大提升用户构建时依赖包的下载效率,进而提升构建效率。用户在执行构建任务时,CodeArts Build在构建任务执行机上以租户维度进行远端缓存目录挂载,构建时直接使用,无需重复下载。当前支持缓存能力的构建步骤表1。
执行缓存清理操作前,请务必仔细阅读以下缓存清理风险以及注意事项:
- 由于缓存目录为同租户共享,频繁清理缓存会概率性导致同租户用户构建异常(常表现为“xxx文件不存在”),因此只可在缓存异常时清理,任务执行成功后务必再次编辑任务,删除清理命令,并且在执行清理缓存操作的同时,不要执行其他的使用缓存的编译构建任务。
- 出于安全考虑,缓存清理命令只可在对应构建步骤里执行,在其他步骤执行此命令会导致“目录不存在”或”清理无效”等报错。
构建步骤 |
缓存目录(只能填写绝对目录,禁止填写“./”开头的相对目录) |
缓存使用方式 |
清理缓存命令 |
---|---|---|---|
Maven构建 |
/repository/local/maven |
图形化配置方式,参考使用Maven构建。 |
rm -rf /repository/local/maven/{groupId}/{artifactId}/{version},需填入的参数分别对应依赖包坐标中的groupId、artifactId和version,其中groupId中的点会被自动分割为层级目录。 若依赖包如下: <dependency> <groupId>com.codearts.java</groupId> <artifactId>demo</artifactId> <version>1.0-SNAPSHOT</version> </dependency> 则清理该依赖包所需命令为:rm -rf /repository/local/maven/com/codearts/java/demo/1.0-SNAPSHOT |
NPM构建 |
/npmcache |
构建命令行输入:npm config set cache /npmcache |
npm cache clean --force |
Grunt构建 |
/npmcache |
构建命令行输入:npm config set cache /npmcache |
npm cache clean --force |
gulp构建 |
/npmcache |
构建命令行输入:npm config set cache /npmcache |
npm cache clean --force |
Android快应用构建 |
/npmcache |
构建命令行输入:npm config set cache /npmcache |
npm cache clean --force |
Yarn构建 |
/npmcache |
构建命令行输入:yarn config set cache-folder /npmcache |
yarn cache clean |
Gradle构建 (仅限使用gradle wrapper版本) |
./gradle/wrapper |
构建命令行输入:cp /cache/android/wrapper/gradle-wrapper.jar ./gradle/wrapper/gradle-wrapper.jar |
rm -rf ./gradle/wrapper/ |
Android构建 (仅限使用gradle wrapper版本) |
./gradle/wrapper |
构建命令行输入:cp /cache/android/wrapper/gradle-wrapper.jar ./gradle/wrapper/gradle-wrapper.jar |
rm -rf ./gradle/wrapper/ |