Zero Cloud

• 第三方库基础环境安装参考链接
• 《Zero规范介绍》

1. 基本介绍

1.1. 序

    Zero Cloud是基于Zero Framework的云端版本，目前Zero框架的Extension部分功能已经可以支撑大部分企业级应用（在ITSM、CMDB、IOT、酒店管理、金融、医疗领域运行了9个生产环境的企业内部系统），在准备发布1.0.0 版本之前，我又重新基于云端进行了新的架构设计，准备打造云原生平台。

    早期开发Zero时有一个侵入式的微服务云端版本，但那个版本比较初级，当时就是基于K8S和Istio 最早的版本开发的，底层使用了etcd和gRpc，如今旧事重提，换一种云端思路来打造新的云原生生态，于是有了Zero Cloud。

    该项目目前没有核心代码，核心代码会收录在vertx-zero/vertx-istio 子项目中，当前项目主要提供云端架构的指导规范、概念定义、设计思路、自动化脚本以及云端项目脚手架，并通过自动化或半自动化模式使完整生态落地。

1.2. 结构（概念版）

Zero Cloud的基础系统设计并没有完全按照云原生十二要素进行，由于K8S和Istio已经提供了底层大部分基础设施功能，所以Zero Cloud将所有精力集中于应用层，根据部署运维的视角，其实客户本身的应用系统是一个平行四边形结构。

2. 目录说明

2.1. vertx-zero-cloud

    对vertx-zero-cloud而言，xxx-cloud系统平台是单独的一个app，而xxx-cloud其本身是一个** 多租户、多语言、多应用的环境，至于结构图中的多环境、多区域**和部署应用没有直接关系，大部分是在底层K8S这一级实现分离。

2.2. xxx-cloud

    无须手工创建，直接设置环境变量后运行初始化脚本即可，xxx-cloud自带分类配置：

• K8S环境配置：用于描述该平台发布到哪种K8S环境中（五选一）
• 应用语言配置：用于描述该平台使用哪种语言优先（三选一）

2.3. 设计理念

• xxx-cloud必须实现自动化运维、管理、更新以及不下线。
• vertx-zero-cloud属于xxx-cloud的中枢神经系统，它提供了整个平台环境的专有规范，更新时自动分发出厂设置 给每一个xxx-cloud。
• xxx-cloud本身的Github库中记录了所有版本变更，配置层用于协调生产、开发、测试环境的无缝切换。
• 二者协同实现双平台架构，上游平台和下游平台各司其职，上游平台负责开发、运维、监控、管理以及命令和事件的分发，下游平台负责应用变更、需求适配。

3. 系统规范

3.1. K8S环境类型

    Zero Cloud中定义了K8S的运行环境，位于目录environment中，而每一个xxx-cloud 只能选择一种，之中所包含的脚本和相关部署工具都相互独立、相互隔离，其核心环境如下（只有两个可以上生产）：

3.2. 组件环境

    K8S的每个目录会包含各种功能型组件的核心目录，其支持功能是横向的，所有xxx-cloud 都可以选择启用或禁用。etcd是K8S自带，所以此处不考虑etcd的启动和部署脚本，以下环境是目前可以直接和zero执行集成的核心环境，大部分内容zero-framework中已提供了集成客户端以及相关代码。

4. 应用规范

4.1. 语言分类

4.2. 环境分类

1. kzero为静态环境，环境中不包含相关配置，云端部署和发布时，会直接以此目录中的所有配置信息为基版本。
2. kidd/kinect为运行环境，其中会包含整套配置信息，基于平台目录相关配置都存储于该目录中。

4.3. 配置文件

4.4. 应用配置目录

5. 整体拓扑

以最新版为准，该图是老版本，后续定型后重新更新。

6. 应用初始化

6.1. 环境变量

    环境变量命名规范如下：

• ZK打头，全称Zero Kernel，容器相关的环境变量。
• ZA打头，全称Zero Aeon，永世系统核心驱动层组件专用。
• ZC打头，全称Zero Component，每个应用专有的环境变量。

    环境变量如：

6.2. 初始化步骤

1. 创建一个Maven的空项目，并链接到您的Git私库中。

2. 从vertx-zero/vertx-istio/scaffold中下载核心文件到项目根目录。

   .env.development            # 开发环境文件
   k-app.sh                    # 初始化环境融合脚本
   k-init.sh                   # 初始化环境脚本

3. 修改.env.development环境变量。

4. 运行k-app.sh自动执行当前项目初始化。

6.3. 基本环境要求

7. 运行说明

7.1. 脚本命名规范

• minikube-：基本环境启动脚本（包括dashboard）。
• istio-：Istio环境安装脚本。
• zo-（Zero Deployment to K8S）脚本：发布组件到K8S的专用脚本。
• zp-（Zero Purge from K8S）脚本：从K8S清除当前组件专用脚本。
• zq-（Zero Query）脚本：查询组件状态专用脚本。
• 如果该脚本需开放或启动某个端口号，则以端口号名称为文件前缀，如：
  • 1201-istioctl-kiali.sh
  • 1231-minicube-dashboard.sh

7.2. 默认端口

• 1231：Dashboard主端口号。
• 1201 ~ 1299：辅助工具主端口号。
• Random：以组件标准为主，如TiDB是4000，程序消费专用端口号。