# 在腾讯云上部署 EMQX 集群

EMQX Operator 支持在腾讯云容器服务(Tencent Kubernetes Engine,TKE)部署 EMQX。腾讯云容器服务基于原生 kubernetes 提供以容器为核心的、高度可扩展的高性能容器管理服务。腾讯云容器服务完全兼容原生 kubernetes API,为容器化的应用提供高效部署、资源调度、服务发现和动态伸缩等一系列完整功能,解决用户开发、测试及运维过程的环境一致性问题,提高了大规模容器集群管理的便捷性,帮助用户降低成本,提高效率。容器服务会对不同规格的托管集群收取相应的集群管理费用。在使用中创建的其他的云产品资源(CVM、CBS、CLB 等),将按照各自云产品的计费方式进行收费

# 前提条件

在开始之前,你需要准备以下内容:

# 快速部署一个 EMQX 集群

下面是 EMQX 自定义资源的相关配置。你可以根据你想部署的 EMQX 版本选择相应的 APIVersion。关于具体的兼容性关系,请参考 EMQX 与 EMQX Operator 的兼容性列表

  • 将下面的内容保存成 YAML 文件,并通过 kubectl apply 命令部署它

    apiVersion: apps.emqx.io/v1beta4
    kind: EmqxEnterprise
    metadata:
      name: emqx-ee
    spec:
       ## EMQX 自定义资源不支持在运行时更新这个字段
      persistent:
        metadata:
          name: emqx-ee
        spec:
          ## 更多内容:https://cloud.tencent.com/document/product/457/44239
          storageClassName: cbs
          resources:
            requests:
              ## 腾讯云 TKE 要求云硬盘大小必须为 10 的倍数,默认提供的 cbs(高性能云盘) 要求硬盘最小为 10GB,更多内容请参考:https://cloud.tencent.com/document/product/457/44239
              storage: 10Gi
          accessModes:
            - ReadWriteOnce
      template:
        spec:
          emqxContainer:
            image:
              repository: emqx/emqx-ee
              version: 4.4.14
      serviceTemplate:
        metadata:
          annotations:
            # 自动创建 tke-service-config,更多内容请参考:https://cloud.tencent.com/document/product/457/45490
            service.cloud.tencent.com/tke-service-config-auto: "true"
        spec:
          type: LoadBalancer
    
    Copied!
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
  • 等待 EMQX 集群就绪,可以通过 kubectl get 命令查看 EMQX 集群的状态,请确保 STATUSRunning,这个可能需要一些时间

    $ kubectl get emqxenterprises
    NAME      STATUS   AGE
    emqx-ee   Running  8m33s
    
    Copied!
    1
    2
    3
  • 获取 EMQX 集群的 External IP,访问 EMQX 控制台

    $ kubectl get svc emqx-ee -o json | jq '.status.loadBalancer.ingress[0].ip'
    
    198.18.3.10
    
    Copied!
    1
    2
    3

    通过浏览器访问 http://198.18.3.10:18083 ,使用默认的用户名和密码 admin/public 登录 EMQX 控制台。

# 使用 MQTT X CLI 连接 EMQX 集群发布/订阅消息

MQTT X CLI (opens new window) 是一款开源的 MQTT 5.0 命令行客户端工具,旨在帮助开发者在不需要使用图形化界面的基础上,也能更快的开发和调试 MQTT 服务与应用。

  • 获取 EMQX 集群的 External IP

    external_ip=$(kubectl get svc emqx-ee -o json | jq '.status.loadBalancer.ingress[0].ip')
    
    Copied!
    1
  • 订阅消息

    $ mqttx sub -t 'hello' -h ${external_ip} -p 1883
    
    [10:00:25] › …  Connecting...
    [10:00:25] › ✔  Connected
    [10:00:25] › …  Subscribing to hello...
    [10:00:25] › ✔  Subscribed to hello
    
    Copied!
    1
    2
    3
    4
    5
    6
  • 创建一个新的终端窗口并发布消息

    $ mqttx pub -t 'hello' -h ${external_ip} -p 1883 -m 'hello world'
    
    [10:00:58] › …  Connecting...
    [10:00:58] › ✔  Connected
    [10:00:58] › …  Message Publishing...
    [10:00:58] › ✔  Message published
    
    Copied!
    1
    2
    3
    4
    5
    6
  • 查看订阅终端窗口收到的消息

    [10:00:58] › payload: hello world
    
    Copied!
    1

# 关于 LoadBalancer 终结 TLS

目前腾讯云 CLB 不支持终结 TLS ,如需要使用 LoadBalancer 终结 TLS 请参考终结 TLS (opens new window)