fogedge-charts

FogEdge 是一个边缘网关软件产品。

安装前准备

• 安装 kubernetes 1.19+
• 安装并设置 kubectl 1.19+
• 安装 helm 3+

获取chart

helm repo add fogedge-charts https://fogcloud-io.github.io/fogedge-charts
helm repo update
helm pull fogedge-charts/fogedge --untar

运行后在当前目录会生成fogedge-charts文件夹

安装chart

1. 拷贝fogedge-charts目录的values.yaml文件，并命名为myvalues.yaml
2. 编辑myvalues.yaml文件，参考配置说明
3. 安装fogedge-charts

export NAMESPACE_NAME=fogedge
export RELEASE_NAME=fogedge
kubectl create namespace ${NAMESPACE_NAME}
helm install -f myvalues.yaml ${RELEASE_NAME} -n ${NAMESPACE_NAME} ./fogedge

5. 升级fogedge-charts

helm upgrade -f myvalues.yaml ${RELEASE_NAME} -n ${NAMESPACE_NAME} ./fogedge 

卸载chart

helm uninstall ${RELEASE_NAME} -n ${NAMESPACE_NAME}

注意：默认启用了helm的资源保留，卸载时不会释放persistent volume资源；

配置说明

配置项	说明	默认值
imagePullPolicy	镜像拉取策略	Always
expose
expose.type	如何暴露服务：Ingress、ClusterIP、NodePort或LoadBalancer，其他值将被忽略，服务的创建将被跳过。	ClusterIP
expose.insecureOSS	不安全的oss下载	true
expose.hosts.api	api服务域名，用于前端服务访问后端api	localhost
expose.hosts.mqtt	mqtt服务域名，用于前端服务访问mqtt-websocket服务	localhost
expose.tls.enabled	是否启用HTTP接口 tls	false
expose.tls.cert.certSource	api服务证书的来源：auto或manual；1）auto：生成自签名证书；2）manual：手动设置证书	auto
expose.tls.cert.secretName	api服务所用证书对应的k8s secret资源名	fogedge-tls
expose.tls.cert.dnsName	当expose.tls.cert.certSource=auto时，用于生成x509证书	["fogcore", "mqtt-broker", "localhost"]
expose.tls.cert.ipTables	当expose.tls.cert.certSource=auto时，用于生成x509证书	["127.0.0.1"]
expose.tls.cert.ca	当expose.tls.cert.certSource=manual时可用，用于设置ca证书
expose.Ingress.className	ingress class资源名	traefik
expose.Ingress.controller	ingress controller类型	traefik.io/ingress-controller
expose.Ingress.annotations	ingress注释，可以用来设置ingress部分参数	{}
expose.Ingress.hosts.webAdmin	web服务域名，用于ingress路由	localhost
expose.Ingress.hosts.api	api服务域名，用于ingress路由	localhost
expose.NodePort
expose.NodePort.externalTrafficPolicy	流量策略：Cluster或Local；1）Cluster：流量可以转发到其他k8s节点的pod，2）Local：流量只转发给本机的pod	Local
expose.NodePort.ports.webAdmin.httpPort	web服务的NodePort端口，可用于外网暴露web服务	8888
expose.NodePort.ports.api.httpPort	api服务的NodePort端口，可用于外网暴露api服务	8000
expose.LoadBalancer
expose.LoadBalancer.externalTrafficPolicy	流量策略：Cluster或Local；1）Cluster：流量可以转发到其他k8s节点的pod，2）Local：流量只转发给本机的pod	Local
expose.LoadBalancer.ports.webAdmin.healthCheckNodePort	健康检查端口，用于外部slb检测web服务是否正常运行	8880
expose.LoadBalancer.ports.api.healthCheckNodePort	健康检查端口，用于外部slb检测api服务是否正常运行	8880
imagePullSecrets
imagePullSecrets	配置私有镜像仓库源
imagePullSecrets[].registry	私有镜像仓库地址	""
imagePullSecrets[].name	k8s dockerconfigjson secret名称	""
imagePullSecrets[].username	私有镜像仓库用户名	""
imagePullSecrets[].password	私有镜像仓库密码	""
storageClassName		local-path
fogcore	api服务相关配置
fogcore.restartPolicy	pod重启策略：Always	Always
fogcore.image	镜像地址	ghcr.io/fogcloud-io/fogcloud
fogcore.replicas	deployment复制节点数量	1
fogcore.strategy.type	应用更新策略：RollingUpdate，Recreate；1）RollingUpdate滚动更新；2）Recreate重启更新	RollingUpdate
fogcore.strategy.rollingUpdate.maxSurge	应用更新时最大新版本pod新增数量比例	25%
fogcore.strategy.rollingUpdate.maxUnavailable	应用更新时的最大不可用pod数量	25%
mqttBroker
mqttBroker.type	mqtt-broker类型：nanomq	nanomq
mqttBroker.image	mqtt-broker镜像	emqx/nanomq:0.18.2-slim
mqttBroker.persistence
mqttBroker.persistence.pvcExisted	是否使用已存在的pvc	false
mqttBroker.persistence.pvc	pvc名称	emqx-pvc
mqttBroker.persistence.storageClassName	pvc绑定的stogrageClassName	local-path
mqttBroker.nodeSelector.enabled	是否启用pod节点选择	false
mqttBroker.nodeSelector.key	k8s节点名
mqttBroker.tls.enabled	mqtt应用是否启用tls
mqttBroker.tls.createWithCertFile	是否使用证书文件创建mqtt应用的sercret对象，启用mqttBroker.internal.tls时有效；若为true，可将*.crt（证书）, *.key（密钥）文件放到fogcloud-charts/configs/cert/mqtt目录下