# 通用问题

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

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

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

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

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

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

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

    # 3. 如何查看错误日志？

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

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

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

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

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

    # 5. 如何复用 Addon？

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

    addons:
  redis-abc:
    plan: redis:basic

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

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

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

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

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

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

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

    提示

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

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

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

      volumes:
- storage: nfs
  path: /data/cert

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

      volumes:
- storage: local
  path: /u01/app/oracle

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

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

    curl ifconfig.me

    # 10. 平台支持 Java 11 吗？

    支持，可通过指定 container_version 切换运行容器的 JDK 版本。目前支持 JDK 1.8 和 11 两个版本 。

    pipeline.yml 中的配置如下:

    - java:
    params:
      build_type: maven # 打包类型，这里选用 maven 打包
      workdir: ${git-checkout} # 打包时的当前路径，此路径一般为根 pom.xml 的路径
      options: -am -pl user # maven 打包参数，比如打包 user 模块使用命令 `mvn clean package -am -pl user`，这里省略命令 `mvn clean package` 只需要填写参数
      target: ./user/target/user.jar # 打包产物，一般为 jar，填写相较于 workdir 的相对路径。文件必须存在，否则将会出错。
      container_type: spring-boot # 运行 target（如 jar）所需的容器类型，比如这里我们打包的结果是 spring-boot 的 fat jar，故使用 spring-boot container
      #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。

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

    2. 添加 Maven 仓库信息。

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

    3. 等待组件重启完成。

    # 13. 前端项目流水线失败

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

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

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

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

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

    原因：内存溢出进程被 kill

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

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

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

    - js-pack:
    params:
      ...
    resources:
      cpu: 1
      mem: 4096
    1. 容器内调试

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

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

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

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

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

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

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

    如果用户重新指定的 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。