本文為您介紹RAM使用者如何使用Terraform調用ApsaraDB for Hbase的OpenAPI建立HBase叢集。
說明
當前範例程式碼支援一鍵運行，您可以直接運行代碼。一鍵運行
前提條件
由於阿里雲帳號（主帳號）具有資源的所有許可權，一旦發生泄露將面臨重大風險。建議您使用RAM使用者，並為該RAM使用者建立AccessKey，具體操作方式，請參見建立RAM使用者和建立AccessKey。
為RAM使用者授予AliyunHBaseFullAccess（管理雲資料庫服務（HBase））和AliyunVPCFullAccess（管理Virtual Private Cloud）許可權。授權樣本如下，如何授權，請參見為RAM使用者授權。
{ "Version": "1", "Statement": [ { "Action": [ "vpc:CreateVpc", "vpc:DescribeVpc", "vpc:ModifyVpcAttribute", "vpc:DeleteVpc", "vpc:CreateVSwitch", "vpc:DescribeVSwitch", "vpc:ModifyVSwitchAttribute", "vpc:DeleteVSwitch" ], "Resource": "*", "Effect": "Allow" }, { "Action": "hbase:*", "Resource": "*", "Effect": "Allow" } ] }準備Terraform運行環境，您可以選擇以下任一方式來使用Terraform。
在Terraform Explorer中使用Terraform：阿里雲提供了Terraform的線上運行環境，您無需安裝Terraform，登入後即可線上使用和體驗Terraform。適用於零成本、快速、便捷地體驗和調試Terraform的情境。
Cloud Shell：阿里雲Cloud Shell中預裝了Terraform的組件，並已配置好身份憑證，您可直接在Cloud Shell中運行Terraform的命令。適用於低成本、快速、便捷地訪問和使用Terraform的情境。
在本地安裝和配置Terraform：適用於網路連接較差或需要自訂開發環境的情境。
重要
請確保Terraform版本不低於v0.12.28。如需檢查現有版本，請運行terraform --version命令。
說明
本教程樣本包含的部分資源會產生一定費用，請在不需要時及時進行退訂。
使用的資源
alicloud_hbase_instance：建立一個HBase叢集。
alicloud_vpc：建立VPC。
alicloud_vswitch：建立交換器。
使用Terraform建立HBase叢集
建立一個工作目錄，並且在工作目錄中建立以下名為
main.tf的設定檔。main.tf是Terraform主檔案，定義了將要部署的資源。variable "region" { default = "cn-qingdao" } provider "alicloud" { region = var.region } data "alicloud_hbase_zones" "default" {} variable "instance_type" { default = "hbase.sn2.large" } variable "name" { default = "hbasetest" } # 建立 alicloud_vpc 資源 resource "alicloud_vpc" "vpc1" { vpc_name = var.name cidr_block = "172.16.0.0/12" } # 在 local.zone_id 地區建立 alicloud_vpc 資源下的 alicloud_vswitch 資源 resource "alicloud_vswitch" "default" { vswitch_name = var.name cidr_block = "172.16.20.0/24" vpc_id = alicloud_vpc.vpc1.id zone_id = data.alicloud_hbase_zones.default.zones[0].id } resource "alicloud_hbase_instance" "default" { # (必填) HBase 執行個體名稱，長度必須為 2-128 個字元，只允許使用中文字元、英文字母、數字、句點 (.)、底線 (_) 或虛線 (-)。 name = var.name # (可選，ForceNew) 啟動 HBase 執行個體的地區。 zone_id = data.alicloud_hbase_zones.default.zones[0].id # (可選，ForceNew) vswitch_id = alicloud_vswitch.default.id # (可選，ForceNew，從 v1.185.0 起可用) VPC 的 ID。 vpc_id = alicloud_vpc.vpc1.id # (可選，ForceNew) 有效值為 "hbase/hbaseue/bds"。自 v1.73.0 之後支援的類型包括 hbaseue 和 bds。單個 HBase 執行個體需要設定 engine=hbase，core_instance_quantity=1。 engine = "hbaseue" # (必填，ForceNew) HBase 主要版本，hbase:1.1/2.0, hbaseue:2.0, bds:1.0，當前暫不支援其他引擎。 engine_version = "2.0" # (必填) 執行個體規格 master_instance_type = var.instance_type # (必填) 執行個體規格 core_instance_type = var.instance_type # (可選) 預設值為 2，範圍為 [1-200]。若 core_instance_quantity > 1，則為叢集執行個體；若 core_instance_quantity = 1，則為單個執行個體。 core_instance_quantity = "2" # (可選，ForceNew) 有效值為 cloud_ssd, cloud_essd_pl1, cloud_efficiency, local_hdd_pro, local_ssd_pro，``，local_disk 大小是固定的。當 engine=bds 時，無需設定磁碟類型（或Null 字元串）。 core_disk_type = "cloud_ssd" # (可選) 使用者定義的 HBase 執行個體每個核心節點的儲存，僅在 engine=hbase/hbaseue 時有效。Bds 引擎無需設定 core_disk_size，單位：GB。值範圍： # 自訂儲存空間，值範圍：[20, 64000]。 # 叢集 [400, 64000]，步長：40-GB 增量。 # 單個 [20-500GB]，步長：1-GB 增量。 core_disk_size = 400 # (可選) 有效值為 PrePaid, PostPaid，系統預設為 PostPaid。也可以從 PostPaid 轉換為 PrePaid，支援從 v1.115.0+ 將 PrePaid 轉換為 PostPaid。 pay_type = "PostPaid" # (可選) 0 或 [800, 100000000]，步長：10-GB 增量。0 表示 is_cold_storage = false。[800, 100000000] 表示 is_cold_storage = true。 cold_storage_size = 0 # (可選，從 1.109.0 起可用) 立即刪除開關。True: 立即刪除，False: 延遲刪除。無論設定為 true 還是 false，您都將無法找到叢集。 immediate_delete_flag = true # (可選) 有效值為 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36，僅在 pay_type = PrePaid 時有效，單位：月。12, 24, 36 表示 1, 2, 3 年。 duration = 1 # (可選，從 1.73.0 起可用) 刪除保護開關。True: 刪除保護，False: 不做刪除保護。如果您想刪除叢集，必須設定為 false。 deletion_protection = false }執行以下命令，初始化
Terraform運行環境。terraform init返回如下資訊，表示Terraform初始化成功。
Initializing the backend... Initializing provider plugins... - Finding latest version of hashicorp/alicloud... - Installing hashicorp/alicloud v1.234.0... - Installed hashicorp/alicloud v1.234.0 (signed by HashiCorp) Terraform has created a lock file .terraform.lock.hcl to record the provider selections it made above. Include this file in your version control repository so that Terraform can guarantee to make the same selections by default when you run "terraform init" in the future. Terraform has been successfully initialized! You may now begin working with Terraform. Try running "terraform plan" to see any changes that are required for your infrastructure. All Terraform commands should now work. If you ever set or change modules or backend configuration for Terraform, rerun this command to reinitialize your working directory. If you forget, other commands will detect it and remind you to do so if necessary.建立執行計畫，並預覽變更。
terraform plan執行以下命令，建立HBase叢集執行個體。
terraform apply在執行過程中，根據提示輸入
yes並按下Enter鍵，等待命令執行完成，若出現以下資訊，則表示建立HBase叢集成功。Plan: 3 to add, 0 to change, 0 to destroy. Do you want to perform these actions? Terraform will perform the actions described above. Only 'yes' will be accepted to approve. Enter a value: yes alicloud_vpc.vpc1: Creating... alicloud_vpc.vpc1: Creation complete after 6s [id=vpc-m5ecf5pojlcjkolx7u***] alicloud_vswitch.default: Creating... alicloud_vswitch.default: Creation complete after 4s [id=vsw-m5ehryjeb8rs3bm56j***] alicloud_hbase_instance.default: Creating... alicloud_hbase_instance.default: Still creating... [10s elapsed] alicloud_hbase_instance.default: Still creating... [20s elapsed] alicloud_hbase_instance.default: Still creating... [30s elapsed] alicloud_hbase_instance.default: Still creating... [40s elapsed] alicloud_hbase_instance.default: Still creating... [50s elapsed] alicloud_hbase_instance.default: Still creating... [1m0s elapsed] alicloud_hbase_instance.default: Still creating... [1m10s elapsed] alicloud_hbase_instance.default: Still creating... [1m20s elapsed] ... alicloud_hbase_instance.default: Still creating... [16m30s elapsed] alicloud_hbase_instance.default: Still creating... [16m40s elapsed] alicloud_hbase_instance.default: Still creating... [16m50s elapsed] alicloud_hbase_instance.default: Creation complete after 16m57s [id=ld-m5ezvi1qi8tkbu***] Apply complete! Resources: 3 added, 0 changed, 0 destroyed.驗證結果 。
執行terraform show命令
您可以使用以下命令查詢Terraform已建立的資來源詳細資料：
terraform show
登入HBase管理主控台
建立完成後，您可以登入HBase管理主控台，檢查操作是否正確完成。
清理資源
當您不再需要上述通過Terraform建立或管理的資源時，請運行以下命令以釋放資源。關於terraform destroy的更多資訊，請參見常用命令。
terraform destroy完整樣本
說明
當前範例程式碼支援一鍵運行，您可以直接運行代碼。一鍵運行
範例程式碼
如果您想體驗更多完整樣本，請前往更多完整樣本中對應產品的檔案夾查看。