Proveedor Terraform de VergeIO

Aprenda a usar el proveedor Terraform de VergeIO para gestionar recursos de VergeOS de forma programática.

El Proveedor de Terraform de VergeIO permite la integración y automatización de la infraestructura de VergeOS con Terraform. Permite a los usuarios definir, gestionar y escalar recursos de VergeOS como parte de flujos de trabajo de Infraestructura como Código (IaC).

Para la documentación y los ejemplos más recientes del proveedor, consulte lo siguiente:

• Repositorio de GitHub para el proveedor Terraform de VergeIO.
• Documentación del Registro de Terraform para uso oficial y actualizaciones.

---

Ejemplo de uso

Para ejemplos de uso más detallados, consulte la carpeta docs en el repositorio de GitHub.

Configuración de ejemplo

provider "vergeio" {
  host     = "https://some_url_or_ip"
  username = "my_user"
  password = "my_password"
  insecure = false  # Use true si utiliza certificados SSL autofirmados
}

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
}

Inicialización y aplicación

Para aplicar la configuración:

terraform init && terraform apply

Referencia de configuración

host (Required): URL o dirección IP del sistema o inquilino de VergeOS.
username (Required): Nombre de usuario para el sistema o inquilino de VergeOS.
password (Required): Contraseña para el nombre de usuario proporcionado.
insecure (Optional): Establézcalo en true para sistemas que usan certificados SSL autofirmados.

Recursos

Los siguientes recursos de VergeOS se pueden administrar mediante Terraform:

vergeio_drive
vergeio_member
vergeio_network
vergeio_nic
vergeio_user
vergeio_vm

Fuentes de datos

Las siguientes fuentes de datos están disponibles para consultar recursos de VergeOS:

vergeio_clusters
vergeio_groups
vergeio_mediasources
vergeio_networks
vergeio_nodes
vergeio_version
vergeio_vms

Prueba de una configuración de ejemplo

Para probar su configuración, cree un archivo main.tf en su espacio de trabajo de Terraform:

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
}

Luego, ejecute el siguiente comando:

terraform init && terraform apply

---

Información del documento

• Última actualización: 2024-09-03
• Versión de VergeOS: 4.12.6