Terraform 是由 HashiCorp 推出的一個基礎設施即程式碼（IaC）工具，它包括了底層的元件如計算例項、儲存和網路，以及高層的元件如 DNS、LBS 等。使用者可以使用 Terraform 安全、高效地構建、改變和更新基礎設施。

在傳統的私有云或公有云部署方式中，使用者需要先部署好基礎設施（虛擬機器、網路和儲存等），之後才能開始部署 MQTT 叢集。而如果使用 Terraform，使用者則可以同時完成這兩項工作。此外，同一套工具可以在不同的平臺上進行部署，透過模版可重複、可預測的方式定義和配置資源，可大大減少人為因素導致的錯誤。

本文將以分散式物聯網 [MQTT 訊息伺服器 EMQX](https://www.emqx.com/zh/products/emqx) 為例，採用 AWS 作為公有云平臺，介紹如何使用 Terraform 快速部署一個高可用的 [MQTT 叢集](https://www.emqx.com/zh/blog/tag/mqtt-broker-叢集)。

## Terraform 簡介

作為一個管理服務生命週期的工具，Terraform 可以用狀態檔案記錄和跟蹤所有環境變化。預設狀態是儲存在本地的，透過 HCL 或者 JSON 來定義，HCL 是 HashiCorp 提供的模板語言。

[![Terraform](http://img.blog.itpub.net/blog/2022/07/25/1b28495fd183756f.png?x-oss-process=style/bb "Terraform")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "Terraform")

- Coding：用 HCL 來編寫基礎設施程式碼。可以定義塊，引數和表示式。
- Plan：執行 Terraform Plan 來檢查執行計劃是否符合期望。
- Apply：執行 Terraform Apply 來構建使用者所需的基礎設施

## 安裝與準備

### 安裝 Terraform

以 Mac 為例，透過 brew 安裝。

```awk
brew tap hashicorp/tap 2brew install hashicorp/tap/terraform
```

驗證安裝

```bash
terraform -help
```

具體參考[官方文件](https://learn.hashicorp.com/tutorials/terraform/install-cli)

### 安裝 AWS Cli

以 Mac 為例

```aspectj
curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg AWSCLIV2.pkg -target /
```

驗證安裝

```stata
which aws
aws --version
```

參考[官方文件](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)

### 新增使用者

1. 進入 AWS 的 IAM 選單，點選“新增使用者”

[![AWS 新增使用者](http://img.blog.itpub.net/blog/2022/07/25/263588ac7824761e.png?x-oss-process=style/bb "AWS 新增使用者")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "AWS 新增使用者")

2. 在新增使用者中，記得勾選“訪問金鑰”

[![AWS 勾選“訪問金鑰”](http://img.blog.itpub.net/blog/2022/07/25/99cea00eb616a8d3.png?x-oss-process=style/bb "AWS 勾選“訪問金鑰”")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "AWS 勾選“訪問金鑰”")

3. 選擇“建立組”

[![AWS 建立組](http://img.blog.itpub.net/blog/2022/07/25/77f425d332e5e737.png?x-oss-process=style/bb "AWS 建立組")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "AWS 建立組")

4. 在建立組中新增“AdministratorAccess”策略

[![新增 AdministratorAccess 策略](http://img.blog.itpub.net/blog/2022/07/25/2ff369a289a322ea.png?x-oss-process=style/bb "新增 AdministratorAccess 策略")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "新增 AdministratorAccess 策略")

5. 點選“建立使用者”，完成使用者新增

[![AWS 建立使用者](http://img.blog.itpub.net/blog/2022/07/25/f74aa4c8e5d2e915.png?x-oss-process=style/bb "AWS 建立使用者")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "AWS 建立使用者")

6. 獲取 Access Key 和 Secret

[![獲取 Access Key 和 Secret](http://img.blog.itpub.net/blog/2022/07/25/dfe6de80a7fa7a69.png?x-oss-process=style/bb "獲取 Access Key 和 Secret")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "獲取 Access Key 和 Secret")

### 配置 AWS 的 Access Key

拿到上面建立好的access key和secret，設定環境變數

```apache
AWS_ACCESS_KEY_ID: ${anaccesskey}
AWS_SECRET_ACCESS_KEY: ${asecretkey}
```

## 使用 Terraform 在 AWS 上部署 EMQX 叢集

### 下載 AWS 部署指令碼

```bash
git clone "https://github.com/emqx/terraform-emqx-emqx-aws.git"
```

部署指令碼說明：

- 暫時不支援 EMQX 5.X
- AWS CLI：aws-cli/2.2.41 Python/3.8.8 Darwin/21.4.0 exe/x86_64 prompt/off

指令碼配置檔案路徑：

- 單機部署配置檔案：services/emqx/terraform.tfvars
- 叢集部署配置檔案：services/emqx_cluster/terraform.tfvars

部署指令碼預設使用以下配置，讀者可根據實際情況自行修改 terraform.tfvars 檔案：

- 預設 EMQX 版本：企業版 4.4.3

> 如果要部署開源版，需要修改 `emqx_package` 值，比如部署開源版 4.4.3：`https://www.emqx.com/en/downloads/broker/v4.4.3/emqx-4.4.3-otp23.3.4.9-3-ubuntu20.04-amd64.zip`

- 預設AWS Region 為us-east-1
- 預設叢集節點：3臺`t3.small`

### 部署 EMQX 叢集

> 使用者可以透過修改terraform.tfvars檔案，來更改預設的配置

```bash
cd services/emqx_cluster
terraform init
terraform plan
terraform apply -auto-approve
```

等待幾分鐘，部署完成的結果如下所示

[![部署完成](http://img.blog.itpub.net/blog/2022/07/25/99203f857b4b74b9.png?x-oss-process=style/bb "部署完成")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "部署完成")

## 驗證 EMQX 叢集部署結果

叢集部署成功後，我們可以簡單測試叢集是否已正常執行。先從上圖獲取到叢集的IP 地址，並透過以下資訊訪問 EMQX 企業版的 Dashboard。

> ```
> http://tf-elb-nlb-5bff6976b15586dd.elb.us-east-1.amazonaws.com:18083
> ```
>
> 使用者名稱：`admin`
>
> 密碼：`public`

[![EMQX Dashboard](http://img.blog.itpub.net/blog/2022/07/25/ed2b4653771c01dc.png?x-oss-process=style/bb "EMQX Dashboard")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "EMQX Dashboard")

從上圖可以看到我們部署了 3 個節點，這時可以透過 Websocket 工具進行簡單驗證：

1. 左邊選單欄選擇工具→WebSocket

[![MQTT WebSocket](http://img.blog.itpub.net/blog/2022/07/25/a928d4a5f1220e03.png?x-oss-process=style/bb "MQTT WebSocket")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "MQTT WebSocket")

2. 點選“連線”

[![MQTT 連線](http://img.blog.itpub.net/blog/2022/07/25/6924701644ca4a8e.png?x-oss-process=style/bb "MQTT 連線")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "MQTT 連線")

3. 訂閱主題

[![MQTT 訂閱](http://img.blog.itpub.net/blog/2022/07/25/f4e6c02595c3b734.png?x-oss-process=style/bb "MQTT 訂閱")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "MQTT 訂閱")

4. 點選發布，正常能看到如下結果

[![MQTT 釋出](http://img.blog.itpub.net/blog/2022/07/25/3525c50be7563e8d.png?x-oss-process=style/bb "MQTT 釋出")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-aws-using-terraform "MQTT 釋出")

## 結語

至此，我們完成了透過 Terraform 在 AWS 上快速部署 MQTT 叢集的全部流程。讀者可根據實際情況修改部署指令碼，建立滿足自己業務需求的 EMQX 叢集，藉助 EMQX 在物聯網資料連線、移動與處理方面的優勢構建具有競爭力的物聯網平臺與應用。

> **參考：**
>
> 程式碼倉庫：https://github.com/emqx/terraform-emqx-emqx-aws
>
> EMQX Terraform模組官方文件：[https://docs.emqx.com/zh/emqx-terraform/latest](https://docs.emqx.com/zh/emqx-terraform/latest)

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

使用 Terraform 在 AWS 上快速部署 MQTT 叢集

相關文章