通用问题

通用问题

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

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

进入 DevOps 平台 > 项目 > 应用中心 > 环境部署，选择 Runtime 后点击 服务扩容。
根据需要进行服务资源调整。

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

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

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

3. 如何查看错误日志？

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

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

进入 DevOps 平台 > 项目 > 应用中心 > 环境部署，选择 Runtime，选择 已停止 查看对应容器实例。
状态栏将标注容器停止的原因（如 OOM 退出，将标注为 OOMKilled）。操作栏中可查看容器运行时的资源使用情况以及对应日志。

5. 如何复用 Addon？

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

addons:
  redis-abc:
    plan: redis:basic

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

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

进入 微服务治理平台 > 服务治理 > API 网关 > 流量入口管理，选择对应流量入口详情，点击 全局策略。
进入 业务策略 > 流量接收转发，启用规则后开启 入口域名透传。

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

进入 微服务治理平台 > 服务治理 > API 网关 > 流量入口管理，点击对应流量入口详情，选择 全局策略 或策略。（全局策略对该流量入口下所有 API 生效，具体 API 策略仅对该 API 生效。）
进入 业务策略 > 流量接收转发，启用规则后开启 强制跳转HTTPS。

tip 提示

若在 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 来定位问题，此时可在容器控制台中执行以下命令：

```shell script curl ifconfig.me


![](https://terminus-paas.oss-cn-hangzhou.aliyuncs.com/paas-doc/2021/08/18/4171251f-9165-4b7a-b4de-bcb6a52aa41d.png)
## 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 仓库地址，您可以通过如下方式进行修改：

编辑 configmap。

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

添加 Maven 仓库信息。

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

等待组件重启完成。

13. 前端项目流水线失败

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

出现错误日志：

Happythread[babel:0] unable to send to worker! ...

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

解决方式：happypack 的配置里设置 threads: 1 或 ThreadPool({ size: 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

容器内调试

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

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

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

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

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

通用问题

通用问题

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

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

3. 如何查看错误日志？

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

5. 如何复用 Addon？

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

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

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

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

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

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

13. 前端项目流水线失败

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