通用问题

1. 如何对服务进行扩缩容？

扩缩容服务无需调整 dice.yml，直接在部署中心操作即可。具体请参见 扩缩容。

  1. 进入 DevOps 平台 > 项目 > 应用中心 > 环境部署，选择 Runtime 后点击 服务扩容。

    通用问题 - 图1

  2. 根据需要进行服务资源调整。

    通用问题 - 图2

2. 服务是否提供内部调用的地址？

进入 DevOps 平台 > 项目 > 应用中心 > 环境部署，选择 Runtime 后可查看服务的内部地址。

服务的重新部署或流水线的重新构建均不会影响该内部地址。

通用问题 - 图3

3. 如何查看错误日志？

  1. 进入 DevOps 平台 > 项目 > 应用中心 > 环境部署，选择 Runtime 后点击容器日志，此时显示的是标准输出（stdout）日志。具体请参见 服务日志。

    通用问题 - 图4

  2. 点击顶部切换开关，查看标准错误（stderr）日志。

    通用问题 - 图5

4. 如何查看已停止的容器实例？

  1. 进入 DevOps 平台 > 项目 > 应用中心 > 环境部署，选择 Runtime，选择 已停止 查看对应容器实例。

    通用问题 - 图6

  2. 状态栏将标注容器停止的原因（如 OOM 退出，将标注为 OOMKilled）。操作栏中可查看容器运行时的资源使用情况以及对应日志。

5. 如何复用 Addon？

基于 Addon 的名称进行复用，例如 dice.yml 中有如下描述，则 redis-abc 即该 Addon 的名称：

  1. addons:
  2.   redis-abc:
  3.     plan: redis:basic

6. 使用 API 网关进行转发，页面重定向失败怎么办？

失败原因一般为使用了请求头中的 Host，建议使用 X-Forwarded-Host 进行替代，或者开启 API 网关的域名透传，步骤如下：

  1. 进入 微服务治理平台 > 服务治理 > API 网关 > 流量入口管理，选择对应流量入口详情，点击 全局策略。

    通用问题 - 图7

  2. 进入 业务策略 > 流量接收转发，启用规则后开启 入口域名透传。

    通用问题 - 图8

7. 如何对特定域名或 API 控制 HTTPS 强制跳转？

  1. 进入 微服务治理平台 > 服务治理 > API 网关 > 流量入口管理，点击对应流量入口详情，选择 全局策略 或 策略。（全局策略对该流量入口下所有 API 生效，具体 API 策略仅对该 API 生效。）

    通用问题 - 图9

  2. 进入 业务策略 > 流量接收转发，启用规则后开启 强制跳转HTTPS。

    通用问题 - 图10

tip 提示 若在 SLB 等外部负载均衡设备上，已配置 80 端口强制 HTTPS 跳转，则 Erda 上的跳转功能无效。

8. 如何在容器中使用存储？

  • 场景一：多个容器需共享某些特定文件（如支付证书）时，一个应用的多个实例将共享一块存储，对支付证书进行存取。dice.yml 中的配置参考如下：

    1. volumes:
    2. - storage: nfs
    3.   path: /data/cert

  • 场景二：部署一个需持久化存储的服务时（如 Oracle），可在 dice.yml 中声明一块 Local 类型的 Volumes，则该 Pod 重启后将再次分配到当前宿主机上。

    1. volumes:
    2. - storage: local
    3.   path: /u01/app/oracle

9. 如何确定一个容器的出口 IP？

当部署在 Erda 上的应用需调用外部接口（如支付接口）时，第三方服务通常需获取公网的出口 IP 来定位问题，此时可在容器控制台中执行以下命令：

```shell script curl ifconfig.me

  2. ![](https://terminus-paas.oss-cn-hangzhou.aliyuncs.com/paas-doc/2021/08/18/4171251f-9165-4b7a-b4de-bcb6a52aa41d.png)
  4. ## 10. 平台支持 Java 11 吗？
  6. 支持，可通过指定 `container_version` 切换运行容器的 JDK 版本。目前支持 JDK 1.8 和 11 两个版本 。
  8. pipeline.yml 中的配置如下:
  • java: params:
    1. build_type: maven # 打包类型，这里选用 maven 打包
    2. workdir: ${git-checkout} # 打包时的当前路径，此路径一般为根 pom.xml 的路径
    3. options: -am -pl user # maven 打包参数，比如打包 user 模块使用命令 `mvn clean package -am -pl user`，这里省略命令 `mvn clean package` 只需要填写参数
    4. target: ./user/target/user.jar # 打包产物，一般为 jar，填写相较于 workdir 的相对路径。文件必须存在，否则将会出错。
    5. container_type: spring-boot # 运行 target（如 jar）所需的容器类型，比如这里我们打包的结果是 spring-boot 的 fat jar，故使用 spring-boot container
    6. #container_version: v1.8.0.181 # 可选: v1.8.0.181, v11.0.6, 默认 v1.8.0.181
    ```

11. 创建流水线时提示缺少参数 ClusterName 怎么办？

该提示代表当前环境下无可用的集群。

集群是流水线执行的必要条件，请进入 DevOps 平台 > 项目 > 项目设置 > 项目信息 > 编辑 为当前环境指定集群并设置配额。

12. 如何配置全局私有 Maven 仓库？

默认情况下，Erda 采用 maven.aliyun.com 作为 Maven 仓库地址，您可以通过如下方式进行修改：

  1. 编辑 configmap。

    1. kubectl edit cm dice-addons-info -n erda-system

  2. 添加 Maven 仓库信息。

    1. NEXUS_ADDR: # 仓库内部地址，构建任务在 Master 集群中会使用该地址
    2. NEXUS_PUBLIC_URL: # 仓库外部地址，构建任务在 Worker 集群中会使用该地址
    3. NEXUS_USERNAME: # (可选) 仓库用户名
    4. NEXUS_PASSWORD:  # (可选) 仓库密码

  3. 等待组件重启完成。

13. 前端项目流水线失败

一般先切换到错误日志中看是否能定位到错误原因，常见问题有如下几种：

  1. 出现错误日志：
  1. Happythread[babel:0] unable to send to worker! ...

原因: happypack 默认会使用多线程编译，而流水线 Job 在容器中运行限制了构建资源，不支持多核构建

解决方式：happypack 的配置里设置 threads: 1 或 ThreadPool({ size: 1 })

  1. 出现错误日志：
  1. npm ERR! code ELIFECYCLE
  2. npm ERR! errno 137

原因：内存溢出进程被 kill

解决方式：action 配置的 build_cmd 对应的 npm script（默认为 npm run build），设置内存大小。不设置时 Node 进程内存限制为 1.4G，所以要手动设置内存大小。 以如下配置为例，设置为使用 4G 内存进行编译。

  1. "build": "webpack --config webpack.config.js"
  2. // 改为
  3. "build": "node --max_old_space_size=4096 ./node_modules/.bin/webpack --config webpack.config.js"

同时要设置流水线 action 的资源大小，js-pack action 默认为 1Core 2G

  1. - js-pack:
  2.     params:
  3.       ...
  4.     resources:
  5.       cpu: 1
  6.       mem: 4096
  1. 容器内调试

如果使用 js-pack action, 从日志看不出原因，可以加如下配置

  1. - js-pack:
  2.     params:
  3.       ...
  4.       preserve_time: 300 # 保留 300 秒，即 5 分钟

在报错后，容器会按配置时间的长度继续运行。在日志顶部，会打印出类似 NAMESPACE: pipeline-102679155835278 这样的内容，复制。

进入 多云管理平台 > 容器资源 > Pods，顶部选择分支对应的集群，然后在下方的命名空间里粘贴，应该可以查到该流水线。

点击该流水线记录后可以看到该流水线的容器，通过操作可进入容器控制台，然后就可以进行调试了。

14. 用户指定了 settings 文件后 nexus 下载 401 问题

流水线 Java工程编译打包 action 会配置默认的全局 settings.xml ，其中 server.id 为 terminus，文件目录地址

如果用户重新指定的 settings.xml 中 server.id 和默认的一样， 就会导致用户名和密码被重新指定的 settings.xml 覆盖，从而导致下载失败。

解决方案：

  1. 不使用默认的全局配置, 重新指定参数 -s 改为 -gs。

    示例： mvn clean deploy -Dtrantor.deploy=true -Dmaven.test.skip=true -P test -U -s ((maven_setting)) 改为 mvn clean deploy -Dtrantor.deploy=true -Dmaven.test.skip=true -P test -U -gs ((maven_setting))

  2. 用户指定的 settings.xml 中的 server.id 改成非 terminus。