Comment développer votre propre fournisseur dans…

Pour développer votre propre fournisseur Terraform, vous devez:

Choisir le langage : Go, qui est le langage principal pour les fournisseurs Terraform.
Installer le SDK : Go et Terraform Plugin SDK.

Créer la structure du projet :

# Créer des fichiers de base
mkdir terraform-provider-myprovider
cd terraform-provider-myprovider
go mod init github.com/myorg/terraform-provider-myprovider
go get github.com/hashicorp/terraform-plugin-sdk/v2

Implémenter le fournisseur : créer un fichier provider.go et définir la structure Provider, y compris :

Schema : définition des paramètres de configuration du fournisseur.
ResourcesMap : mappage des noms de ressources à leurs implémentations.
DataSourcesMap : mappage des noms des sources de données à leurs implémentations.

package main

import (
	"context"

	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
)

func Provider() *schema.Provider {
	return &schema.Provider{
		Schema: map[string]*schema.Schema{
			"endpoint": { // Exemple de paramètre de configuration du fournisseur
				Type:        schema.TypeString,
				Optional:    true,
				DefaultFunc: schema.EnvDefaultFunc("MYPROVIDER_ENDPOINT", nil),
			},
		},
		ResourcesMap: map[string]*schema.Resource{
			"myprovider_resource": resourceMyProviderResource(), // Implémentation de la ressource
		},
		DataSourcesMap: map[string]*schema.Resource{
			// Implémentation des sources de données
		},
		ConfigureContextFunc: providerConfigure, // Fonction de configuration du client
	}
}

func providerConfigure(ctx context.Context, d *schema.ResourceData) (interface{}, diag.Diagnostics) {
	// Logique de configuration du client du fournisseur
	return nil, nil
}

func main() {
	// Point d'entrée
}

Implémenter les ressources et sources de données : créer des fichiers séparés pour chaque ressource et source de données (par exemple, resource_myprovider_resource.go). Chaque ressource doit implémenter des fonctions :

Schema : définition des paramètres de la ressource.
Create : création de la ressource.
Read : lecture de l'état de la ressource.
Update : mise à jour de la ressource.
Delete : suppression de la ressource.
Exists : vérification de l'existence de la ressource (optionnel).

package main

import (
    "context"

    "github.com/hashicorp/terraform-plugin-sdk/v2/diag"
    "github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
)

func resourceMyProviderResource() *schema.Resource {
    return &schema.Resource{
        CreateContext: resourceMyProviderResourceCreate,
        ReadContext:   resourceMyProviderResourceRead,
        UpdateContext: resourceMyProviderResourceUpdate,
        DeleteContext: resourceMyProviderResourceDelete,
        Schema: map[string]*schema.Schema{
            "name": { // Exemple de paramètre de la ressource
                Type:     schema.TypeString,
                Required: true,
            },
        },
    }
}

func resourceMyProviderResourceCreate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
    // Logique de création de la ressource
    return nil
}
// ... Implémentation de Read, Update, Delete

Compiler : construire le fichier exécutable du fournisseur.
Installer : placer le fichier binaire compilé dans le répertoire des plugins Terraform (~/.terraform.d/plugins/ ou autre endroit spécifié dans la configuration Terraform).
Tester : écrire des tests d'acceptation pour vérifier le bon fonctionnement du fournisseur.

Les étapes supplémentaires peuvent inclure :

Documenter le fournisseur.
Publier le fournisseur dans Terraform Registry.
Utiliser un framework au lieu du SDK pour un développement plus moderne.

Comment développer votre propre fournisseur dans Terraform?