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

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

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

## Terraform 簡介

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

[![Terraform 工作原理](http://img.blog.itpub.net/blog/2022/07/14/74721ea26731f367.png?x-oss-process=style/bb "Terraform 工作原理")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-alibaba-cloud-using-terraform "Terraform 工作原理")

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

## 準備與安裝

### 安裝 Ali Cloud SDK for Go

```vim
go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk
```

### 安裝 Terraform

以 Mac 為例，透過 brew 安裝。

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

驗證安裝

```bash
terraform -help
```

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

## 使用 Terraform 部署 EMQX 叢集

### 下載阿里雲部署指令碼

```awk
git clone https://github.com/emqx/terraform-emqx-emqx-alicloud.git
```

### 部署指令碼說明

**指令碼配置檔案路徑：**

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

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

- Ali Cloud SDK: v1.61.1608

> 老版本 SDK 可能會導致 ELB 部署失敗

- 預設 EMQX 版本：企業版 4.4.3

如果要部署開源版，需要修改 `terraform.tfvars` 檔案末尾的 `emqx_package` 值，比如部署開源版 5.0.3：

`emqx_package = https://www.emqx.com/en/downloads/broker/5.0.3/emqx-5.0.3-ubuntu20.04-amd64.tar.gz`

- 預設阿里雲 Region 為：`cn-shenzhen`

- 預設叢集節點：2 臺 `ecs.t6-c1m1.large`

### 配置阿里雲 AccessKey

進入阿里雲 AccessKey 頁面

[![阿里雲 AccessKey 頁面](http://img.blog.itpub.net/blog/2022/07/14/fea69da33e00a066.png?x-oss-process=style/bb "阿里雲 AccessKey 頁面")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-alibaba-cloud-using-terraform "阿里雲 AccessKey 頁面")

拿到建立好的 AccessKey 和 Secret，設定環境變數

```routeros
export ALICLOUD_ACCESS_KEY=${anaccesskey}
export ALICLOUD_SECRET_KEY=${asecretkey}
export ALICLOUD_REGION=${region}
```

### 部署 EMQX 企業版叢集

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

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

等待幾分鐘後，可以看到部署完成的結果如下：

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

## 驗證叢集部署結果

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

> ```
> http://120.79.163.50:18083
> ```
>
> 使用者名稱：`admin`
>
> 密碼：`public`

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

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

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

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

2. 點選“連線”

[![MQTT WebSocket連線](http://img.blog.itpub.net/blog/2022/07/14/97db659a52fc4467.png?x-oss-process=style/bb "MQTT WebSocket連線")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-alibaba-cloud-using-terraform "MQTT WebSocket連線")

3. 訂閱主題

[![MQTT WebSocket訂閱主題](http://img.blog.itpub.net/blog/2022/07/14/b3d92fba86a46cf6.png?x-oss-process=style/bb "MQTT WebSocket訂閱主題")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-alibaba-cloud-using-terraform "MQTT WebSocket訂閱主題")

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

[![MQTT WebSocket釋出](http://img.blog.itpub.net/blog/2022/07/14/0602a7bd22835734.png?x-oss-process=style/bb "MQTT WebSocket釋出")](https://www.emqx.com/zh/blog/deploy-mqtt-cluster-on-alibaba-cloud-using-terraform "MQTT WebSocket釋出")

## 結語

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

>**參考資料**
>
>程式碼倉庫: https://github.com/emqx/terraform-emqx-emqx-alicloud
>
>EMQX Terraform 模組官方文件：https://docs.emqx.com/zh/emqx-terraform/latest

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

使用 Terraform 在阿里雲上快速部署 MQTT 叢集

相關文章