Terraform 在 VMware 基礎設施自動化佈署中的應用

– 9 分鐘閱讀

Terraform 提供了豐富的功能來管理和組態基礎設施，對於 VMware 環境的自動化佈署尤為重要。變數、地圖和列表是 Terraform 中常用的資料結構，可以幫助我們更有效地管理組態。變數允許我們定義可組態的引數，方便在不同環境中調整組態。地圖則以鍵值對的形式儲存資料，適用於管理結構化資訊。列表則用於儲存有序的資料集合。透過靈活運用這些資料結構，我們可以建立更具彈性和可維護性的 Terraform 組態。此外，模組化設計也是 Terraform 的一個重要特性，它允許我們將可重用的組態封裝成模組，提高程式碼的複用性和可維護性。在實際應用中，我們可以結合變數、地圖、列表和模組等功能，構建更加複雜和靈活的基礎設施組態，例如，可以定義一個地圖變數來儲存不同虛擬機器的組態資訊，然後透過迴圈遍歷地圖，動態建立多個虛擬機器。

探討 Terraform 的變數、地圖及列表

在虛擬機器管理的領域，Terraform 是一個強大的工具，能夠幫助我們自動化 VMware 基礎設施的佈署。透過 Terraform 的變數、地圖及列表，我們可以建立靈活且可重用的組態，以適應不同的需求。以下將詳細探討這些功能的使用方法。

變數的定義與使用

在 Terraform 中，變數（variables）允許我們定義可組態的引數，這些引數可以在不同的環境中進行調整。變數的定義非常簡單，我們只需要在 variables.tf 檔案中進行宣告。

variable "vm_name" {
  description = "Name of the virtual machine"
  type        = string
  default     = "default-vm"
}

variable "cpu_count" {
  description = "Number of CPUs for the virtual machine"
  type        = number
  default     = 2
}

variable "memory_size" {
  description = "Amount of memory in MB for the virtual machine"
  type        = number
  default     = 4096
}

variable "disk_size" {
  description = "Size of the virtual disk in GB"
  type        = number
  default     = 20
}

情境解密：

  • vm_name：虛擬機器名稱，這是一個字串型變數，預設值為「default-vm」。
  • cpu_count：虛擬機器 CPU 數量，這是一個數值型變數，預設值為2。
  • memory_size：虛擬機器記憶體大小（單位：MB），這是一個數值型變數，預設值為4096 MB。
  • disk_size：虛擬機器磁碟大小（單位：GB），這是一個數值型變數，預設值為20 GB。

接下來，我們可以在資源定義中使用這些變數。以下是一個簡單的 vsphere_virtual_machine 資源定義範例：

resource "vsphere_virtual_machine" "example_vm" {
  name             = var.vm_name
  cpu_number       = var.cpu_count
  memory           = var.memory_size
  # 其他虛擬機器組態選項
}

情境解密：

  • name：使用 var.vm_name 作為虛擬機器名稱。
  • cpu_number：使用 var.cpu_count 作為虛擬機器 CPU 數量。
  • memory：使用 var.memory_size 作為虛擬機器記憶體大小。

動態指定變數值

在執行 Terraform 指令時，我們可以透過命令列引數來覆寫這些變數的預設值。例如：

terraform plan -var="vm_name=web-server" -var="cpu_count=4"

情境解密：

在這個例子中，我們覆寫了 vm_name 和 cpu_count 的預設值。具體來說：

  • vm_name=web-server：將虛擬機器名稱設定為「web-server」。
  • cpu_count=4：將虛擬機器 CPU 數量設定為4。

這樣的靈活性使得我們可以根據具體需求來調整虛擬機器的組態。

地圖（Maps）

地圖（maps）在 Terraform 中允許我們定義鍵值對集合，每個鍵都是唯一的。地圖非常適合用來組織和管理結構化的資料。以下是如何在 Terraform 組態中使用地圖的一個例子。

地圖的定義

首先，我們需要在 variables.tf 中定義一個地圖型變數：

variable "vm_config" {
  description = "Configuration details of VMware virtual machines"
  type        = map(object({
    cpu_count    = number
    memory_size  = number
    disk_size    = number
  }))
}

情境解密：

  • description：描述此地圖變數用於儲存 VMware 虛擬機器組態細節。
  • type：指定此地圖變數的結構，包含三個屬性：CPU 數量、記憶體大小及磁碟大小。

指定地圖值

接下來，我們可以在組態檔案中指定這些地圖的值：

vm_config = {
  "web-server" = {
    cpu_count    = 2
    memory_size  = 4096
    disk_size    = 20
  }
  "database-server" = {
    cpu_count    = 4
    memory_size  = 8192
    disk_size    = 100
  }
}

情境解密：

  • 「web-server」：對應於 Web伺服器組態，包括CPU 數量、記憶體大小及磁碟大小。
  • 「database-server」：對應於資料函式庫伺服器組態，包括CPU 數量、記憶體大小及磁碟大小。

輸入地圖值

在資源定義中，我們可以透過鍵來存取地圖中的特定值：

resource "vsphere_virtual_machine" "example_vm" {
  name             = "web-server"
  cpu_number       = var.vm_config["web-server"].cpu_count
  memory           = var.vm_config["web-server"].memory_size
}

情境解密：

在此例子中，我們存取了「web-server」條目中的 cpu_count 和 memory_size 屬性。

動態生成地圖

Terraform 支援透過插值和其他功能來動態生成地圖。例如，我們可以使用迴圈來遍歷一個列表並根據特定條件生成動態地圖。

增加VMware基礎設施中列表（Lists）功能

Terraform 中的列表（lists）允許我們定義有序集合。與地圖不同的是，列表沒有關聯鍵，主要用於儲存多個相關值。以下是如何在 VMware 基礎設施佈署中使用列表的一些示範。

增加VMware基礎設施中列表（Lists）功能

首先，我們需要在 variables.tf 中定義一個列表型變數：

variable "datastore_clusters" {
description ="Names of VMware datastore clusters"
type        ="list(string)"
}

情境解密：

  • description：“描述此列表變數用於儲存VMware Datastore 叢集名稱”
  • type：“list(string)“表示此列表型別為字串”

增加VMware基礎設施中列表（Lists）功能

接下來是如何指派值至該List：

datastore_clusters ="cluster1",“cluster2",“cluster3"]
情境解密：

透過指派到List字串集合即可完成指派！

增加VMware基礎設施中列表（Lists）功能

透過索引號碼就可以輕鬆取得List內容：

resource “vsphere_virtual_machine” “example_vm”{
name             ="web-server"
datastore_cluster="var.datastore_clusters[1]"
#其他的選項組態...
}
情境解密：

透過「var.datastore_clusters[1]」即可取得第二筆資料集合！

動態產生Lists功能

除了直接編寫外也可透過Terraform 其他功能如插補達成！

增加Terraform預設屬性設定

預設屬性可以確保即讓使用者不提供該屬性時還是可正常執行！當然透過Terraform預設屬性也可提供多種設定選項！

增加Terraform預設屬性設定

首先要先宣告該預設屬性！

variable “vm_cpu_count”{
description ="Number of CPUs for virtual machine"
type        ="number"
default     ="2"
}
情境解密：

如上例所示透過宣告預設屬性即可達成！

其他動態產生方式

Terraform除了直接編寫外也有多種方式可提供自動產生! 例如透過環境變數、命令列引數或其他Terraform內建功能達到動態產生目的！

Terraform 在 VMware 環境中的變數管理與模組化應用

在 Terraform 中，變數管理是一個非常重要的主題，特別是在複雜的 VMware 環境中。玄貓將探討如何透過命令列、環境變數、變數檔案以及互動提示來設定和管理變數。此外，還將探討模組化的概念，展示如何透過模組來提升基礎設施的可重用性和可擴充套件性。

使用命令列標誌設定變數

在執行 Terraform 命令時，可以透過命令列標誌直接傳遞值來設定變數。例如，要在執行時設定一個名為 datastore 的變數，可以使用 -var 標誌：

terraform apply -var="datastore=example_datastore"

內容解密：

在這裡，terraform apply 命令用來應用 Terraform 組態檔案。-var 標誌允許在命令列中直接設定變數的值，這樣可以避免在每次執行時都需要修改組態檔案。這種方法適用於快速測試和簡單的場景。

使用環境變數設定變數

另一種設定變數的方法是使用環境變數。Terraform 會自動讀取符合特定命名規則的環境變數（TF_VAR_variable_name）。例如，要設定一個名為 network 的變數，可以這樣做：

export TF_VAR_network="example_network"

內容解密：

這種方法透過環境變數來設定 Terraform 變數，適合需要保持組態檔案簡潔或需要多次執行同一組態的情況。環境變數的優點是可以在不修改組態檔案的情況下更改變數值。

使用變數檔案設定變數

Terraform 支援將變數值儲存在單獨的檔案中，這些檔案通常具有 .tfvars 或 .tfvars.json 副檔名。建立一個名為 variables.tfvars 的檔案並指定其位置來執行 Terraform 命令：

datastore = "example_datastore"
network = "example_network"

然後，執行 Terraform 命令時使用 -var-file 標誌指定該變數檔案：

terraform apply -var-file="variables.tfvars"

內容解密：

使用 .tfvars 檔案來管理變數有助於將組態和實作細節分離，這樣可以更好地組織和重用程式碼。這種方法特別適合於多環境佈署或需要分享組態的團隊。

互動提示

如果沒有透過以上方法設定某些變數，Terraform 會在執行時提示您輸入這些變數的值。例如，如果沒有設定 cluster 變數，Terraform 會要求您輸入其值。

內容解密：

互動提示適用於需要手動輸入少量資訊或進行一些即時調整的情況。這種方法提供了一種靈活性，但不適合自動化Pipeline。

在 VMware 組態中的示例應用

以下是結合命令列標誌和變數檔案來填充變數的一個例子：

首先，建立一個包含以下內容的 variables.tfvars 檔案：

datastore = "example_datastore"
network = "example_network"

然後在 main.tf 中定義以下內容：

variable "datastore" {
  description = "VMware datastore 名稱"
  type        = string
}

variable "network" {
  description = "VMware network 名稱"
  type        = string
}

resource "vsphere_virtual_machine" "example_vm" {
  name             = "web-server"
  datastore        = var.datastore
  network          = var.network
}

最後，執行以下命令來應用組態：

terraform apply -var-file="variables.tfvars" -var="datastore=example_datastore"
export TF_VAR_network="example_network"

內容解密：

這個例子展示瞭如何結合多種方法來設定 Terraform 中的變數。首先透過命令列標誌設定 datastore ，然後透過環境變數設定 network 。這樣做可以根據具體需求靈活調整組態。

模組化：提升基礎設施提供效率與可擴充套件性

模組化是 Terraform 的一個強大特性，允許封裝可重用的基礎設施組態。模組使得資源、變數和其他元素能夠有效地組織和包裝在一起，從而提高基礎設施提供的效率和可擴充套件性。

模組化概念介紹

模組是 Terraform 中的一個目錄結構，包含多個組態檔案。它們提供了一種封裝可重用基礎設施組態的方式。建立一個模組來提供 VMware 虛擬機器：

  1. 建立一個名為 vm_module 的目錄。
  2. 在 vm_module 中建立一個名為 main.tf 的檔案：
resource "vsphere_virtual_machine" "example_vm" {
  name          = var.vm_name
  resource_pool_id = data.vsphere_resource_pool.pool.id
  datastore_id   = data.vsphere_datastore.datastore.id
  template_uuid   = data.vsphere_virtual_machine.template.id
  num_cpus       = var.num_cpus
  memory         = var.memory

  network_interface {
    network_id   = data.vsphere_network.network.id
    adapter_type = "vmxnet3"
    ... other configurations ...
}

模組結構

模組目錄結構通常包括以下幾個檔案：

  • main.tf: 涵蓋模組所需資源及其組態。
  • variables.tf: 包含模組輸入引數定義。
  • outputs.tf: 包含模組輸出結果定義。

例如：

vm_module/
├── main.tf
├── variables.tf
└── outputs.tf

載入及使用模組

要使用上述定義的模組，建立新的 Terraform 組態檔案（如 main.tf），並參照該模組及其所需輸入引數：

module "my_vm" {
    source     = "./vm_module"
    vm_name    = "my-vm"
    num_cpus   = 2
    memory     = 4096
}

推進基礎設施供應流程

以下是使用 Terraform 提交組態、初始化並應用其以供應 VMware 資源的一些步驟：

提交組態檔案

首先需要建立一個定義所需基礎設施狀態的組態檔案（如 main.tf）：

provider "vsphere" {
    user              = var.vsphere_username
    password          = var.vsphere_password
    vsphere_server     = var.vsphere_server
    allow_unverified_ssl = true
}

resource "vsphere_virtual_machine" "example_vm" {
    name             = "my-vm"
    resource_pool_id   = data.vsphere_resource_pool.pool.id
    datastore_id      = data.vsphere_datastore.datastore.id
    template_uuid     = data.vsphere_virtual_machine.template.id
    num_cpus          = var.num_cpus
    memory            = var.memory

    network_interface {
        network_id     = data.vsphere_network.network.id,
        adapter_type   = "vmxnet3",
        ...
}

初始化及應用組態

初始化 Terraform 組態並應用其以供應資源：

terraform init

terraform apply -var-file="variables.tfvars"

推進流程最佳實踐

  1. 版本控制：將所有 Terraform 組態及其相關範本放入版本控制系統中。
  2. 自動化：利用 CI/CD 工具自動化佈署流程。
  3. 安全性：確保敏感資訊（如密碼）不直接寫入組態檔案中。
  4. 測試：使用測試環境進行充分測試以確保佈署成功。

概括與推薦實踐

玄貓總結瞭如何透過多種方法設定和管理 Terraform 中的變數以及如何透過模組化提升基礎設施供應效率與可擴充套件性。推薦實踐包括版本控制、自動化佈署、安全措施以及充分測試。希望此篇文章能夠對你在 VMware 基礎設施供應方面有所幫助。

玄貓

玄貓

技術愛好者，專注於分享程式開發、雲端技術與 AI 應用的心得體會。