本文以建立一個Virtual Private Cloud為例,為您介紹如何在Terraform Explorer中使用Terraform。
Terraform Explorer是阿里雲基於Terraform開源版提供的一款線上調試Terraform設定檔的工具。其旨在簡化開發人員編寫Terraform設定檔和操作Terraform的流程,協助開發人員降低使用Terraform的門檻。藉助Terraform Explorer,開發人員可以通過填寫表單的方式實現Terraform設定檔的自動產生和轉換,並通過簡單的按鈕操作來實現Terraform的線上運行。更多關於Terraform Explorer的介紹,請參見Explorer 介紹。
Terraform Explorer支援通過自訂參數建立資源以及使用樣本模板快速建立資源兩種方式,您可以根據實際情況選擇其中任一方式進行資源建立。
自訂參數建立資源
如需根據實際情況建立阿里雲資源,您可以根據具體需求自訂參數以建立資源。
-
登入Terraform Explorer,選擇產品和资源类型,根據資來源文件的介紹输入参数,單擊发起调试。
建立VPC所需參數,更多參數資訊請參見alicloud_vpc。
參數名稱
參數描述
樣本值
vpc_name
VPC的名稱。
tf-test-vpc
cidr_block
VPC的私網網段。
192.168.0.0/16
description
VPC的描述資訊。
The VPC was created using Terraform.
其中 region_id 選擇
華北2(北京)。 -
在模板详情頁簽可以查看輸入的參數,確認無誤之後單擊预览,查看Terraform產生的執行計畫。
樣本模板中的 Terraform 配置程式碼封裝含以下內容:
required_providers指定alicloud來源為aliyun/alicloud、版本1.231.0;provider alicloud的region為cn-beijing;resource alicloud_vpc的cidr_block為192.168.0.0/16,vpc_name為tf-test-vpc。確認無誤後單擊 預覽。 -
在預覽詳情頁簽,您可以查看待建立資源的詳細資料。確認無誤之後單擊执行,查看Terraform執行結果。
預覽結果顯示成功狀態及 Terraform 執行計畫摘要,例如
Plan: 1 to add, 0 to change, 0 to destroy.,並列出待建立資源(如alicloud_vpc.default)的屬性詳情。 -
在執行詳情頁簽,您可以查看執行結果。若執行成功會提示“Apply complete! Resources: 1 added, 0 changed, 0 destroyed.”。若執行失敗,請根據提示資訊修改參數後儲存並繼續調試。
-
您可以在资源详情頁簽查看已成功建立的資源資訊。
資源地址為
alicloud_vpc.default,屬性列表包括 cidr_block(192.168.0.0/16)、name(tf-test-vpc)、description(The VPC was created using Terraform.)、create_time、enable_ipv6(false)、route_table_id、router_id 等配置資訊,確認 VPC 資源已按自訂參數成功建立。 -
若您希望修改已建立的資源資訊,可以調整相關參數,然後點擊儲存並繼續調試,再重複步驟2、步驟3和步驟4。待執行完成後,您可以在執行詳情頁簽中查看執行結果。如果執行成功,將提示“Apply complete! Resources: 0 added, 1 changed, 0 destroyed.”;若執行失敗,請根據提示調整參數後儲存並繼續調試。
-
若您希望釋放已建立的資源,在執行詳情頁簽單擊销毁资源,然後在預覽詳情頁簽單擊执行釋放資源。
執行完成後,執行詳情 頁簽顯示執行結果為 成功,日誌輸出
Apply complete! Resources: 0 added, 0 changed, 1 destroyed.,表示 VPC 資源已被成功銷毀。
使用樣本模板建立資源
部分雲產品在建立時需填寫的參數較多,如果您對具體需要填寫的參數不太瞭解,或僅希望快速體驗使用Terraform建立資源的過程,建議選擇樣本模板以便快速完成資源的建立。Terraform Explorer為每種資源類型提供樣本模板,您可以通過直接選擇其中一個樣本模板來迅速完成調試。
-
登入Terraform Explorer,選擇相應的產品、资源类型及樣本模板,單擊发起调试。您可以在右側的樣本模板頁簽中查看樣本模板的詳細資料。
本樣本中,選擇版本 1.231.0,產品 VPC,資源類型 alicloud_vpc,樣本模板 vpc-docs-Example-01。輸入參數 name 值為
terraform-example。右側樣本模板頁簽顯示 HCL 代碼,包含ipv6_isp="BGP"、cidr_block="10.0.0.0/8"、vpc_name=var.name、enable_ipv6=true等屬性配置。 -
在模板详情頁簽單擊预览并执行。
-
在執行詳情頁簽,您可以查看執行結果。若執行成功會提示"Apply complete! Resources: N added, 0 changed, 0 destroyed."(N為實際建立的資源數量)。若執行失敗,請根據提示資訊修改參數後儲存並繼續調試。
-
若您希望釋放已建立的資源,在執行詳情頁簽單擊销毁资源,然後在預覽詳情頁簽單擊执行釋放資源。
執行完成後,執行詳情 頁簽顯示執行結果為 成功,日誌輸出
Apply complete! Resources: 0 added, 0 changed, 1 destroyed.,表示資源已被成功銷毀。
您也可以在調用歷史中進行继续调试、销毁资源等操作。