Come sviluppare il proprio provider in Terraform…

Per sviluppare il proprio provider Terraform, è necessario:

Scegliere il linguaggio: Go - linguaggio principale per i provider Terraform.
Installare SDK: Go e Terraform Plugin SDK.

Creare la struttura del progetto:

# Creare file di 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

Implementare il provider: creare un file provider.go e definire la struttura Provider, includendo:

Schema: definizione dei parametri di configurazione del provider.
ResourcesMap: mappatura dei nomi delle risorse alle loro implementazioni.
DataSourcesMap: mappatura dei nomi delle fonti di dati alle loro implementazioni.

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": { // Esempio di parametro di configurazione del provider
				Type:        schema.TypeString,
				Optional:    true,
				DefaultFunc: schema.EnvDefaultFunc("MYPROVIDER_ENDPOINT", nil),
			},
		},
		ResourcesMap: map[string]*schema.Resource{
			"myprovider_resource": resourceMyProviderResource(), // Implementazione risorsa
		},
		DataSourcesMap: map[string]*schema.Resource{
			// Implementazione fonti dati
		},
		ConfigureContextFunc: providerConfigure, // Funzione di configurazione client
	}
}

func providerConfigure(ctx context.Context, d *schema.ResourceData) (interface{}, diag.Diagnostics) {
	// Logica di configurazione del client
	return nil, nil
}

func main() {
	// Entry point
}

Implementare risorse e fonti dati: creare file separati per ogni risorsa e fonte dati (ad esempio, resource_myprovider_resource.go). Ogni risorsa deve implementare funzioni:

Schema: definizione dei parametri della risorsa.
Create: creazione della risorsa.
Read: lettura dello stato della risorsa.
Update: aggiornamento della risorsa.
Delete: eliminazione della risorsa.
Exists: verifica dell'esistenza della risorsa (opzionale).

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": { // Esempio di parametro risorsa
                Type:     schema.TypeString,
                Required: true,
            },
        },
    }
}

func resourceMyProviderResourceCreate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
    // Logica di creazione risorsa
    return nil
}
// ... Implementazione di Read, Update, Delete

Compilare: costruire il file eseguibile del provider.
Installare: posizionare il file binario compilato nella directory dei plugin di Terraform (~/.terraform.d/plugins/ o altro percorso specificato nella configurazione Terraform).
Testare: scrivere test di accettazione per verificare il corretto funzionamento del provider.

Passaggi aggiuntivi possono includere:

Documentare il provider.
Pubblicare il provider nel Terraform Registry.
Utilizzare Framework invece di SDK per uno sviluppo più moderno.

Come sviluppare il proprio provider in Terraform?