Fournisseur Terraform VergeOS

Le fournisseur Terraform VergeOS permet la gestion en infrastructure as code des ressources VergeOS, notamment les VM, les réseaux et les utilisateurs, via des configurations Terraform et OpenTofu.

Vue d'ensemble

Le fournisseur Terraform VergeOS permet la gestion de votre environnement VergeOS en mode infrastructure as code. Ce fournisseur vous permet de définir, déployer et gérer des ressources VergeOS à l’aide de configurations Terraform, offrant des capacités d’automatisation pour la gestion de votre infrastructure virtuelle.

Fonctionnalités clés

• Provisionnement automatisé des machines virtuelles, réseaux, disques et utilisateurs VergeOS

• Flux de travail d’infrastructure as code pour les environnements VergeOS

• Déploiements d’infrastructure sous contrôle de version

• Intégration avec les flux de travail Terraform et OpenTofu existants

• Création et gestion d’environnements reproductibles

Installation et configuration

Pour utiliser le fournisseur Terraform VergeOS, ajoutez ce qui suit à votre configuration Terraform :

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

provider "vergeio" {
  host     = "votre-ip-ou-nom-d’hôte-vergeos"
  username = "votre-nom-d’utilisateur"
  password = "votre-mot-de-passe"
}

Pour les utilisateurs d’OpenTofu, la configuration reste identique :

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

Ressources disponibles

Le fournisseur prend en charge la gestion des ressources VergeOS suivantes :

• vergeio_vm - Créer et gérer des machines virtuelles

• vergeio_network - Configurer et gérer des réseaux virtuels

• vergeio_user - Provisionner et gérer des utilisateurs

• vergeio_member - Gérer l’appartenance aux groupes

• vergeio_tag_member - Attribuer des balises aux objets VergeOS

Exemples d’utilisation

Création d’une machine virtuelle

resource "vergeio_vm" "example" {
  name        = "example-vm"
  cpu_cores   = 2
  ram         = 4096  # Mo
  description = "Exemple de VM créée par Terraform"

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

Configuration d’un réseau

resource "vergeio_network" "example" {
  name         = "example-internal-network"
  network      = "192.168.1.0/24"
  dhcp_enabled = true
  dhcp_start   = "192.168.1.100"
  dhcp_stop    = "192.168.1.200"
}

Documentation et ressources

Pour une documentation complète, incluant toutes les ressources prises en charge, les sources de données et des exemples d’utilisation détaillés, veuillez consulter la documentation officielle du fournisseur :

• Documentation du registre Terraform

• Documentation du registre OpenTofu

• Dépôt GitHub

Support

Si vous rencontrez des problèmes ou si vous avez des demandes de fonctionnalités, veuillez ouvrir une issue dans le dépôt GitHub :

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

Ressources supplémentaires

• Documentation Terraform

• Documentation OpenTofu

• Bonnes pratiques de l’infrastructure as code