一、安装

目前支持如下安装方式

安装方式	说明	适用场景
All in One 一键安装模式	在单台云主机或虚拟机安装	不推荐生产使用
基于现有 Kubernetes 安装	在现有 Kubernetes 集群上安装	可生产使用
基于 Helm 命令安装	使用 Helm 命令在现有 Kubernetes 集群上安装	可生产使用

1.1、All in One

注意
All in One 模式在单台云主机或者虚拟机上安装渠成平台，适合初次接触 渠成平台 并想快速上手的用户，不推荐生产使用。
推荐Debian 11(Bullseye) 4核/8G/40GB硬盘体验比较好

具体可以参考快速安装

1.1.1 q init高级操作

这里列出常用的一些参数来帮助安装自定义的集群

      --domain string            平台应用默认分配的域名，例如qucheng.example, 需要将*.qucheng.example解析到当前节点，不指定我们会默认分配一个域名
      --podsubnet string         pod subnet (default "10.42.0.0/16")
      --san stringArray          用于签发自定义域名k8s证书, 无特殊场景可以不设置
      --svcsubnet string         service subnet (default "10.43.0.0/16")

1.2、基于现有 Kubernetes 安装

步骤同All in One模式，安装过程中会自动识别当前机器是否有可用集群，如果有则执行在已有集群安装渠成平台

1.3、基于helm命令安装

使用 Helm 命令在现有 Kubernetes 集群上安装 渠成平台。适合对 Helm 有一定了解的用户。

1.3.1 前置条件

安装 Helm v3.5+，这是一个简单的命令行工具，可以从此处获取。
推荐Kubernetes 集群版本：v1.20~v1.23

1.3.2 执行安装

# 创建 Namespace
kubectl create ns cne-system
# 添加渠成官方Chart仓库
helm repo add qucheng-stable https://hub.qucheng.com/chartrepo/stable
# 更新chart仓库
helm repo update
# 安装平台控制器
helm upgrade -i cne-operator qucheng-stable/cne-operator -n cne-system
# 安装平台
helm upgrade -i qucheng qucheng-stable/qucheng -n cne-system --set ingress.host=<自定义域名> --set env.APP_DOMAIN=<泛域名>
# 安装完成访问自定义域名即可

二、升级

2.1 命令行升级

查看当前是否有最新版本q version

示例如下:

 ~  q version
Client:
 Version:           1.0.5
 Go version:        go1.18
 Git commit:        94ff7df
 Built:             2022-07-06 17:26:35
 OS/Arch:           linux/amd64
 Experimental:      true
Server:
 qucheng:
  AppVersion:       1.0.2 --> 1.1.0
  ChartVersion:     0.3.0 --> 1.1.0
  Note:              Now you can use q manage upgrade to upgrade qucheng to the latest version

执行 q manage upgrade

示例如下:

 ~  q manage upgrade                                                                                                                
[info]   check update...
[done] √ upgrade qucheng success
[info]   cleanup deprecated resources
[info]   patch new resources
[info]   start deploy operator plugins: cne-operator
[info]   install cne-operator plugin: cne-operator
[done] √ upgrade install cne-operator plugin cne-operator done
 ~  q version            
Client:
 Version:           1.0.5
 Go version:        go1.18
 Git commit:        94ff7df
 Built:             2022-07-06 17:26:35
 OS/Arch:           linux/amd64
 Experimental:      true
Server:
 qucheng:
  AppVersion:       1.1.0
  ChartVersion:     1.1.0

不同版本下，显示升级日志可能不太一致，已升级显示为准。

2.2 图形化升级

渠成平台1.1.0版本及之后版本支持，在管理后台操作渠成平台升级。

2.3 helm安装方式升级

同helm安装升级即可。

三、卸载平台

3.1 q命令卸载

q uninstall

3.2 helm命令卸载

helm delete qucheng -n cne-system
helm delete cne-operator -n cne-system