跳轉到

使用 Megaport Terraform Provider 建立與管理服務

本主題說明如何使用 Megaport Terraform Provider 建立與管理 Megaport 服務。

在已經學會準備 Terraform 設定檔的基本知識之後,您就可以使用 Megaport Terraform Provider 來建立並管理您的 Megaport 服務。

重要

為防止意外修改或刪除生產環境的服務,我們建議先在 staging 環境測試 Terraform 設定檔,再套用到生產環境。

使用 Terraform 準備部署服務

若要在 staging 環境套用變更,請確認您的 provider.tf 檔案包含以下設定。

environment = "staging"

建議在套用變更之前先執行 terraform plan 指令,以檢視您的執行計畫。

指令 terraform plan 會建立一個執行計畫,讓您預覽 Terraform 將對您的基礎架構執行的動作。

此計畫會詳細說明 Terraform 為達到您設定檔所定義狀態將執行的確切動作。您可以預覽哪些資源會被建立、變更或銷毀。這可讓您在套用前先檢閱擬議的變更,避免對基礎架構造成意料之外或不希望的修改。

下圖顯示執行 terraform plan 指令的範例輸出。在此範例中,Terraform 設定檔會在 NextDC B2 建立一個新的按月 1 Gpbs Port,名稱為 Megaport Port A-End

terraform plan 的範例輸出

如需詳細資訊,請參閱 terraform plan command (HashiCorp)

建立測試服務

當您對 Terraform 執行計畫中的變更感到滿意後,可以在終端機中使用下列指令於 staging 環境建立服務。

terraform apply

此指令會依據 Terraform 設定檔中的定義來建立新服務。 請參考以下範例輸出

套用 Terraform 設定檔以建立兩個 Port 及一個 VXC 的範例結果。

輸入 yes 以確認。

輸入 yes 後,Terraform 設定檔會建立服務,並顯示 套用完成! 訊息

套用完成的範例輸出

套用程序完成後,前往 staging Portal 以確認服務已依 Terraform 設定檔所設計建立。

變更測試服務

若要修改您的服務(例如:服務名稱、VXC 速率),請更新您最初使用的 Terraform 設定檔 ( main.tf )。完成必要變更後,使用以下指令套用它們。用於測試時,請先在 staging 環境套用這些變更。

terraform apply

移除測試服務

測試完成後,使用以下指令移除您為測試所建立的服務,以清理 staging 環境:

terraform destroy

請務必確認您是在 staging 環境移除服務,而非在生產環境。 請參考下方範例輸出

terraform destroy 的範例輸出

輸入 yes 以確認。

輸入 yes 後,將移除 Terraform 設定檔中定義的服務,並顯示 銷毀完成! 訊息。

銷毀程序完成後,前往 staging Portal 確認服務已被移除

銷毀完成的範例輸出

提示

您需要重新整理 staging Portal,才能確認測試服務已移除。

在生產環境建立服務

在 staging 環境完成測試並對結果滿意後,您可以在 provider.tf 檔案中指定生產環境,然後在生產環境執行 terraform apply 指令。

environment = "production"

在執行 terraform apply 之前,您需要先在生產環境建立 API 金鑰。詳情請參閱 API 金鑰

執行 terraform apply 指令後,請重新整理生產環境 Portal,以確認服務已建立。

實用參考