資源管理常用命令

狀態(tài)管理常用命令

Terraform對資源狀態(tài)的管理，實際上是對State文件中數(shù)據(jù)的管理。State文件保存了當(dāng)前Terraform管理的所有資源及其屬性，內(nèi)容都是由Terraform自動存儲的，為了保證數(shù)據(jù)的完整性，不建議手動修改State內(nèi)容。對State數(shù)據(jù)的操作可以通過terraform state命令來完成。

• terraform state list：列出當(dāng)前state中的所有資源

  state list命令會按照 <資源類型>.<資源名稱> 的格式列出當(dāng)前state中存在的所有資源（包括datasource），例如：

  $ terraform state list
  data.alicloud_slbs.default
  alicloud_vpc.default
  alicloud_vswitch.this

• terraform state show：展示某一個資源的屬性

  state show命令按照Key-Value的格式展示出特定資源的所有屬性及其值，命令的完整格式為 terraform state show <資源類型>.<資源名稱> ，例如：

  $ terraform state show alicloud_vswitch.this
  # alicloud_vswitch.this:
  resource "alicloud_vswitch" "this" {
      availability_zone = "eu-central-1a"
   cidr_block = "172.16.0.0/24"
   id = "vsw-gw8gl31wz******"
   vpc_id = "vpc-gw8calnzt*******"
  }

• terraform state pull：獲取當(dāng)前state內(nèi)容并展示

  state pull命令用于原樣展示當(dāng)前state文件數(shù)據(jù)，類似于Shell下的cat命令，例如：

  $ terraform state pull
  {
      "version": 4,
      "terraform_version": "0.12.8",
      "serial": 615,
      "lineage": "39aeeee2-b3bd-8130-c897-2cb8595cf8ec",
      "outputs": {
       ***
   }
   },
  "resources": [
   {
          "mode": "data",
          "type": "alicloud_slbs",
          "name": "default",
          "provider": "provider.alicloud",
       ***
   },
   {
          "mode": "managed",
          "type": "alicloud_vpc",
          "name": "default",
          "provider": "provider.alicloud",
       ***
   }
   ]
  }

• terraform state rm：移除特定的資源

  state rm命令用于將state中的某個資源移除，但是實際上并不會真正刪除這個資源，命令格式為：terraform state rm <資源類型>.<資源名稱> ，例如：

  $terraform state rm alicloud_vswitch.this
  Removed alicloud_vswitch.this
  Successfully removed 1 resource instance(s).

  移除后，如果模板內(nèi)容不變并且再次執(zhí)行apply命令，將會新增一個同樣的資源。移除后的資源可以再次通過import命令再次加入。

• terraform state mv：變更特定資源的存放地址

  如果想調(diào)整某個資源所在的state文件，可以通過state mv命令來完成，類似于Shell下的mv命令，這個命令的使用有多種選項，可以通過命令 terraform state mv --help 來詳細(xì)了解。本文只介紹最常用的一種：terraform state mv --state=./terraform.tfstate --state-out=<target path>/terraform-target.tfstate <資源類型>.<資源名稱A> <資源類型>.<資源名稱B> ，如：

  $ terraform state mv --state-out=../tf.tfstate alicloud_vswitch.this alicloud_vswitch.default
  Move "alicloud_vswitch.this" to "alicloud_vswitch.default"
  Successfully moved 1 object(s)

  如上命令省略了默認(rèn)的--state=./terraform.tfstate選項，命令最終的結(jié)果是將當(dāng)前State中的vSwitch資源移動到了上層目錄下名為 tf.tfstate 的State中，并且將vSwitch的資源名稱由“this”改為了“default”。

• terraform refresh：刷新當(dāng)前state

  refresh命令可以用來刷新當(dāng)前State的內(nèi)容，即再次調(diào)用API并拉取最新的數(shù)據(jù)寫入到state文件中。

其他常用命令

除了資源和狀態(tài)的管理命令外，還有一些常用的應(yīng)用在模板，Provider等多種場景下的命令。

• terraform init：初始化加載模塊

  init用來初始化加載所需的模塊，包括Provider，Provisioner，Module等。

• terraform graph：輸出當(dāng)前模板定義的資源關(guān)系圖

  每個模板定義的資源之間都存在不同程度的關(guān)系，如果想看資源關(guān)系圖，可以使用命令terraform graph:

  $ terraform graph
  digraph {
   compound = "true"
   newrank = "true"
   subgraph "root" {
   "[root] alicloud_vpc.default" [label = "alicloud_vpc.default", shape = "box"]
   "[root] alicloud_vswitch.this" [label = "alicloud_vswitch.this", shape = "box"]
                  ******
   "[root] output.vswitchId" -> "[root] alicloud_vswitch.this"
   "[root] provider.alicloud (close)" -> "[root] alicloud_vswitch.this"
  ******
   "[root] root" -> "[root] provider.alicloud (close)"
   }
  }                 

  該命令的結(jié)果還可以通過命令terraform graph | dot -Tsvg > graph.svg直接導(dǎo)出為一張圖片（需要提前安裝graphviz： brew install graphviz ）：

• terraform validate：驗證模板語法是否正確

  Terraform模板的編寫需要遵循其自身定義的一套簡單的語法規(guī)范，編寫完成后，如果想要檢查模板是否存在語法錯誤或者在運行plan和apply命令的時候報語法錯誤，可以通過執(zhí)行命令terraform validate來檢查和定位錯誤出現(xiàn)的詳細(xì)位置和原因。