# 部署 EMQX Operator
在本文中,我们将指导您完成高效设置 EMQX Operator 环境、安装 EMQX Operator,然后使用它部署 EMQX 所需的步骤。通过遵循本节中概述的指南,您将能够使用 EMQX Operator 有效地安装和管理 EMQX。
# 准备环境
在部署 EMQX Operator 之前,请确认以下组件已经准备就绪:
一个正在运行的 Kubernetes 集群 (opens new window),关于 Kubernetes 的版本,请查看如何选择 Kubernetes 版本
一个可以访问 Kubernetes 集群的 kubectl (opens new window) 工具。您可以使用
kubectl cluster-info
命令检查 Kubernetes 集群的状态。Helm (opens new window) 3 或更高
# 安装 EMQX Operator
安装
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)来安装它。
运行以下命令来安装 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等待 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
将下面的 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 参考
等待 EMQX 集群就绪。
$ kubectl get emqxenterprises NAME STATUS AGE emqx-ee Running 8m33s
Copied!1
2
3
4
请确保 STATUS
为 Running
,这可能需要一些时间等待 EMQX 集群准备就绪。