Terraform-Anbieter

Der Terraform-Provider ermöglicht Ihnen die Verwaltung Ihrer Devolutions Server-Instanz. Um mehr über den Terraform-Provider zu erfahren, konsultieren Sie unser GitHub.

Dieser Provider befindet sich in Arbeit; rechnen Sie mit Breaking Changes zwischen den Releases.

Anforderungen

• Terraform 1.0
• Go 1.18
• Devolutions Server 2025.2.4.0

Erstellen des Providers

1. Klonen Sie das Repository
2. Wechseln Sie in das Repository-Verzeichnis
3. Erstellen Sie den Provider mit dem Go-Befehl install:

go install

Hinzufügen von Abhängigkeiten

Dieser Provider verwendet Go-Module. Bitte konsultieren Sie die Go-Dokumentation für die aktuellsten Informationen zur Verwendung von Go-Modulen.

So fügen Sie eine neue Abhängigkeit github.com/author/dependency zu Ihrem Terraform-Provider hinzu:

go get github.com/author/dependency
go mod tidy

Übertragen Sie dann die Änderungen an go.mod und go.sum.

Verwenden des Providers

Besuchen Sie das Terraform Registry unter https://registry.terraform.io/providers/Devolutions/dvls/latest für Informationen zur Verwendung.

Entwickeln des Providers

Wenn Sie am Provider arbeiten möchten, müssen Sie zunächst Go auf Ihrem Rechner installieren (siehe Anforderungen oben).

• Um den Provider zu kompilieren, führen Sie go install aus. Damit wird der Provider erstellt und die Provider-Binärdatei im Verzeichnis $GOPATH/bin abgelegt.
• Um Dokumentation zu generieren oder zu aktualisieren, führen Sie go generate aus.
• Um die vollständige Suite der Acceptance Tests auszuführen, führen Sie make testacc aus.

Hinweis: Acceptance Tests erstellen echte Ressourcen und verursachen häufig Kosten.

make testacc

Testen des Providers während der Entwicklung

Um einen Test des Providers durchzuführen, erstellen bzw. aktualisieren Sie die Datei ~/.terraformrc (%APPDATA%\terraform.rc unter Windows) mit folgendem Inhalt:

provider_installation {
  dev_overrides {
    "devolutions/dvls" = "/Users/USERNAME/go/bin"
  }
  direct {
  }
}

Ersetzen Sie /Users/USERNAME/go/bin durch den Pfad zur kompilierten Provider-Binärdatei entsprechend Ihrem Betriebssystem und Ihrer Umgebung.

Führen Sie dann den folgenden Befehl aus, sofern Sie macOS oder Linux verwenden:

go build -o ~/go/bin/terraform-provider-dvls_v0.5.0

chmod +x ~/go/bin/terraform-provider-dvls_v0.5.0

Hinweise: Die Versionsnummer sollte mit der Version des Providers übereinstimmen, an dem Sie arbeiten.

Sie können dann eine Datei test.tf oder example.tf mit dem erforderlichen Inhalt erstellen; hier ist ein Beispiel:

provider "dvls" {
  base_uri   = "https://your-dvls-instance.com/"
  app_id     = "your-app-id"
  app_secret = "your-app-secret"
}

data "dvls_entry_website" "example" {
  id = "id-of-website-entry"
}

output "website_name" {
  value = data.dvls_entry_website.example.name
}

terraform {
  required_providers {
    dvls = {
      source = "devolutions/dvls"
    }
  }
}

Führen Sie dann den folgenden Befehl aus:

terraform plan

Dies wird die Ausgabe sein:

│ Warning: Provider development overrides are in effect
│
│ The following provider development overrides are set in the CLI configuration:
│  - devolutions/dvls in /Users/USERNAME/go/bin
│
│ The behavior may therefore not match any released version of the provider and applying changes may cause the state to become incompatible
│ with published releases.
╵
data.dvls_entry_website.example: Reading...
data.dvls_entry_website.example: Read complete after 1s [id=123e4567-e89b-12d3-a456-426614174000]

Changes to Outputs:
  + website_name = "TestWebsite"

Bitte beachten Sie, dass die .gitignore die Dateien dev.tfrc, .terraform.lock.hcl, test.tf, example.tf und terraform.tfstate sowie den Ordner .terraform/ bereits ignoriert.