Jak vyvinout vlastního poskytovatele v Terraformu?

Pro vývoj vlastního poskytovatele Terraform je třeba:

1. Vybrat jazyk: Go - hlavní jazyk pro poskytovatele Terraform.

2. Nainstalovat SDK: Go a Terraform Plugin SDK.

3. Vytvořit strukturu projektu:

   # Vytvoření základních souborů
   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
   

4. Implementovat poskytovatele: vytvořte soubor provider.go a definujte strukturu Provider, včetně:

   • Schema: definice konfiguračních parametrů poskytovatele.
   • ResourcesMap: mapování názvů zdrojů na jejich implementace.
   • DataSourcesMap: mapování názvů zdrojů dat na jejich implementace.

   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": { // Příklad konfiguračního parametru poskytovatele
   				Type:        schema.TypeString,
   				Optional:    true,
   				DefaultFunc: schema.EnvDefaultFunc("MYPROVIDER_ENDPOINT", nil),
   			},
   		},
   		ResourcesMap: map[string]*schema.Resource{
   			"myprovider_resource": resourceMyProviderResource(), // Implementace zdroje
   		},
   		DataSourcesMap: map[string]*schema.Resource{
   			// Implementace zdrojů dat
   		},
   		ConfigureContextFunc: providerConfigure, // Funkce pro konfiguraci klienta
   	}
   }
   
   func providerConfigure(ctx context.Context, d *schema.ResourceData) (interface{}, diag.Diagnostics) {
   	// Logika konfigurace klienta poskytovatele
   	return nil, nil
   }
   
   func main() {
   	// Vstupní bod
   }
   

5. Implementovat zdroje a zdroje dat: vytvořte samostatné soubory pro každý zdroj a zdroj dat (například resource_myprovider_resource.go). Každý zdroj by měl implementovat funkce:

   • Schema: definice parametrů zdroje.
   • Create: vytvoření zdroje.
   • Read: čtení stavu zdroje.
   • Update: aktualizace zdroje.
   • Delete: odstranění zdroje.
   • Exists: kontrola existence zdroje (volitelné).

   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": { // Příklad parametru zdroje
                   Type:     schema.TypeString,
                   Required: true,
               },
           },
       }
   }
   
   func resourceMyProviderResourceCreate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
       // Logika vytvoření zdroje
       return nil
   }
   // ... Implementace Read, Update, Delete
   

6. Kompilace: sestavte spustitelný soubor poskytovatele.

7. Instalace: umístěte zkompilovaný binární soubor do adresáře pluginů Terraform (~/.terraform.d/plugins/ nebo jiného místa uvedeného v konfiguraci Terraform).

8. Testování: napište Acceptance Tests pro ověření správné funkčnosti poskytovatele.

Další kroky mohou zahrnovat:

• Dokumentaci poskytovatele.
• Publikaci poskytovatele v Terraform Registry.
• Použití Framework místo SDK pro modernější vývoj.