华为云用户手册

推送镜像提示组织数达到上限 错误日志 denied: The number of namespaces exceeds the upper limit [ERROR] : [pluginFrame] step run failed, errorMessage: DEV.CB.0210044, Docker push failed 分析处理 推送镜像时，如果使用未被任何用户占用的全新组织名，SWR服务会尝试为当前租户创建该组织；由于SWR服务限制了每个租户可创建的组织数，如果超过此限制，则会出现该错误。 出现此错误时，使用管理员账号（或任何有SWR组织管理权限的账号）前往组织管理并切换至对应region，查看已有的组织列表，选择使用已有组织或删除无用组织即可。

推送镜像提示无权限 错误日志 上传镜像到SWR仓库，提示如下错误： denied: you do not have the permission [ERROR] : [pluginFrame] step run failed, errorMessage: DEV.CB.0210044, Docker push failed 分析处理 此错误表示当前用户对目标组织没有权限，请逐步排查以下可能的原因： 编辑构建任务，单击“制作镜像并推送到SWR仓库”构建步骤，查看组织名。 登录 容器镜像服务 ，在组织管理里查看组织是否存在。 组织不存在，创建组织即可（组织数不可超过上限）。 组织存在，但当前用户对该组织没有编辑权限，推送镜像时仍然会出现此错误，管理员可参考授权管理选择性为当前用户授权。 组织存在，且用户对该组织有编辑权限，那么请进入 统一身份认证 服务，检查该用户是不是在只读权限的用户组里，如果是，请移除该用户。

推送镜像提示未登录 错误日志 denied: You may not login yet [ERROR] : [pluginFrame] step run failed, errorMessage: fail to execute docker command 分析处理 此类错误发生的原因一般有如下两种： push操作前未使用“docker login”命令登录，此时添加对应登录命令即可。 执行了登录命令，但是登录命令中SWR地址错误，导致执行没报错但实际登录未生效，需要核对登录命令是否正确。

推送镜像提示认证失败 错误日志 Error response from daemon: Get https://swr.example.example.com/v2/: denied: Authenticate Error [ERROR] : [pluginFrame] step run failed, errorMessage: fail to execute docker command. 分析处理 此类错误一般为SWR登录命令中账号/密码填写错误或临时登录账号信息已过期导致，获取有效登录指令重试即可。

问题现象 异常信息如下： 1 2 3 4 5 6 7 8 9 [2019-07-02 08:29:23.179] ERROR: Command "git submodule update --init --recursive --remote asae-feign" returned status code 1: [2019-07-02 08:29:23.179] stdout: Cloning into 'asae-feign'... [2019-07-02 08:29:23.179] [2019-07-02 08:29:23.179] Error: ERROR: Needed a single revision [2019-07-02 08:29:23.179] Unable to find current origin/develop revision in submodule path 'asae-feign' [2019-07-02 08:29:23.179] [2019-07-02 08:29:23.202] [INTERNAL] : [pluginFrame] step run failed, errorMessage: Could not perform submodule update [2019-07-02 08:29:23.250] [INFO] [代码检出] : StagePostExecution started [2019-07-02 08:29:23.251] [INFO] [代码检出] : StagePostExecution finished

处理方法 在Android构建过程中推荐使用“Android APK签名”构建步骤完成APK签名，编译构建提供了Android APK签名构建步骤，配置方法如下： 在“Android构建”步骤后添加“Android APK签名”步骤。 参数说明如下： 参数 说明 需要签名的APK路径 Android构建后生成要签名的.apk文件位置，支持正则表达式，如：可以使用build/bin/*.apk匹配构建出来的APK包。 Keystore文件 用于签名的Keystore文件，单击下拉列表，展示文件管理已经上传的Keystore文件，请根据需要选择。 keystore password 密钥文件密码。 别名（Alias） 密钥别名。 key password 密钥密码。 apksigner命令行 用户自定义签名参数，默认“--verbose”显示签名详细。 验证签名是否成功。 配置完成后执行构建任务，当显示任务执行成功后，查看构建日志，若“Android APK签名”那段日志中显示“result: Signed”即为签名成功。

原因分析 找不到需要的文件。 上图中6068行的错误日志，“Module not found: Error: Can't resolve './App.Vue' in '/xxx/slave1/workspace/job_d5d70df6-9b64-4faa-ba67-93c06d4a1972_1545727944134/src'”，在“src”文件夹下找不到“./App.Vue”文件。可能原因如下： 对应文件夹下，没有所需文件。 文件路径大小写配置有误。图中代码配置的是“'./App.Vue'”，实际文件名是“'./App.vue'”，导致找不到所需文件。因为Windows系统不区分大小写，而Linux系统区分，所以可能本地能构建成功，在编译构建服务上却构建失败。

处理方法 方法一：升级nodejs版本。 方法二：启动Node时设置“--max_old_space_size”或“--max_new_space_size”参数来调整内存大小的使用限制。 node --max_old_space_size=1700 test.js // 单位为MB 修改老生代内存限制 node --max_new_space_size=1024 test.js // 单位为KB 修改新生代内存限制 针对前端三大框架的解决方法如下： 框架类型 解决方法 Vue 只需要修改“package.json”文件中“build”属性值，在命令中加入带参数的node命令即可，例如： "build": "node --max_old_space_size=4096 ./node_modules/vite/bin/vite.js build" 或 "build": "node --max_old_space_size=4096 ./node_modules/@vue/cli-service/bin/vue-cli-service.js build" React 举例说明“package.json”里面“scripts”字段的内容如下： "scripts": { "start": "react-scripts start", "build": "react-scripts build", "test": "react-scripts test --env=jsdom", "eject": "react-scripts eject" } 运行npm run build的时候跑的实际代码是react-scripts build，项目根目录下“node_modules”文件夹，找到.bin目录并打开它找到“react-scripts”文件，打开这个文件，把--max_old_space_size=4096这行代码写在#!/usr/bin/env node后面： #!/usr/bin/env node --max_old_space_size=4096 Angular 举例说明“package.json”里面“scripts”字段的内容如下： "scripts": { "ng": "ng", "start": "ng serve", "build": "ng build", "test": "ng test", "lint": "ng lint", "e2e": "ng e2e" } 这里的ng命令也和React一样，在项目根目录“node_modules”文件夹下的.bin目录里面存在名为ng的文件，修改该文件的首行： #!/usr/bin/env node --max_old_space_size=4096

处理方法 修改文件路径长度至系统要求大小即可。 项目文件全路径长度实际为项目下文件相对路径长度与编译构建服务默认路径长度之和。 编译构建服务默认路径长度为45字符。 因此，在使用Msbuild构建的过程中，您的项目文件路径需满足：项目下文件相对路径（以代码仓库为根目录）长度不可大于215字符。 一些特殊场景（如构建时指定输出目录为“Output/release”)下，可能会额外占用路径长度。 建议您的项目下文件相对路径（以代码仓库为根目录）长度保持在200个字符以下，原则上尽可能短最好。

处理方法 下载对应版本的SDK（例：2.0.0，其他版本请直接替换命令中的2.0.0）。 powershell -Command Invoke-WebRequest -UseBasicParsing https://dotnetcli.blob.core.windows.net/dotnet/Sdk/2.0.0/dotnet-sdk-2.0.0-win-x64.zip -OutFile dotnet2.0.0.zip; 解压到当前路径下。 powershell -Command Expand-Archive dotnet2.0.0.zip; 复制sdk目录到“${Env:ProgramFiles}\dotnet\sdk”下。 powershell -Command Copy-Item -Recurse dotnet2.0.0\sdk\2.0.0 ${Env:ProgramFiles}\dotnet\sdk ;

原因分析 由提示信息可知，解决方案中引入了程序集“Microsoft.Office.Interop.Word”，但构建时环境中不具备此程序集，导致编译告警，如果项目代码中使用了此引用，甚至会直接导致失败。 通常情况下，此类程序集默认安装于本地系统，无需指定程序集位置，VS构建时会从默认配置的几个程序集路径查找，可以构建成功；而云端构建环境对应目录无此程序集，进而导致本地与云端构建不一致。 为解决此类场景，Msbuild集成了NuGet，可以在构建时从远程仓库下载对应程序集，此时只需于项目中指定“packages.config”，并于其中声明依赖的程序集即可。 特殊情况下，项目引用的程序集可能无法在远程仓库找到，此时需要手工保存程序集至代码仓库中，并显示指定程序集路径。

问题现象 构建告警： warning MSB3245: 未能解析此引用。 未能找到程序集“Microsoft.Office.Interop.Word, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c, processorArchitecture=MSIL”。请检查磁盘上是否存在该程序集。 如果您的代码需要此引用，则可能出现编译错误。

Gradle Wrapper使用教程 在本地环境中，进入代码根目录，执行gradle wrapper命令。命令执行完毕后，可以发现代码仓库中新增了以下文件： gradlew (Unix Shell 脚本) gradlew.bat (Windows批处理文件) gradle/wrapper/gradle-wrapper.jar (Wrapper JAR文件) gradle/wrapper/gradle-wrapper.properties (Wrapper属性文件) 提交代码到代码仓库。 修改构建任务中命令行里的语句，将gradle替换成./gradlew，如将gradle build替换为./gradlew build。

处理方法 网络异常导致，可以通过以下方法处理： 重试确认是否能解决，如果拉取失败的镜像是dockerHub镜像且重试无法解决，可参考拉取dockerHub镜像超时或失败。 如频繁出现或重试仍然失败请联系客服。 镜像不存在：请确保镜像已经上传至镜像仓，且镜像名称、镜像版本正确。 镜像为私有镜像：请将镜像设置为公开，或者先执行 docker login 鉴权通过后再执行 docker pull 操作。

处理方法 避免javadoc的检查，在项目根目录下的Gradle下面就要添加如下配置： allprojects { repositories { jcenter() } tasks.withType(Javadoc) { options.addStringOption('Xdoclint:none', '-quiet') options.addStringOption('encoding', 'UTF-8') } }

处理方法 可以在命令行中的gradle命令后加上-xlint参数，跳过lint检查。如： /bin/bash ./gradlew assembleDebug -Dorg.gradle.daemon=false -d --stacktrace -xlint 或 gradle assembleDebug -Dorg.gradle.daemon=false -d --stacktrace --init-script /root/.gradle/init.gradle -xlint

问题现象 执行过构建任务日志报错信息如下： Caused by: org.gradle.internal.resource.transport.http.HttpErrorStatusCodeException: Could not GET 'https://jcenter.bintray.com/org/apache/commons/commons-compress/1.8.1/commons-compress-1.8.1.pom'. Received status code 504 from server: Gateway Time-out

依赖范围错误 使用Maven管理依赖时，Maven坐标中scope属性定义了依赖的有效范围。错误地指定依赖范围会导致该依赖在compile时无效，如果此时在项目主代码中使用了此依赖中的包，则会导致编译错误。处理步骤： 使用mvn dependency:tree查看项目使用的依赖及依赖范围。 对比依赖范围以及项目中使用依赖的位置。 若在主代码中使用了依赖中的包，且要求依赖在编译时有效，则依赖的范围需要为以下之一： compile provided system：系统依赖范围必须通过systemPath指定依赖文件位置，且依赖文件必须存在于指定目录。

依赖包损坏 依赖包损坏可能会导致依赖包中某些文件缺失，此时构建可以找到相应依赖包，但无法找到其中的class文件或者package，导致此类问题。此场景下可按包类型分不同方式处理： 第三方依赖包：直接联系技术支持处理。 自研（手动上传到Maven私有仓库）的依赖包，按如下步骤排查： 从Maven私有依赖仓库下载依赖包。 解压缩并查看依赖包内容是否正常。 若依赖包内容异常，再分两种情况排查： 如果是第三方提供的包手动上传到maven私有依赖仓库，确认包文件无误并尝试重新上传（注意同时上传pom与jar文件）。 如果是自己构建（本地/云端构建）的依赖包，且已确认代码无误，则检查是否是多任务同时构建导致构建生成jar包内容缺失。

原因分析 分析日志可知，项目中引用了“com.sun.jersey.api.client.config”包下面的内容，但构建时无法从项目中以及所有解析出的依赖包中找到此包导致。导致此结果的原因一般有两大类： 代码问题：代码中包引用不正确，此类问题较易排查，如有遇到可优先排查代码。 环境/组件问题：依赖包损坏或不一致，此类问题常表现为本地可编译而云端构建失败；此章节主要为此类问题提供一些可能的解决方案。其中可能的环境/组件问题有： 依赖包冲突 依赖范围错误 使用GAV模式上传依赖包 依赖包损坏 其他

问题现象 异常信息如下： 1 [ERROR] The goal you specified requires a project to execute but there is no POM in this directory (/xxx/slavespace/slave3/workspace/job_4a1d5be4-b273-4ac8-8d5d-2ee583e71832_1544498089095). Please verify you invoked Maven from the correct directory.

处理方法 配置“Maven构建”构建步骤，展开“发布依赖包到CodeArts私有依赖库”，选择“配置所有pom”。 不配置pom：表示无需发布私有依赖包到CodeArts私有依赖库。 配置所有pom：表示在项目下所有“pom.xml”文件增加deploy配置，使用mvn deploy命令将构建出的依赖包上传到私有依赖仓库。 在命令窗口，使用“#”注释掉第8行的默认命令，并删除第18行命令前的“#”。 配置完成后执行构建任务。执行成功后即可将依赖包发布到私有依赖库。

问题现象 使用Maven等工具构建时，通常会依赖特定的构建文件，如：pom.xml文件等。如果工具找不到相应的构建文件，则会失败并报“xxx工程找不到xxx文件”此类错误，常见的错误信息如下： 工具 构建文件 错误信息 Maven pom.xml The goal you specified requires a project to execute but there is no POM in this directory (). Please verify you invoked Maven from the correct directory Ant build.xml Buildfile: build.xml does not exist! NPM package.json npm ERR! enoent ENOENT: no such file or directory, open '/package.json' Yarn package.json error Couldn't find a package.json file in ""

处理方法 确定target目录下有war包，只是名字可能不是“bb.war”。 这种情况下修改构建包路径为“**/target/*.war”，正则匹配war包。 无法确定target目录下有哪些文件。 在构建执行的步骤shell里最后增加“ls -al target”，再次执行构建，就会打印出target目录下的所有文件。找到需要的文件位置后，再重写构建包路径配置。 如果构建结果不在workspace目录（构建命令在workspace目录或其子目录下执行），则在下一个Action中将丢失此构建包，因此需要提前拷贝构建包到workspace目录，如： mv /usr/bin/nginx ./。 相关构建步骤：上传软件包到软件发布库。

问题现象 执行构建任务时，拉取dockerhub镜像超时/次数限制，日志报如下异常信息： Error response from daemon: Get https://registry.docker-cn.com/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers) 或 toomanyrequests: You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit

处理方法 进入编译构建服务首页。 选择对应的构建任务，单击任务所在行的，单击“编辑”。 在“构建步骤”页面编辑“制作镜像并推送到SWR仓库”。 单击“管理 IAM 账号”。 单击“新建扩展服务点”，选择“IAM账户”。 在弹出的窗口中填写参数信息。 Access Key Id和Secret Access Key获取方式如下： 单击页面左上角“控制台”。 单击页面右上角账号名称，选择“我的凭证”。 单击“访问密钥”。 单击“新增访问密钥”，填写相关描述，单击“确定”。 在弹出的窗口中单击“立即下载”，可将密钥信息下载到本地。 步骤4中的IAM账号选择步骤6中新建的服务扩展点。

处理方法 进入编译构建服务首页。 选择对应的构建任务，单击任务所在行的，单击“编辑”。 在“构建步骤”页面编辑“NPM构建”。 在NPM构建步骤里，添加如下命令，修改Npm镜像仓地址： 1 npm config set registry https://repo.xxcloud.com/repository/npm/ 或 npm config set registry https://registry.npm.taobao.org 单击“保存并执行”，重新执行构建任务。

问题现象 执行Npm构建任务时，日志报如下异常信息： Downloading binary from https://github.com/sass/node-sass/releases/download/v4.14.1/linux-x64-72_binding.node Cannot download "https://github.com/sass/node-sass/releases/download/v4.14.1/linux-x64-72_binding.node": read ECONNRESET ... npm ERR! code ELIFECYCLE npm ERR! errno 1 npm ERR! node-sass@4.14.1 postinstall: `node scripts/build.js` npm ERR! Exit status 1 npm ERR! npm ERR! Failed at the node-sass@4.14.1 postinstall script. npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

问题现象 执行Npm构建任务时，日志报如下异常信息： Module Error (from ./node_modules/@vue/cli-plugin-eslint/node_modules/eslint-loader/index.js): ***//public/LodopFuncs.js 79:25 error 'getCLodop' is not defined no-undef 80:27 error Empty block statement no-empty 89:21 error 'CLODOP' is not defined no-undef

概述 对于 OMS 不适用的数据迁移场景（约束与限制），华为云另外提供了迁移中心MgC和迁移工具RDA进行数据迁移，您可以根据具体迁移场景选择迁移方式。 表1 存储迁移工具 迁移工具 迁移网络 支持迁移的源端存储类型 支持特性 迁移中心MgC 公网/专线 华为云 OBS 阿里云 OSS 百度云 BOS 腾讯云 COS 金山云 KS3 七牛云 KODO 优刻得 US3 亚马逊 S3 微软 Blob NAS_SMB NAS_NFS_V3_MOUNT NAS_NFS_V3_PROTOCOL HTTP/HTTPS数据源 支持专线迁移 支持集群扩容 支持迁移前评估 支持批量桶迁移 迁移工具RDA 公网/专线 华为云 OBS 阿里云 OSS 百度云 BOS 腾讯云 COS 金山云 KS3 七牛云 KODO 谷歌云 G CS 优刻得 US3 亚马逊 S3 微软 Blob 移动云 EOS NAS HTTP/HTTPS数据源 支持专线迁移 支持集群扩容 父主题： 其他迁移场景