codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs//344/270/212/347/272/277/350/257/225/350/277/220/350/241/214/346/235/220/346/226/231/05/344/270/212/347/272/277/350/257/225/350/277/220/350/241/214/345/217/212/350/277/220/347/273/264/344/272/244/346/216/245//345/271/263/345/217/260-/346/213/233/345/225/206/345/261/200/351/233/206/345/233/242/346/231/272/350/203/275/344/275/216/347/240/201/345/274/200/345/217/221/345/271/263/345/217/260/350/277/220/347/273/264/346/211/213/345/206/214.md

@@ -0,0 +1,748 @@
+**招商局智能低码开发平台运维手册**
+
+模板修订历史
+
+|  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- |
+| **版本号** | **修订时间** | **修订说明** | **生效日期** | **作者** | **审核** | **批准** |
+| 1.0 | 2025/10/12 | 新建 | 2025/10/16 | 邬明俊 | 黄澄钰 |  |
+|  |  |  |  |  |  |  |
+|  |  |  |  |  |  |  |
+|  |  |  |  |  |  |  |
+|  |  |  |  |  |  |  |
+|  |  |  |  |  |  |  |
+
+**1. 前言**
+
+**1.1 概述**
+
+本文档描述了招商局智能低码平台日常运维手册，用于运维人员日常对平台进行维护工作指导。
+
+**1.2 读者对象**
+
+本文档主要适用于以下工程师：
+
+1. 软件安装工程师
+2. 技术支持工程师
+3. 运维工程师
+4. 研发工程师
+
+技术要求：
+
+1. 了解 K8s 中基本的 API 对象，如 namespace， node， pod，deployment，了解K8s api对象的增删改查命令。
+2. linux 常用命令，修改 host 的方法，文件解压命令，脚本执行命令，软件包下载安装命令。
+
+**2. 架构简介**
+
+**2.1基本架构**
+
+除了包含了提供的IaaS资源还包括平台依赖的PaaS和平台本身，如下图所示。运维技术栈主要围绕在Linux系统上的基础运维、Docker运维、K8s运维来进行的。
+
+
+|  |  |
+| --- | --- |
+| 命名空间 | 组件 |
+| low-code | 智能低码开发平台组件 |
+| skiff-platform | MongoDB、MySQL、MinIO |
+| elasticsearch | Elasticsearch |
+| ingress-nginx | Ingress-nginx |
+| loggie | 日志采集组件 |
+| monitoring | 监控组件 |
+| skiff-cicd | CICD |
+| skiff-harbor | Harbor |
+| ns-hz-ten-\* | CodeWave 租户制品应用空间 |
+
+**3. 平台日志的查看方法**
+
+**3.1智能低码开发平台组件**
+
+组件均位于low-code的namespace底下，通过kubectl get po -n low-code -owide获取所有低代码组件，如下图所示
+
+
+通过两种方式查看低代码日志
+
+1. kubectl logs -f <pod名称> -n low-code
+2. 登陆组件调度节点，进入目录/data/logs查看
+
+**3.2 制品/应用组件**
+
+制品/应用均位于ns-hz-ten-\*的namespace底下，\*为应用开发租户，默认为defaulttenant
+
+以下操作，以defaulttenant租户距离，通过kubectl get po -n ns-hz-ten-defaulttenant -owide获取所有制品组件，查看制品日志方法为kubectl get po -n ns-hz-ten-defaulttenant xxx，xxx为制品pod容器，其中带有dev的为开发环境pod，带有online的为生产环境pod
+
+**3.3 k8s**
+
+k8s组件均位于kube-system的namespace底下，通过kubectl get po -n kube-system -owide获取所有k8s组件，如下图所示
+
+
+通过以下方式查看低代码日志
+
+登陆master节点的服务器，进入/data/log/目录下进行日志查看，如下图所示
+
+
+目录解释
+
+1. <集群名称>-etcd：etcd相关日志
+2. <集群名称>-kubernetes：k8s核心组件相关日志
+3. docker：docker日志
+4. keepalived：keepalived日志
+5. kubelet：kubelet日志
+6. localstorage-<集群名称>：localstorage日志
+
+**3.4 中间件**
+
+中间件组件位于多个命名空间下，可以通过kubectl get po -A -owide | grep -v kube-system查看，如下图所示
+
+
+通过两种方式查看低代码日志
+
+1. kubectl logs -f <pod名称> -n <namespace>
+2. 登陆组件调度节点，进入目录/data/log查看
+
+**4. 组件运维**
+
+**4.1 Docker**
+
+服务运行管理
+
+systemctl status docker
+
+systemctl start docker
+
+systemctl stop docker
+
+systemctl restart docker
+
+配置文件管理
+
+# 系统服务启动配置：
+
+/usr/lib/systemd/system/docker.service
+
+# Docker服务配置：
+
+/etc/docker/daemon.json
+
+# 数据目录：
+
+/data/docker
+
+日志查看
+
+systemctl status docker
+
+journalctl -fu docker
+
+tail -f /data/log/docker/docker.log
+
+常用命令
+
+|  |  |  |  |
+| --- | --- | --- | --- |
+| 镜像命令 | 描述 | 容器命令 | 描述 |
+| docker images | 查看当前机器上存在的镜像 | docker logs | 查看容器日志信息 |
+| docker pull | 从镜像仓库下载镜像 | docker exec | 登录到运行中的容器 |
+| docker push | 上传镜像到镜像仓库 | docker inspect | 查看容器的描述信息 |
+| docker tag | 修改本地镜像的tag | docker cp | OS系统和容器之间的文件复制 |
+| docker save | 将镜像保存为本地tar文件 | docker login | 登录容器 |
+| docker load | 将本地tar文件加载为镜像 | docker start/stop/restart | 容器的启停管理 |
+| docker commit | 将容器提交为镜像 | docker top | 查看容器中运行的进程信息 |
+| docker rmi | 删除本地镜像 | docker rm | 删除容器 |
+| docker build | 使用dockerfile构建新镜像 | docker run | 启动容器 |
+| docker search | 在镜像仓库中查找docker镜像 | docker ps | 查看当前正在运行的容器 |
+| docker history | 查看指定镜像的创建历史 | docker stats | 实时查看容器的资源使用情况 |
+
+**4.2 K8s**
+
+常用命令
+
+|  |  |
+| --- | --- |
+| kubectl命令 | 描述 |
+| kubectl get node | 获取k8e集群节点信息 |
+| kubectl get namespace | 获取k8s集群的namespace信息 |
+| kubectl get <source> -n <namespace> | 查看特定namespace下的某个资源类型 |
+| kubectl describe <source> -n <namespace> <source-name> | 查看某个资源的详细信息 |
+| kubectl logs -f -n <namespace> <pod-name> | 查看pod的日志 |
+| kubectl exec -it -n <namespace> <pod-name> -c <dontainer-name> bash/sh | 进入到容器 |
+| kubectl  create/apply -f  <yaml> | 创建k8s资源 |
+| kubectl edit  <source>  -n <namespace> | 编辑k8s资源 |
+| kubectl delete po -n <namespace> <pod-name> | 删除某个namespace下pod，如果yaml文件存在podrestartPolicy: Always delete操作意味着pod的重启 |
+| kubectl --help | kubectl 命令帮助 |
+| systemctl start/status/stop/restart kubelet | kubelet 服务管理 |
+
+4.3 MySQL运维
+
+**4.3.1 单点部署**
+
+MySQL组件可通过以下命令查看
+
+kubectl get po -n skiff-platform -owide
+
+
+MySQL配置信息可通过以下命令查看
+
+kubectl -n skiff-platform describe cm mysql-poc-conf
+
+MySQL连接信息可通过以下命令查看
+
+kubectl -n low-code describe cm lcap-config | grep datasource
+
+4.4 MinIO运维
+
+MinIO组件可通过以下命令查看
+
+kubectl -n skiff-platform get pod | grep minio
+
+
+4.5 MongoDB运维
+
+MongoDB组件可通过以下命令查看
+
+kubectl -n skiff-platform get pod | grep mongo
+
+
+4.6 Elasticsearch运维
+
+#查看服务运行状态
+
+kubectl –n elasticsearch get pod –o wide |grep elasticsearch
+
+#查看服务运行日志
+
+kubectl –n elasticsearch logs –f <es-podid>
+
+#重启服务
+
+kubectl –n elasticsearch delete pod <es-podid>
+
+#查看ES集群状态
+
+curl -u "qzadmin:SKIFF@163qingzhou" -XGET 'http://common-elasticsearch-es-http.elasticsearch:9201/\_cat'
+
+**5. 常见的故障处理方法**
+
+**5.1 业务组件**
+
+1. 低代码平台创建应用失败
+
+应用创建失败有多种可能，事先查看应用日志定位问题
+
+首先通过以下命令找到 pod 名称
+
+kubectl get pod -n low-code
+
+然后通过以下命令将日志输出到本地文件
+
+kubectl exec -it lcap-xxxx-xxxx bash -n low-code
+
+在日志中搜索 Exception 日志，找到具体报错的原因
+
+cd /root/logs 查看具体的日志
+
+1. 低代码平台应用发布失败，显示实体已存在
+
+当多个应用复用同一个数据库时可能会发生此类问题。检查共有数据库的应用之间是否存在同名应用，存在的话就修改应用名称
+
+1. 应用预览发布超时，显示 pod 调度出错
+
+这个问题可能是 k8s pod 调度出了问题，实际原因需要先查看日志再确定
+
+进入到集群中，通过以下命令找到租户所在的命名空间
+
+kubectl get ns | grep {{租户名称}}
+
+假设对应命名空间为 ns-defaulttenant，通过以下命令查看实际的 pod 与 deploy
+
+kubectl get pod -n ns-defaulttenant | grep {{应用标识}}
+
+假设返回如下图所示
+
+
+通过以下命令查看这个 pod 发生的事件
+
+kubectl describe pod {{pod 名称}} -n ns-defaulttenant
+
+查看 Events 章节，如果发现访问镜像仓库超时的事件，则说明这个 pod 所在节点无法访问到镜像仓库。解决方案则为到实际的节点上添加镜像仓库的 host
+
+**5.2 K8s**
+
+1. kube-apiserver无法启动
+
+可能的原因：查看kubelet systemctl是否存在报错，centos7默认内核3.10的版本存在systemd BUG，会导致kubelet启动报错，无法正常拉起apiserver，通过如下命令恢复
+
+systemctl daemon-reexec
+
+1. kube-apiserver无法连接
+
+查看apiserver的运行状态，高可用环境apiserver三副本运行在三台master节点上，使用docker命令查看 组件状态docker ps -a| grep apiserver；
+
+查看apiserver组件日志 docker logs <apiserver-container-id>
+
+一般apiserver组件异常，是因为etcd状态异常（具体看报错日志）
+
+高可用环境需要检查 apiserver 的 Keepalive 的 vip是否存在三台master其中之一的节点上
+
+1. docker 无法执行
+
+查看docker服务是否启动 systemctl status docker
+
+尝试启动docker服务 systemctl start docker
+
+如果服务没启动查看docker日志journalctl -fu docker
+
+根据具体报错日志进一步排查原因
+
+1. 节点 not ready
+
+查看kubelet服务是否正常systemctl status kubelet
+
+查看kubelet服务的日志 less /data/log/kubelet/kubelet.ERROR（kubelet.INFO）
+
+查看节点not ready事件 kubectl describe node <node-name>
+
+启动kubelet服务systemctl start kubelet
+
+常见原因apiserver连接不上，kubelet服务宕机，磁盘不足等
+
+1. Pod 频繁重启
+
+kubectl get po –n <namespace> 返回的信息中RESTARTS列表示重启次数
+
+如果某一个组件重启比较频繁，通过命令 kubectl describe po -n skiff-platform <pod-name> 查看组件event事件和Last State上次重启原因
+
+常见重启原因组件自身OOM或者机器重启导致组件异常重启
+
+1. Pod 无法调度
+
+查看副本控制器 kubectl describe rs -n <namespace> <rs-name>或者kubectl describe deploy -n <namespace> <rs-name>
+
+查看pod无法调度原因 kubectl describe pod -n <namespace> <pod-name>
+
+有状态副本无法调度
+
+查看副本控制器 kubectl describe sts -n <namespace> <sts-name>
+
+查看pod无法调度原因 kubectl describe pod -n <namespace> <pod-name>
+
+**5.3 中间件**
+
+1. cicd反复重启
+
+修改cicd-web deploy资源initialDelaySeconds: **40s->120s**
+
+kubectl edit deploy cicd-web -n skiff-cicd
+
+修改所有的initialDelaySeconds为120
+
+1. mongodb
+
+Mongo集群没有primary但有secondary时连接不上且不能读数据
+
+#mongodb默认是从主节点读写数据的，副本节点上不允许读，需要设置副本节点可以读。
+
+repset:SECONDARY> db.getMongo().setSlaveOk();
+
+#要在primary上执行
+
+rs.slaveOk()
+
+其他客户端从secondary 读数据如果应用程序没有设置相应的ReadReference也可能不能进行读取操作
+
+MongoClientSettings set = new MongoClientSettings();
+
+List<MongoServerAddress> servers = new List<MongoServerAddress>();
+
+servers.Add(new MongoServerAddress("192.168.129.129", 37017));
+
+servers.Add(new MongoServerAddress("192.168.129.129", 37018));
+
+servers.Add(new MongoServerAddress("192.168.129.129", 37019));
+
+set.Servers = servers;
+
+//设置副本集名称set.ReplicaSetName = "rs0";//设置超时时间为3秒set.ConnectTimeout = new TimeSpan(0, 0, 0, 3, 0);
+
+MongoClient client = new MongoClient(set);
+
+MongoServer server = client.GetServer();
+
+MongoDatabase db = server.GetDatabase("test");
+
+MongoCollection coll = db.GetCollection("test");
+
+注：设置驱动的ReadReference也可以通过MongoDB连接字符串配置：
+
+mongodb://example1.com,example2.com,example3.com/?readPreference=secondary。
+
+通过连接字符串指定的read preference是针对整个连接。
+
+set.ReadPreference = new ReadPreference(ReadPreferenceMode.PrimaryPreferred);
+
+将ReadPreferenceMode设置成Secondary或SecondaryPreferred
+
+**6. 资源扩容方法**
+
+**6.1 横向扩容**
+
+即扩容node数量，使用sail的k8s部署脚本扩容，方法如下：
+
+1. 前置准备
+2. 修改部署工程下配置文件
+   1. 进入Master节点的部署工程目录，路径一般为：/data/skiff-deploy/xxxx
+   2. k8sctrl为k8s部署目录，使用对应工程目录添加节点
+   3. 修改k8sctrl/envs/hosts文件，需要新增的节点按正确格式（可参考备份文件）添加，其余节点类型信息全部清除或注释掉（尤其是[master]标签下的信息，重要！） 编辑后参考下图所示：新增node-user-1节点
+   4. 确保执行ansible命令的节点（一般是master节点）和新增的节点之间的免密ssh连接
+
+
+1. 给扩容节点扩展数据盘
+   1. 在扩容的节点上创建/data，挂载数据盘到/data目录（已做或不需要数据盘则跳过此步）。
+   2. 格式化盘和挂载参考命令，按实际服务器配置修改命令中的盘符。
+
+#可以远端使用ansible批量执行，注意此操作会格式化硬盘，属于高危操作。如下：/dev/vdx
+
+./tools/ansible/bin/python2.7 tools/ansible/bin/ansible -i envs/hosts all -m shell -a 'mkdir /data && mkfs.ext4 /dev/vdx && echo "UUID=$(blkid /dev/vdx -o value -s UUID) /data ext4 defaults 0 0" >> /etc/fstab && mount -a'
+
+1. 清理部署步骤记录文件
+   1. 部署工程会检测是否存在对应安装记录文件，存在则认为已安装组件会跳过安装，所以再次扩容需要理这些文件
+      1. 执行bash main.sh部署命令前删除/data/skiff-deploy/qingzhou/log/deploy/k8suser目录对应步骤记录文件，示例：rm init-disable-swap.yml~ init-iptables.yml~
+2. 修改部署脚本，**脚本路径：/data/skiff-deploy/qingzhou/k8suser/main.sh**
+
+#在main.sh的deploy\_k8suser()方法中只保留以下步骤
+
+run init-disable-swap.yml
+
+run init-remount-fs.yml
+
+run init-iptables.yml
+
+run init-ntpclient.yml
+
+run init-ulimit.yml
+
+run init-system.yml
+
+run init-hostname.yml
+
+#修改完成后执行脚本
+
+bash main.sh
+
+1. 部署过程
+2. 安装docker，kubelet和lxcfs
+
+#打开roles/kubelet/tasks/install\_by\_pkgs.yaml文件，注释掉kubeadm和kubectl的安装内容，
+
+#保留kubelet部分即可
+
+#在main.sh的deploy\_k8suser()方法中添加以下步骤
+
+run docker.yml
+
+run kubelet.yml
+
+run addon-lxcfs.yml
+
+#再次执行脚本
+
+bash main.sh
+
+1. 向集群添加节点
+
+#此步骤参考备份的hosts文件内容，打开k8suser/envs/hosts文件添加一条[master]节点信息或取消1.2.1步骤的对[master]的注释
+
+#在main.sh的deploy\_k8suser()方法中添加以下步骤
+
+run add-nodes-node.yml
+
+#再次执行脚本
+
+bash main.sh
+
+#执行完成后在对应集群查看节点是否Ready，一般等待1min左右会转为Ready状态
+
+kubectl get nodes
+
+1. 按需安装其他组件
+
+run addon-rbd.yml #ceph-rbd
+
+run addon-cephfs.yml #ceph-client
+
+run addon-localstorage.yml #本地存储，可用于pvc，需要挂载裸盘，需要在k8suser/envs/hosts中按格式添加对应配置（参考备份）
+
+**6.2 纵向扩容**
+
+扩容单个node节点的内存以及CPU即可
+
+**7. 组件重启方法**
+
+#方法1：直接delete pod名称
+
+kubectl delete po <pod名称> -n <命名空间>
+
+#方法2：使用各类资源自带的restart（推荐该方法，优雅轮流重启各个pod）
+
+kubectl rollout restart <资源类型（如deploy，sts）> <资源类型名称> -n <命名空间>
+
+#方法3：缩容再扩容
+
+kubectl scale --replicas=0 <资源类型（如deploy，sts）>/<资源类型名称> -n <命名空间>
+
+kubectl scale --replicas=<期望数量> <资源类型（如deploy，sts）>/<资源类型名称> -n <命名空间>
+
+**8. 安全巡检方法**
+
+**k8s**
+
+kubectl get node 查看node状态是否为ready
+
+kubectl get po -n lowcode 查看pod状态是否有crash
+
+**mysql**
+
+kubectl get pod -n skiff-platform
+
+**habor**
+
+docker pull 镜像名 查看能否正常拉取镜像
+
+**9. 配置相关**
+
+**mongo配置参数**
+
+net:
+
+bindIp: 0.0.0.0
+
+port: 27017
+
+replication:
+
+replSetName: 副本集名称，mongodb
+
+security:
+
+authorization: enabled
+
+keyFile: /var/lib/mongodb-mms-automation/authentication/keyfile
+
+setParameter:
+
+authenticationMechanisms: SCRAM-SHA-256
+
+storage:
+
+dbPath: 数据库数据目录，/data
+
+engine: 数据库引擎类型，wiredTiger
+
+wiredTiger:
+
+engineConfig:
+
+journalCompressor: 日志压缩算法，zlib
+
+eviction\_trigger: 当 cache used 超过 eviction\_trigger，用户线程也开始淘汰 CLEAN PAGE
+
+eviction\_target: 当 cache used 超过 eviction\_target，后台evict线程开始淘汰 CLEAN PAGE
+
+maxConns: 最大连接数，1200
+
+**制品应用源码配置信息**
+
+logging:
+
+file:
+
+path: 日志路径
+
+spring:
+
+mvc:
+
+static-path-pattern: 拦截路径
+
+resources:
+
+static-locations[0]: 前端资源路径，单体部署时静态资源存放在工程目录内
+
+main:
+
+lazy-initialization: 是否开启懒加载
+
+application:
+
+name: 应用名称
+
+id: 应用ID
+
+liquibase:
+
+enabled: 是否开启liquibase
+
+quartz:
+
+enabled: 定时任务框架是否开启
+
+devtools:
+
+restart:
+
+enabled: 是否开启热部署
+
+livereload:
+
+enabled: 是否自动重刷页面
+
+datasource:
+
+type: datasource类型
+
+driver-class-name: jdbc驱动
+
+url: 数据库链接
+
+username: 数据库用户名
+
+password: 数据库密码
+
+connection-timeout: 数据库链接超时时间
+
+hikari:
+
+poolName: 连接池名称(hikari)
+
+auto-commit: 事务是否自动提交
+
+data-source-properties:
+
+cachePrepStmts: true
+
+prepStmtCacheSize: 250
+
+prepStmtCacheSqlLimit: 2048
+
+useServerPrepStmts: true
+
+servlet:
+
+multipart:
+
+max-file-size: 请求最大文件大小
+
+max-request-size: 最大请求大小
+
+messages:
+
+basename: 展示信息的格式
+
+profiles:
+
+include: 加载其他property文件
+
+mybatis:
+
+mapper-locations: mapper路径
+
+configuration:
+
+database-id: 数据源类型
+
+default-enum-type-handler: 枚举处理器
+
+log-impl: 打印日志实现类
+
+server:
+
+port: 暴露端口
+
+compression:
+
+enabled: true
+
+mime-types: text/html,text/xml,text/plain,text/css, application/javascript, application/json
+
+min-response-size: 1024
+
+lcp:
+
+snowflakeNodeId: 雪花算法节点ID
+
+authCenter:
+
+enable: 权限中心是否启用
+
+address: 如果非下沉应用表示nuims地址，下沉应用该参数无效
+
+host: 如果非下沉应用表示nuims域名，下沉应用该参数无效
+
+flowUrl: 流程网关域名，该参数已经无效
+
+gatewayUrl: 网关地址，该参数已经无效
+
+audit:
+
+enable: 审计，该参数已经无效
+
+address: 审计地址，该参数已经无效
+
+uiResourceAddress: 前端client.js地址，导出源码默认已集成到工程中只需填写/client.js即可
+
+gatewayType: 网关类型
+
+upload:
+
+sinkType: 对象存储类型，支持s3、nos、local，默认s3
+
+sinkPath: 根路径
+
+s3Address: 对象存储域名
+
+s3AccessKey: 对象存储ak
+
+s3SecretKey: 对象存储sk
+
+s3Bucket: 对象存储bucket
+
+access: 文件上传默认的访问权限，默认public-无需鉴权即可访问；private-需要登录后才可访问
+
+ttl: -1.0 文件上传后过期时间。单位天，默认-1表示永不过期，
+
+logResponse: 是否打印响应
+
+logRequest: 是否打印请求
+
+returnExceptionStack: 是否返回堆栈
+
+quartzTables: {} 定时任务表映射，平台支持自定义定时任务表名
+
+report: 有数报表相关接口
+
+host: '' 有数地址
+
+tokenKey: '' 请求时必须的token
+
+domainId: null 域id
+
+projectId: null 项目id
+
+reportIdMap: {} 报表id
+
+componentIdMap: {} 组件id
+
+nuims: nuims地址
+
+gw:
+
+app:
+
+addr:
+
+lowcode: api集成, lowcode域名
+
+nuims: api集成, nuims域名
+
+auth:
+
+Normal: 权限配置