Proveedor Terraform de VergeOS

El Proveedor Terraform de VergeOS permite la gestión de infraestructura como código de los recursos de VergeOS, incluidas las VM, las redes y los usuarios mediante configuraciones de Terraform y OpenTofu.

Descripción general

El proveedor de Terraform de VergeOS permite la gestión de tu entorno VergeOS mediante infraestructura como código. Este proveedor te permite definir, desplegar y administrar recursos de VergeOS usando configuraciones de Terraform, proporcionando capacidades de automatización para la gestión de tu infraestructura virtual.

Características clave

• Aprovisionamiento automatizado de máquinas virtuales, redes, unidades y usuarios de VergeOS
• Flujos de trabajo de infraestructura como código para entornos VergeOS
• Implementaciones de infraestructura controladas por versiones
• Integración con los flujos de trabajo existentes de Terraform y OpenTofu
• Creación y gestión reproducibles de entornos

Instalación y configuración

Para usar el proveedor de Terraform de VergeOS, añade lo siguiente a tu configuración de Terraform:

terraform {
  required_providers {
    vergeio = {
      source = "verge-io/vergeio"
      version = "~> 0.1.0"
    }
  }
}

provider "vergeio" {
  host     = "tu-ip-o-nombre-de-host-de-vergeos"
  username = "tu-nombre-de-usuario"
  password = "tu-contraseña"
}

Para los usuarios de OpenTofu, la configuración sigue siendo la misma:

terraform {
  required_providers {
    vergeio = {
      source = "verge-io/vergeio"
      version = "~> 0.1.0"
    }
  }
}

Recursos disponibles

El proveedor admite la administración de los siguientes recursos de VergeOS:

• vergeio_vm - Crear y administrar máquinas virtuales
• vergeio_network - Configurar y administrar redes virtuales
• vergeio_user - Aprovisionar y administrar recursos de almacenamiento

Ejemplos de uso

Creación de una máquina virtual

resource "vergeio_vm" "example" {
  name        = "example-vm"
  cpu_cores   = 2
  ram         = 4096  # MB
  description = "Máquina virtual de ejemplo creada por Terraform"

  
  vergeio_drive {
    disksize            = 20  #GB
    interface           = "virtio-scsi"
    preferred_tier      = 2
  }
  
  vergeio_nic {
    vnet       = vergeio_network.example.id
    interface  = "virtio"
  }
}

Configuración de una red

resource "vergeio_network" "example" {
  name             = "example-internal-network"
  network_address  = "192.168.1.0/24"
  dns_server_list  = ["8.8.8.8", "8.8.4.4"]
  dhcp_enabled     = true
  dhcp_start       = "192.168.1.100"
  dhcp_end         = "192.168.1.200"
  }
}

Documentación y recursos

Para consultar la documentación completa, incluidos todos los recursos compatibles, las fuentes de datos y ejemplos de uso detallados, visita la documentación oficial del proveedor:

• Documentación del registro de Terraform
• Documentación del registro de OpenTofu
• Repositorio de GitHub

Soporte

Si encuentra problemas o tiene solicitudes de funciones, abra un issue en el repositorio de GitHub:

https://github.com/verge-io/terraform-provider-vergeio/issues

Recursos adicionales

• Documentación de Terraform
• Documentación de OpenTofu
• Mejores prácticas de infraestructura como código