雲進入以「應用為中心」的雲原生階段，Operator 模式的出現，則為 Kubernetes 中的自動化任務建立配置與管理提供了一套行之有效的標準規範。透過將運維知識固化成高階語言 Go/Java 程式碼，使得運維知識可以像普通軟體一樣交付，並能支援高可靠、具備高階運維能力的有狀態應用批次交付。

針對大規模分散式物聯網 MQTT 訊息伺服器 EMQX 全生命期管理的自動化管理工具 [EMQX Kubernetes Operator](https://www.emqx.com/zh/emqx-kubernetes-operator)（本文中簡稱 EMQX Operator）應運而生。它作為 Kubernetes 上的自定義控制器執行，並與 Kubernetes API 伺服器（kube-apiserver）進行通訊，將高層描述轉換為正常的 Kubernetes 資源，以保持所需的應用程式狀態。

EMQX Operator 使 EMQX 的部署、調優和運維變成一種低成本、標準化、可重複性的能力，幫助使用者高效實現叢集擴容、無縫升級、故障處理和統一監控。
[![1](http://img.blog.itpub.net/blog/2022/10/21/eea1db421dd80334.png?x-oss-process=style/bb "1")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "1")

本文章將以 [EMQX 企業版](https://www.emqx.com/zh/products/emqx)為例，詳細講解如何使用 EMQX Operator 在 AWS EKS 上建立部署 MQTT 服務叢集，並實現自動化管理與監控。

## 雲平臺簡介: AWS EKS

Amazon Elastic Kubernetes Service(Amazon EKS)是 AWS 的 Kubernetes 託管服務，您可以使用它來在AWS 上執行 Kubernetes，而無需安裝、操作和維護您自己的 Kubernetes 控制平面或節點。

### 建立 EKS 服務

使用 EKS 服務，需透過以下兩個步驟進行建立。

#### 建立 EKS 叢集

登入 EKS 控制檯， 點選新增叢集。由於 EMQX Operator 要求 Kubernetes 版本 >= 1.20, 因此在進行叢集配置時，Kubernetes 版本大於 1.20 即可。其他角色、許可權、子網、VPC 等可根據需求新增。
[![2](http://img.blog.itpub.net/blog/2022/10/21/467ff3ec99b08ec3.png?x-oss-process=style/bb "2")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "2")
[![3](http://img.blog.itpub.net/blog/2022/10/21/8eb3f785fe55ce86.png?x-oss-process=style/bb "3")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "3")
#### 新增節點組與節點

叢集建立成功後，進入叢集詳細頁面，點選計算，選擇新增節點組。
[![4](http://img.blog.itpub.net/blog/2022/10/21/e57c31aa7262c4d2.png?x-oss-process=style/bb "4")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "4")
[![5](http://img.blog.itpub.net/blog/2022/10/21/8bad25d9b2cd019a.png?x-oss-process=style/bb "5")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "5")
[![6](http://img.blog.itpub.net/blog/2022/10/21/bd96e7f76e041f95.png?x-oss-process=style/bb "6")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "6")

此處的例項型別根據業務需求自行調整，本文為示例選擇了較小的例項規格。

## 訪問 Kubernetes 叢集

建立 kubeconfig 檔案，可使用 aws cli 來生成。初次使用，根據提示進行相關配置，如許可權、區域等，配置好後透過如下命令生成 kubeconfig 檔案。

```css
aws eks update-kubeconfig --region region-code --name my-cluster
```

注：區域與叢集名稱需替換成自己所在區域與叢集名字。

## LoadBalancer 相關

在 service 使用`LoadBalancer`, 需先安裝 Load Balancer Controller。

## StorageClass 配置

在該方案裡， 我們使用 EBS， 因此在使用前我們需安裝 EBS CSI 驅動程式。在叢集詳情頁面裡，我們點選外掛、新增，選擇 Amazon EBD CSI 驅動程式進行新增。如下:
[![7](http://img.blog.itpub.net/blog/2022/10/21/53bd717a63654e7a.png?x-oss-process=style/bb "7")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "7")
[![8](http://img.blog.itpub.net/blog/2022/10/21/6ee29beb7fb75adb.png?x-oss-process=style/bb "8")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "8")

storageclass yaml 示例:

```nestedtext
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ebs-sc
provisioner: ebs.csi.aws.com
volumeBindingMode: Immediate
parameters:
  csi.storage.k8s.io/fstype: xfs
  type: io1
  iopsPerGB: "500"
  encrypted: "true"
allowedTopologies:
- matchLabelExpressions:
  - key: topology.ebs.csi.aws.com/zone
    values:
    - us-east-2c
```

執行以下命令

```powershell
$ kubectl apply -f storageclass.yaml
```

## 使用 EMQX Operator 進行叢集建立

Operator 安裝完成後，使用以下 yaml 在 AWS EKS 上進行部署 EMQX 叢集

```nestedtext
cat << "EOF" | kubectl apply -f -
apiVersion: apps.emqx.io/v1beta3
kind: EmqxEnterprise
metadata:
  name: emqx-ee
  labels:
    "foo": "bar"
  annotations:
    service.beta.kubernetes.io/aws-load-balancer-type: "external"
    service.beta.kubernetes.io/aws-load-balancer-nlb-target-type: "ip"
    service.beta.kubernetes.io/aws-load-balancer-scheme: internet-facing
    service.beta.kubernetes.io/aws-load-balancer-attributes: load_balancing.cross_zone.enabled=true
    service.beta.kubernetes.io/aws-load-balancer-target-group-attributes: preserve_client_ip.enabled=true
    service.beta.kubernetes.io/aws-load-balancer-attributes: deletion_protection.enabled=true
spec:
  replicas: 3
  persistent:
     storageClassName: ebs-sc
     resources:
       requests:
         storage: 4Gi
     accessModes:
     - ReadWriteOnce
  emqxTemplate:
    image: emqx/emqx-ee:4.4.6
    serviceTemplate:
      spec:
        type: LoadBalancer
EOF
```

## 使用 NLB 進行 TLS 終結

我們推薦在 NLB 上做 TLS 終結，可透過以下幾個步驟實現：

### 證照匯入

在 AWS 控制檯（https://us-east-2.console.aws.amazon.com/acm/home），匯入相關證照，證照匯入後點選證照 ID，進入詳情頁面，複製 ARN 資訊，如下圖:
[![9](http://img.blog.itpub.net/blog/2022/10/21/e6732aebfdc18c0f.png?x-oss-process=style/bb "9")](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks "9")

### 修改部署 yaml

```nestedtext
cat << "EOF" | kubectl apply -f -
apiVersion: apps.emqx.io/v1beta3
kind: EmqxEnterprise
metadata:
  name: emqx-ee
  labels:
    "foo": "bar"
  annotations:
    service.beta.kubernetes.io/aws-load-balancer-type: "external"
    service.beta.kubernetes.io/aws-load-balancer-nlb-target-type: "ip"
    service.beta.kubernetes.io/aws-load-balancer-scheme: internet-facing
    service.beta.kubernetes.io/aws-load-balancer-attributes: load_balancing.cross_zone.enabled=true
    service.beta.kubernetes.io/aws-load-balancer-ssl-cert: arn:aws:acm:us-west-2:arn:arn:aws:acm:us-east-1:609217282285:certificate/326649a0-f3b3-4bdb-a478-5691b4ba0ef3
    service.beta.kubernetes.io/aws-load-balancer-backend-protocol: tcp
    service.beta.kubernetes.io/aws-load-balancer-ssl-ports: 1883,mqtt-tls
    service.beta.kubernetes.io/aws-load-balancer-target-group-attributes: preserve_client_ip.enabled=true
    service.beta.kubernetes.io/aws-load-balancer-attributes: deletion_protection.enabled=true
spec:
  replicas: 3
  persistent:
     storageClassName: ebs-sc
     resources:
       requests:
         storage: 4Gi
     accessModes:
     - ReadWriteOnce
  emqxTemplate:
    image: emqx/emqx-ee:4.4.6
    serviceTemplate:
      spec:
        type: LoadBalancer
EOF
```

相比不使用 TLS 證照，我們在 Annotations 裡增加了下面三項內容，其中 `service.beta.kubernetes.io/aws-load-balancer-ssl-cert` 的值為我們第一步中複製的 ARN 資訊。

```elixir
service.beta.kubernetes.io/aws-load-balancer-ssl-cert: arn:aws:acm:us-west-2:arn:arn:aws:acm:us-east-1:609217282285:certificate/326649a0-f3b3-4bdb-a478-5691b4ba0ef3
service.beta.kubernetes.io/aws-load-balancer-backend-protocol: tcp
service.beta.kubernetes.io/aws-load-balancer-ssl-ports: 1883,mqtt-tls
```

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks](https://www.emqx.com/zh/blog/deploying-emqx-cluster-on-aws-eks)

在 AWS EKS 上部署 EMQX MQTT 叢集

相關文章