v2.1
v2.0
v1.0
  1. Release Notes
    1. Release Notes - 2.1.1最新
    1. Release Notes - 2.1.0
    1. Release Notes - 2.0.2
    1. Release Notes - 2.0.1
    1. Release Notes - 2.0.0
  1. 产品介绍
    1. 什么是 KubeSphere
    1. 平台功能
    1. 为什么选择 KubeSphere
    1. 架构说明
    1. 应用场景
    1. 名词解释
  1. 安装指南
    1. 安装说明
      1. 概览
      2. 网络防火墙配置
      3. 集群其它参数配置
    1. 在 Linux 快速安装 KubeSphere
      1. All-in-One 模式
      2. Multi-Node 模式
      3. 完整安装(开启所有功能组件)
    1. 在 Kubernetes 安装 KubeSphere
      1. 准备工作
      2. 在 Kubernetes 安装 KubeSphere
    1. 安装可插拔的功能组件
      1. 可插拔功能组件概览
      2. 安装应用商店
      3. 安装内置的 DevOps 系统
      4. 安装内置的日志系统
      5. 安装微服务治理组件(Service Mesh)
      6. 安装告警通知系统
      7. 安装 Metrics-server 开启 HPA
      8. 验证可插拔功能组件的安装
    1. 集群高可用配置安装
      1. 在青云安装 HA 集群
      2. 在华为云安装 HA 集群
      3. 持久化存储配置说明
    1. 相关工具与插件
      1. 安装内置 Grafana
      2. 访问 SonarQube 和 Jenkins 服务端
      3. 安装 Porter 负载均衡器插件
      4. 安装 QingCloud 负载均衡器插件
    1. 认证配置
      1. 接入 LDAP / AD 域账号(Beta)
    1. 集群运维
      1. 安装后添加新的存储类型
      2. 集群节点扩容
      3. 卸载
  1. 升级指南
    1. 升级必读
    1. All-in-One 升级
    1. Multi-node 升级
  1. 快速入门
    1. 入门必读
    1. 1. 多租户管理快速入门
    1. 2. 应用路由与服务示例
    1. 3. 创建 Wordpress 应用并发布至 K8s
    1. 4. 一键部署应用
    1. 5. 创建简单任务
    1. 6. 设置弹性伸缩 (HPA)
    1. 7. Source-to-Image
    1. 8. Binary-to-Image
    1. 9. 基于Spring Boot项目构建流水线
    1. 10. 图形化构建流水线
    1. 11. Bookinfo 微服务的灰度发布
    1. 12. 使用 Ingress-Nginx 进行灰度发布
    1. 13. 应用商店
  1. 管理员指南
    1. 多租户管理
      1. 多租户管理概述
      2. 角色权限概览
    1. 平台管理
      1. 企业空间管理
      2. 账号管理
      3. 平台角色
    1. 基础设施
      1. 服务组件
      2. 主机管理
      3. 存储类型
    1. 监控中心
      1. 监控概述
      2. 如何利用监控定位问题
      3. 集群状态监控
      4. 应用资源监控
      5. 监控策略 - 节点级别
      6. 监控消息 - 节点级别
    1. 平台设置
      1. 应用仓库
      2. 基于本地仓库搭建应用仓库部署Redis
      3. 上传应用到 KubeSphere 官方仓库
      4. 基于 GitHub 搭建自有应用仓库
      5. 邮件服务器
      6. 日志收集
      7. 添加 Fluentd 作为日志接收者
      8. 添加 Kafka 作为日志接收者
    1. 工具箱
      1. Web Kubectl
      2. 日志收集
    1. DevOps 配置
      1. 系统配置修改
      2. 上传镜像至 Harbor
      3. 流水线配置邮件服务器
      4. Jenkins 系统设置
    1. FAQ
      1. DevOps 运维FAQ
  1. 用户指南
    1. 应用
      1. 应用模板
      2. 自制应用
      3. 流量治理
      4. 熔断
    1. 工作负载
      1. 工作负载概述
      2. 部署
      3. 有状态副本集
      4. 守护进程集
      5. 任务
      6. 定时任务
      7. 设置健康检查器
      8. 工作负载管理
      9. 落盘日志收集
    1. 存储
      1. 存储概述
      2. 存储卷
      3. Local Volume 使用方法
    1. 网络与服务
      1. 服务管理
      2. 灰度发布
      3. 应用路由
    1. 监控告警
      1. 告警策略 - 工作负载级别
      2. 告警消息 - 工作负载级别
    1. 配置中心
      1. 密钥
      2. 配置
      3. 镜像仓库
    1. 项目设置
      1. 基本信息
      2. 成员角色
      3. 项目成员
      4. 外网访问
    1. DevOps 工程
      1. DevOps 工程概述
      2. 管理 DevOps 工程
      3. 流水线
      4. 凭证管理
      5. 添加代码仓库
      6. 访问 SonarQube 并创建 Token
      7. 设置自动触发扫描
      8. Jenkins Agent 说明
      9. 流水线常见问题
  1. 开发者指南
    1. Helm 应用开发
      1. 开发模板规范
      2. Helm 应用开发入门
    1. Source to Image(S2I) 自定义模版开发
      1. S2I 原理及流程介绍
      2. 自定义 S2I 模版
  1. API 文档
    1. API 文档
    1. 如何调用 API
    1. API 常用术语对照
    1. 监控指标说明
  1. 常见问题
    1. 安装常见问题
    1. 存储常见问题
    1. 控制台使用常见问题
    1. DevOps 常见问题
  1. 附录
    1. 部署 Ceph 存储服务端
    1. 部署 GlusterFS 存储服务端
    1. 安装 OpenEBS 创建 LocalPV 存储类型
    1. 云平台配置端口转发和防火墙
KubeSphere®️ 2020 All Rights Reserved.

应用商店

编辑

KubeSphere 基于开源项目 OpenPitrix 构建了应用商店与应用的生命周期管理,并且在 v2.1 中提供了 3 种应用的快速部署方式:

  • 平台全局的应用商店,提供给所有用户访问和快速部署,支持应用的生命周期管理
  • 应用模板,来自企业空间下的由 ISV 上传的应用,或导入的私有或公有的 Helm 应用仓库
  • 自制应用,即通过资源编排的方式将多个微服务快速构建成一个完整的应用

KubeSphere 应用商店 对内可作为团队间共享企业内部的中间件、大数据、业务应用等,以应用模板的形式方便用户快速地一键部署常用的应用到 Kubernetes 中;对外可作为根据行业特性构建行业交付标准、交付流程和交付路径的基础,作为行业通用的应用商店,可根据不同需求应对不同的业务场景。

本文将介绍 KubeSphere 支持的 第一种方式应用商店与应用的生命周期管理,使用物联网应用 EMQ X 作为示例应用,演示应用的 上传提交、应用审核、测试部署、应用上架、应用升级、应用下架 这样一个完整的业务流程。

前提条件

  • 已安装了 OpenPitrix(应用商店)功能组件
  • 已创建了企业空间和项目(可参考 管理员快速入门 创建)

示例视频

创建自定义角色与账号

  1. 参考 管理员快速入门,分别创建一个 workspace-admin (作为 ISV) 和一个 reviewer (作为技术审核,自定义的角色) 的账号,这两个账号在集群层级授予 cluster-regular 权限。

提示:自定义的技术审核角色,需要在 平台角色 下新建一个 app-review 的角色,权限仅勾选 应用管理,然后基于该角色创建一个 reviewer 的账号。

  1. 使用 admin 账号将以上新建的两个账号 (ISV 和 reviewer),邀请至已创建的企业空间和项目中,并授予 workspace-admin 权限。

上传应用提交审核

  1. 切换至 ISV 账号 workspace-admin 登录,进入企业空间下,准备上传一个示例应用并提交审核。请下载 EMQ X chart v1.0.0 打包好的第一个版本 Chart,用于 初次提交审核

提示:目前版本由于上传应用的权限仅开放给了 workspace-admin 角色,因此项目下的应用开发者需线下将打包好的 Helm 应用包传递给 ISV,由 ISV 上传应用至企业空间下的应用模板。v3.0 计划将应用上传与发布的权限开放给开发者,对权限进行更精细化的控制,将开发者从应用提交审核到应用上架设计成一个闭环。

  1. 在示例企业空间 demo-workspace 下,选择 应用模板 → 上传模板

  2. 点击 开始上传,然后将 emqx-v1.0.0.tgz 上传至平台。

  1. 点击确定,然后上传 EMQ X 应用图标,点击下载 EMQ X 应用图标。完成后,应用已成功上传到了企业空间下的应用模板,此时应用状态为 开发中

提示:应用模板上传后,此时该应用已对当前企业空间下的所有用户可见,意味着企业空间下的所有用户都可以通过应用模板一键部署该应用至指定的项目中。

  1. 在列表中点击进入 EMQ X 应用,点击左侧的 编辑信息,完善应用的介绍、应用截图,点击下载 应用截图

  1. 当应用的基本信息完善后,点击展开待提交的应用,ISV 可以对该应用进行 测试部署

  1. 点击 测试部署,注意,在参数配置的代码中,需要修改 namespace 的值为 您实际的项目名称,修改再点击 部署

大概几分钟后,在 部署实例 Tab 下,可以看到测试部署的应用当前运行状态,显示绿色即表示应用被成功部署至 Kubernetes。

提示:可进一步点击测试部署的 EMQ X 应用实例,进入服务详情页,查看 EMQ X dashboard 的服务地址并进一步访问该 dashboard,详细可参考 一键部署 EMQ X

  1. 点击 提交审核,确认应用已经通过了基本功能的测试,下一步在更新日志中可以按需编辑当前应用版本的版本号和更新日志。点击 确定 完成应用的提交审核。

应用审核进度为等待审核

审核应用

  1. 切换 reviewer 账号登录 KubeSphere,进入 平台管理应用管理,选择 应用审核,可以看到 待处理 一栏已收到了 ISV 提交审核的 EMQ X 应用。

  1. 点击应用,reviewer 可以从 应用信息、介绍、配置文件、更新日志 等四个维度去审核该应用是否符合应用开发规范以及应用上架的条件。若信息符合应用上架标准即可通过审核。

  1. reviewer 可以在 应用分类 下根据业务需要,创建多个应用类型,应用分类最终将作为标签,为应用商店筛选不同类型的应用,例如 大数据、消息队列、中间件。如下,点击 + 创建一个 物联网 的应用分类。

应用上架

  1. 切换 ISV 账号登录,进入企业空间下找到提交审核的 EMQ X 应用,在该应用的详情页即可看到 发布至应用商店 的选项,点击 发布至应用商店,然后点击 确定,应用将上架到应用商店。

  1. EMQ X 应用的状态为 已上架,意味着平台的所有用户都可以访问和部署该应用至 Kubernetes。点击 在商店查看 跳转至应用商店。

  1. 在应用商店的 物联网 分类下,即可看到已上架的 EMQ X。

  1. 点击应用可进一步查看应用详情,并且可以通过 project-reguar 角色(项目普通用户)访问和部署该应用。

添加新版本

KubeSphere 支持对已上架的应用发布新的版本,方便用户进行升级。继续使用 ISV 账号,在应用模板中进入 EMQ X 应用详情页,在右侧点击 添加版本,然后上传示例应用 EMQ X 的新版本,点击下载 EMQ X v4.0.2

添加新版本后,应用新版本的审核与上架流程与上述步骤类似,本文不作赘述。

查看新版本

待应用的新版本通过 reviewer 审核后,即可在应用商店访问 EMQ X 应用的新版本。