# 部署 EMQX Operator

在本文中,我们将指导您完成高效设置 EMQX Operator 环境、安装 EMQX Operator,然后使用它部署 EMQX 所需的步骤。通过遵循本节中概述的指南,您将能够使用 EMQX Operator 有效地安装和管理 EMQX。

# 准备环境

在部署 EMQX Operator 之前,请确认以下组件已经准备就绪:

# 安装 EMQX Operator

  1. 安装 cert-manger

    提示

    需要 cert-manager 版本 1.1.6 或更高。如果 cert-manager 已经安装并启动,请跳过此步骤。

    你可以使用 Helm 来安装 cert-manager

    $ helm repo add jetstack https://charts.jetstack.io
    $ helm repo update
    $ helm upgrade --install cert-manager jetstack/cert-manager \
      --namespace cert-manager \
      --create-namespace \
      --set installCRDs=true
    
    Copied!
    1
    2
    3
    4
    5
    6

    或者按照 cert-manager 安装指南 (opens new window)来安装它。

  2. 运行以下命令来安装 EMQX Operator。

    $ helm repo add emqx https://repos.emqx.io/charts
    $ helm repo update
    $ helm upgrade --install emqx-operator emqx/emqx-operator \
      --namespace emqx-operator-system \
      --create-namespace
    
    Copied!
    1
    2
    3
    4
    5
  3. 等待 EMQX Operator 就绪。

    $ kubectl wait --for=condition=Ready pods -l "control-plane=controller-manager" -n emqx-operator-system
    
    pod/emqx-operator-controller-manager-57bd7b8bd4-h2mcr condition met
    
    Copied!
    1
    2
    3

现在你已经成功的安装 EMQX Operator,你可以继续下一步了。在部署 EMQX 部分中,您将学习如何使用 EMQX Operator 来部署 EMQX。

# 部署 EMQX

  1. 将下面的 YAML 配置文件保存为 emqx.yaml

     apiVersion: apps.emqx.io/v1beta4
     kind: EmqxEnterprise
     metadata:
        name: emqx-ee
     spec:
        template:
          spec:
            emqxContainer:
              image:
                repository: emqx/emqx-ee
                version: 4.4.15
     EOF
    EOF
    
    Copied!
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13

    并使用 kubectl apply 命令来部署 EMQX。

    $ kubectl apply -f emqx.yaml
    
    Copied!
    1

    关于 EMQX 自定义资源的更多信息,请查看 API 参考

  2. 等待 EMQX 集群就绪。

    $ kubectl get emqxenterprises
    
    NAME      STATUS   AGE
    emqx-ee   Running  8m33s
    
    Copied!
    1
    2
    3
    4

请确保 STATUSRunning,这可能需要一些时间等待 EMQX 集群准备就绪。