VergeOS Terraform-Provider

Der VergeOS Terraform-Provider ermöglicht die Infrastructure-as-Code-Verwaltung von VergeOS-Ressourcen, einschließlich VMs, Netzwerken und Benutzern, über Terraform- und OpenTofu-Konfigurationen.

Übersicht

Der VergeOS-Terraform-Provider ermöglicht die Infrastructure-as-Code-Verwaltung Ihrer VergeOS-Umgebung. Dieser Provider erlaubt es Ihnen, VergeOS-Ressourcen mithilfe von Terraform-Konfigurationen zu definieren, bereitzustellen und zu verwalten und bietet Automatisierungsfunktionen für die Verwaltung Ihrer virtuellen Infrastruktur.

Hauptmerkmale

• Automatisierte Bereitstellung von VergeOS-virtuellen Maschinen, Netzwerken, Laufwerken und Benutzern
• Infrastructure-as-Code-Workflows für VergeOS-Umgebungen
• Infrastruktur-Bereitstellungen mit Versionskontrolle
• Integration in bestehende Terraform- und OpenTofu-Workflows
• Reproduzierbare Erstellung und Verwaltung von Umgebungen

Installation und Konfiguration

Um den VergeOS-Terraform-Provider zu verwenden, fügen Sie Folgendes zu Ihrer Terraform-Konfiguration hinzu:

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

provider "vergeio" {
  host     = "your-vergeos-ip-or-hostname"
  username = "your-username"
  password = "your-password"
}

Für OpenTofu-Benutzer bleibt die Konfiguration unverändert:

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

Verfügbare Ressourcen

Der Provider unterstützt die Verwaltung der folgenden VergeOS-Ressourcen:

• vergeio_vm - Virtuelle Maschinen erstellen und verwalten
• vergeio_network - Virtuelle Netzwerke konfigurieren und verwalten
• vergeio_user - Speicherressourcen bereitstellen und verwalten

Anwendungsbeispiele

Erstellen einer virtuellen Maschine

resource "vergeio_vm" "example" {
  name        = "example-vm"
  cpu_cores   = 2
  ram         = 4096  # MB
  description = "Beispiel-VM, erstellt mit Terraform"

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

Konfigurieren eines Netzwerks

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"
  }
}

Dokumentation und Ressourcen

Die vollständige Dokumentation mit allen unterstützten Ressourcen, Datenquellen und detaillierten Anwendungsbeispielen finden Sie in der offiziellen Provider-Dokumentation:

• Terraform Registry-Dokumentation
• OpenTofu Registry-Dokumentation
• GitHub-Repository

Support

Wenn Sie auf Probleme stoßen oder Funktionswünsche haben, eröffnen Sie bitte ein Issue im GitHub-Repository:

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

Weitere Ressourcen

• Terraform-Dokumentation
• OpenTofu-Dokumentation
• Best Practices für Infrastructure as Code