Terraform-VergeIO-Provider

Erfahren Sie, wie Sie den VergeIO Terraform Provider verwenden, um VergeOS-Ressourcen programmgesteuert zu verwalten.

Der Terraform VergeIO-Provider ermöglicht die Integration und Automatisierung der VergeOS-Infrastruktur mit Terraform. Es ermöglicht Benutzern, VergeOS-Ressourcen als Teil von Infrastructure-as-Code-(IaC)-Workflows zu definieren, zu verwalten und zu skalieren.

Für die neueste Provider-Dokumentation und Beispiele beachten Sie bitte Folgendes:

• GitHub-Repository für den VergeIO Terraform Provider.
• Terraform-Registry-Dokumentation für offizielle Nutzung und Aktualisierungen.

---

Beispielverwendung

Für ausführlichere Anwendungsbeispiele sehen Sie sich den docs-Ordner im GitHub-Repository an.

Beispielkonfiguration

provider "vergeio" {
  host     = "https://some_url_or_ip"
  username = "my_user"
  password = "my_password"
  insecure = false  # Verwenden Sie true, wenn Sie selbstsignierte SSL-Zertifikate verwenden
}

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
}

Initialisierung und Anwenden

Um die Konfiguration anzuwenden:

terraform init && terraform apply

Konfigurationsreferenz

host (Erforderlich): URL oder IP-Adresse für das VergeOS-System oder den Mandanten.
username (Erforderlich): Benutzername für das VergeOS-System oder den Mandanten.
password (Erforderlich): Passwort für den angegebenen Benutzernamen.
insecure (Optional): Auf true setzen für Systeme mit selbstsignierten SSL-Zertifikaten.

Ressourcen

Die folgenden VergeOS-Ressourcen können über Terraform verwaltet werden:

vergeio_drive
vergeio_member
vergeio_network
vergeio_nic
vergeio_user
vergeio_vm

Datenquellen

Die folgenden Datenquellen stehen zur Abfrage von VergeOS-Ressourcen zur Verfügung:

vergeio_clusters
vergeio_groups
vergeio_mediasources
vergeio_networks
vergeio_nodes
vergeio_version
vergeio_vms

Testen einer Beispielkonfiguration

Um Ihre Konfiguration zu testen, erstellen Sie eine main.tf-Datei in Ihrem Terraform-Arbeitsbereich:

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
}

Führen Sie dann den folgenden Befehl aus:

terraform init && terraform apply

---

Dokumentinformationen

• Zuletzt aktualisiert: 2024-09-03
• VergeOS-Version: 4.12.6