Terraform VergeIO 提供程序

了解如何使用 VergeIO Terraform Provider 以编程方式管理 VergeOS 资源。

该 Terraform VergeIO 提供程序 可实现 VergeOS 基础设施与 Terraform的集成和自动化。它允许用户将 VergeOS 资源定义、管理和扩展，作为基础设施即代码（IaC）工作流的一部分。

有关最新的提供程序文档和示例，请参阅以下内容：

• GitHub 仓库 适用于 VergeIO Terraform 提供程序。
• Terraform Registry 文档 用于官方用法和更新。

---

示例用法

如需更详细的使用示例，请查看 docs 文件夹 在 GitHub 仓库中。

示例配置

provider "vergeio" {
  host     = "https://some_url_or_ip"
  username = "my_user"
  password = "my_password"
  insecure = false  # 如果使用自签名 SSL 证书，则使用 true
}

resource "vergeio_vm" "new_vm" {
  name        = "NEW VM"
  description = "NEW TF VM"
  enabled     = true
  os_family   = "linux"
  cpu_cores   = 4
  machine_type = "q35"
  ram         = 8192
}

初始化并应用

要应用该配置：

terraform init && terraform apply

配置参考

host（必填）：VergeOS 系统或租户的 URL 或 IP 地址。
username（必填）：VergeOS 系统或租户的用户名。
password（必填）：所提供用户名的密码。
insecure（可选）：对于使用自签名 SSL 证书的系统，请设为 true。

资源

以下 VergeOS 资源可以通过 Terraform 进行管理：

vergeio_drive
vergeio_member
vergeio_network
vergeio_nic
vergeio_user
vergeio_vm

数据源

以下数据源可用于查询 VergeOS 资源：

vergeio_clusters
vergeio_groups
vergeio_mediasources
vergeio_networks
vergeio_nodes
vergeio_version
vergeio_vms

测试示例配置

要测试您的配置，请在 Terraform 工作区中创建一个 main.tf 文件：

terraform {
  required_providers {
    vergeio = {
      source = "vergeio/cloud/vergeio"
    }
  }
}

provider "vergeio" {
  host     = "https://someURLorIP"
  username = "username"
  password = "password"
}

resource "vergeio_vm" "new_vm" {
  name        = "NEW VM"
  description = "NEW TF VM"
  enabled     = true
  os_family   = "linux"
  cpu_cores   = 4
  machine_type = "q35"
  ram         = 8192
}

然后，运行以下命令：

terraform init && terraform apply

---

文档信息

• 最后更新：2024-09-03
• VergeOS 版本：4.12.6