Hoe ontwikkel je je eigen provider in Terraform…

Om je eigen Terraform-provider te ontwikkelen, zijn de volgende stappen nodig:

Kies de taal: Go - de hoofdtaal voor Terraform-providers.
Installeer SDK: Go en Terraform Plugin SDK.

Maak de projectstructuur aan:

# Maak basisbestanden
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

Implementeer de provider: maak een bestand provider.go en definieer de Provider-structuur, inclusief:

Schema: definitie van de configuratieparameters van de provider.
ResourcesMap: mapping van resource-namen naar hun implementaties.
DataSourcesMap: mapping van databasissenamen naar hun implementaties.

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": { // Voorbeeld van een configuratieparameter
				Type:        schema.TypeString,
				Optional:    true,
				DefaultFunc: schema.EnvDefaultFunc("MYPROVIDER_ENDPOINT", nil),
			},
		},
		ResourcesMap: map[string]*schema.Resource{
			"myprovider_resource": resourceMyProviderResource(), // Resource-implementatie
		},
		DataSourcesMap: map[string]*schema.Resource{
			// Implementatie van databasissen
		},
		ConfigureContextFunc: providerConfigure, // Functie voor clientconfiguratie
	}
}

func providerConfigure(ctx context.Context, d *schema.ResourceData) (interface{}, diag.Diagnostics) {
	// Logica voor het configureren van de client
	return nil, nil
}

func main() {
	// Ingangspunt
}

Implementeer resources en databasissen: maak aparte bestanden voor elke resource en database (bijvoorbeeld resource_myprovider_resource.go). Elke resource moet functies implementeren:

Schema: definitie van de resourceparameters.
Create: resource aanmaken.
Read: status van de resource lezen.
Update: resource bijwerken.
Delete: resource verwijderen.
Exists: controleer of de resource bestaat (optioneel).

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": { // Voorbeeld van resourceparameter
                Type:     schema.TypeString,
                Required: true,
            },
        },
    }
}

func resourceMyProviderResourceCreate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
    // Logica voor resource creatie
    return nil
}
// ... Implementatie van Read, Update, Delete

Compileer: bouw het uitvoerbare bestand van de provider.
Installeer: plaats het gecompileerde binaire bestand in de Terraform-pluginsmap (~/.terraform.d/plugins/ of een andere locatie die in de Terraform-configuratie is opgegeven).
Test: schrijf Acceptance Tests om de correcte werking van de provider te controleren.

Aanvullende stappen kunnen onder meer zijn:

Documenteer de provider.
Publiceer de provider in Terraform Registry.
Gebruik Framework in plaats van SDK voor een meer moderne ontwikkeling.

Hoe ontwikkel je je eigen provider in Terraform?