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.

一键部署 EMQ X

编辑

KubeSphere 应用部署与管理

KubeSphere 是一个开源的以应用为中心的容器平台,基于自研的 OpenPitrix 构建了应用商店与应用的生命周期管理,并且在 v2.1 中提供了 3 种应用的快速部署方式:

  • 企业空间下的私有或公有的应用仓库
  • 平台全局的应用商店
  • 自制应用,即通过多个服务构建应用

KubeSphere 支持的应用是基于 Helm Chart 打包规范构建的,并通过统一的公有或私有的应用仓库交付使用,应用由一个或多个 Kubernetes 工作负载 (Workload) 和服务(Service)组成。

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

本文先介绍 KubeSphere 支持的 第一种方式,通过在企业空间导入第三方应用仓库,快速部署一个 EMQ X 集群至 Kubernetes,最终访问 EMQ X 的 Dashboard 服务,同时介绍 EMQ X 本身的特性与部署方式。

EMQ X 是什么

EMQ X 是一款完全开源,高度可伸缩,高可用的 分布式 MQTT 消息服务器,适用于 IoT、M2M 和移动应用程序,可处理 千万级别的并发客户端。EMQ X 面向海量的移动/物联网/车载等终端接入,并实现在 海量物理网设备间快速低延时的消息路由

前提条件

已开启安装了 KubeSphere 应用商店

部署简单的 EMQ X 集群

导入应用仓库

  1. 创建一个企业空间(Workspace),然后在该企业空间,进入 企业空间管理 → 应用仓库,点击 创建应用仓库

  1. 在添加应用仓库的窗口,URL 填入 https://repos.emqx.io/charts,验证通过后即可创建。

  1. 创建一个示例项目(Namespace),然后进入该项目中,在 应用负载 → 应用 下点击 部署新应用

  1. 此时即可看到 KubeSphere 支持的 3 种应用的快速部署方式,选择 应用仓库

  1. 点击查看 EMQ X 应用模板。

  1. 预览 EMQ X 的 Helm Chart 中的配置文件,然后选择 部署应用

编辑 Helm Chart

KubeSphere 支持可视化编辑 Helm Chart,在 Values.yaml 参考如下提示,将其中 3 处修改为指定的值:

提示:关于 EMQ X 的 Helm Chart 更详细的参数释义,请参考 EMQ X 的官方 EMQ X Chart

修改完成后点击 部署 即可将 EMQ X 集群部署至 Kubernetes。

查看 EMQ X 部署状态

应用详情

在应用列表中,可以看到 EMQ X 的应用状态,点击进入该应用,查看该应用的工作负载与服务的状态。

查看工作负载 → 有状态副本集

EMQ X 部署成功后,将部署 3 副本的有状态副本集(Statefulsets),当显示 运行中 (3/3) 时,说明应用部署成功。

查看有状态副本集详情

访问 EMQ X Dashboard 服务

  1. 应用负载 → 服务 页面,即可看到 EMQ X 对外暴露的 NodePort 以及端口映射情况,服务端口 18083 映射到节点的 NodePort (如 32688) 即 EMQ X Dashboard 能够在集群外访问到的端口。

  1. 使用 <$IP><$NodePort> 访问 EMQ X Dashboard 服务,使用默认帐密 admin/public 登录 Dashboard。

  1. 在首页的监控列表即可看到 EMQ X Broker 的系统信息,包括 3 Nodes 和 3 Stats 监控信息,状态显示 Running。

  1. EMQ X 的 3 个 Nodes IP 正好对应着 EMQ X Statefulsets 的 3 个 Pod IP。

部署持久化的 EMQ X 集群

EMQ X 通过创建 PVC 资源挂载 /opt/emqx/data/mnesia 目录实现持久化 Pods,在部署 EMQ X 之前,用户可以通过部署 HaproxyNginx-PLUS 等负载均衡器,然后在 Kubernetes 中创建 PV 或 StorageClass。

在 KubeSphere 部署一个持久化的 EMQ X 集群步骤与上述步骤类似,因此这里仅提示参数配置。在准备好负载均衡器后,只需要在可视化编辑 Helm Chart 的 Values.yaml 中指定 StorageClass 相关参数即可。

部署完成后,可以看到 emqx Service 的 ClusterIP 为 10.233.28.52 (以实际部署时为准)。将负载均衡监听的 URL 的 1883、8883、8080、8083、8084、18083 端口转发到 emqx Service 的 ClusterIP。

提示:如果有 TLS 连接的需要,推荐在负载均衡器终结 SSL 连接。客户端与负载均衡器之间 TLS 安全连接,负载均衡器与 EMQ X 之间普通 TCP 连接。

完成后使用 <$IP><$NodePort> 或集群内访问 <$ClusterIP>:<$Port> 即可访问持久化的 EMQ X 集群服务。

扩容 EMQ X 集群

KubeSphere 支持一键快速扩展 EMQ X 集群,进入 工作负载 → 有状态副本集,点击扩容的 Button 将 EMQ X 副本数扩容至 5。注意,EMQ X 的节点数量建议为 单数

一键进入容器终端

若在运维 EMQ X 集群的过程中,需要快速进入容器终端,可在 EMQ X 的有状态副本详情页找到其中一个 Pod,点击进入指定 Pod 下的容器中。

总结

本文介绍了 KubeSphere 支持的 第一种应用部署与管理方式,通过在企业空间导入了 EMQ X 应用仓库,并快速部署到了 Kubernetes。下一篇文章将主要介绍第二种方式 - 应用商店与应用的生命周期管理,演示如何使用开发者或 ISV 角色用户,将 Helm 应用的 上传提交、应用审核、测试部署、应用上架、应用升级、应用下架 作为一个完整的流程。