Fournisseur Terraform VergeIO

Apprenez à utiliser le fournisseur Terraform VergeIO pour gérer programmatiquement les ressources VergeOS.

Le Fournisseur Terraform VergeIO permet l’intégration et l’automatisation de l’infrastructure VergeOS avec Terraform. Il permet aux utilisateurs de définir, gérer et faire évoluer les ressources VergeOS dans le cadre de workflows Infrastructure as Code (IaC).

Pour la documentation la plus récente du fournisseur et des exemples, veuillez consulter les éléments suivants :

• Dépôt GitHub pour le fournisseur Terraform VergeIO.
• Documentation du registre Terraform pour l’utilisation officielle et les mises à jour.

---

Exemple d’utilisation

Pour des exemples d’utilisation plus détaillés, consultez le dossier docs dans le dépôt GitHub.

Exemple de configuration

provider "vergeio" {
  host     = "https://some_url_or_ip"
  username = "my_user"
  password = "my_password"
  insecure = false  # Utilisez true si vous utilisez des certificats SSL auto-signés
}

resource "vergeio_vm" "new_vm" {
  name        = "NOUVELLE VM"
  description = "NOUVELLE VM TF"
  enabled     = true
  os_family   = "linux"
  cpu_cores   = 4
  machine_type = "q35"
  ram         = 8192
}

Initialisation et application

Pour appliquer la configuration :

terraform init && terraform apply

Référence de configuration

host (Obligatoire) : URL ou adresse IP du système ou du locataire VergeOS.
username (Obligatoire) : Nom d’utilisateur du système ou du locataire VergeOS.
password (Obligatoire) : Mot de passe correspondant au nom d’utilisateur fourni.
insecure (Facultatif) : Définissez sur true pour les systèmes utilisant des certificats SSL auto-signés.

Ressources

Les ressources VergeOS suivantes peuvent être gérées via Terraform :

vergeio_drive
vergeio_member
vergeio_network
vergeio_nic
vergeio_user
vergeio_vm

Sources de données

Les sources de données suivantes sont disponibles pour interroger les ressources VergeOS :

vergeio_clusters
vergeio_groups
vergeio_mediasources
vergeio_networks
vergeio_nodes
vergeio_version
vergeio_vms

Test d’une configuration d’exemple

Pour tester votre configuration, créez un fichier main.tf dans votre espace de travail Terraform :

terraform {
  required_providers {
    vergeio = {
      source = "vergeio/cloud/vergeio"
    }
  }
}

provider "vergeio" {
  host     = "https://someURLorIP"
  username = "username"
  password = "password"
}

resource "vergeio_vm" "new_vm" {
  name        = "NOUVELLE VM"
  description = "NOUVELLE VM TF"
  enabled     = true
  os_family   = "linux"
  cpu_cores   = 4
  machine_type = "q35"
  ram         = 8192
}

Ensuite, exécutez la commande suivante :

terraform init && terraform apply

---

Informations sur le document

• Dernière mise à jour : 2024-09-03
• Version de VergeOS : 4.12.6