OperatorのインストールとEMQXのデプロイ

本セクションでは、EMQX Operatorの環境準備、Operatorのインストール、およびOperatorを使用したEMQXのデプロイ方法について説明します。以下の手順に従うことで、Operatorを使って効率的かつ安定的にEMQXをインストールおよび管理できます。

環境の準備

EMQX Operatorをデプロイする前に、以下のコンポーネントが準備されていることを確認してください。

• Kubernetesバージョン1.24以上が稼働しているKubernetes環境

• Kubernetesクラスターにアクセス可能なkubectlツール。kubectl cluster-infoコマンドでクラスターの状態を確認できます。

• Helm 3以上

EMQX Operatorのインストール

1. cert-managerをインストールして起動します。

   TIP

   cert-managerのバージョンは1.1.6以上が必要です。すでにcert-managerがインストールおよび起動している場合は、この手順をスキップしてください。

   Helmを使ってcert-managerをインストールできます。

   $ kubectl apply --server-side=true -f https://github.com/emqx/emqx-operator/releases/latest/download/install.yaml

   または、公式のcert-managerインストールガイドに従ってください。

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

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

Operatorが起動したら、EMQXのデプロイに進めます。

EMQXのデプロイ

1. 以下の内容をYAMLファイルとして保存し、kubectl applyでデプロイします。

   apiVersion: apps.emqx.io/v2
   kind: EMQX
   metadata:
      name: emqx
   spec:
     image: emqx/emqx:6.2.0
     config:
       data: |
         license {
           key = "..."
         }

   EMQX CRDの詳細については、リファレンスドキュメントをご参照ください。

2. EMQXクラスターが準備完了になるまで待ちます。

   $ kubectl get emqx
   NAME      STATUS    AGE
   emqx-ee   Ready     2m55s

   STATUSがReadyになっていることを確認してください。EMQXクラスターが準備完了になるまでには時間がかかる場合があります。

1. 以下の内容をYAMLファイルとして保存し、kubectl applyでデプロイします。

   apiVersion: apps.emqx.io/v2beta1
   kind: EMQX
   metadata:
      name: emqx
   spec:
      image: emqx/emqx:5.8.8

   EMQX CRDの詳細については、リファレンスドキュメントをご参照ください。

2. EMQXクラスターが準備完了になるまで待ちます。

   $ kubectl get emqx
   NAME      STATUS    AGE
   emqx      Ready     2m55s

   STATUSがReadyになっていることを確認してください。EMQXクラスターが準備完了になるまでには時間がかかる場合があります。内部で多くの処理が行われています。

トラブルシューティング

EMQX OperatorはKubernetes APIに対して限定的なイベントのみを公開しています。

パブリッククラウドへのデプロイ

EMQX Operatorを使用してマネージドKubernetesサービス上にEMQXをデプロイするには、以下のガイドをご利用ください。

• Amazon Elastic Kubernetes Service (EKS)
• Google Cloud GKE
• Azure Kubernetes Service (AKS)