Jak opracować własnego dostawcę w Terraform?

Aby opracować własnego dostawcę Terraform, konieczne jest:

1. Wybrać język: Go - główny język dla dostawców Terraform.

2. Zainstalować SDK: Go i Terraform Plugin SDK.

3. Utworzyć strukturę projektu:

   # Tworzenie podstawowych plików
   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. Zaimplementować dostawcę: utwórz plik provider.go i zdefiniuj strukturę Provider, w tym:

   • Schema: definicja parametrów konfiguracyjnych dostawcy.
   • ResourcesMap: mapowanie nazw zasobów na ich implementacje.
   • DataSourcesMap: mapowanie nazw źródeł danych na ich implementacje.

   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": { // Przykład parametru konfiguracyjnego dostawcy
   				Type:        schema.TypeString,
   				Optional:    true,
   				DefaultFunc: schema.EnvDefaultFunc("MYPROVIDER_ENDPOINT", nil),
   			},
   		},
   		ResourcesMap: map[string]*schema.Resource{
   			"myprovider_resource": resourceMyProviderResource(), // Implementacja zasobu
   		},
   		DataSourcesMap: map[string]*schema.Resource{
   			// Implementacja źródeł danych
   		},
   		ConfigureContextFunc: providerConfigure, // Funkcja konfiguracji klienta
   	}
   }
   
   func providerConfigure(ctx context.Context, d *schema.ResourceData) (interface{}, diag.Diagnostics) {
   	// Logika konfiguracji klienta dostawcy
   	return nil, nil
   }
   
   func main() {
   	// Punkt wejścia
   }
   

5. Implementować zasoby i źródła danych: utwórz oddzielne pliki dla każdego zasobu i źródła danych (np. resource_myprovider_resource.go). Każdy zasób musi implementować funkcje:

   • Schema: definicja parametrów zasobu.
   • Create: tworzenie zasobu.
   • Read: odczyt stanu zasobu.
   • Update: aktualizacja zasobu.
   • Delete: usunięcie zasobu.
   • Exists: sprawdzanie istnienia zasobu (opcjonalnie).

   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": { // Przykład parametru zasobu
                   Type:     schema.TypeString,
                   Required: true,
               },
           },
       }
   }
   
   func resourceMyProviderResourceCreate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
       // Logika tworzenia zasobu
       return nil
   }
   // ... Implementacja odczytu, aktualizacji, usuwania
   

6. Kompilacja: zbuduj plik wykonywalny dostawcy.

7. Instalacja: umieść skompilowany plik binarny w katalogu wtyczek Terraform (~/.terraform.d/plugins/ lub innym miejscu wskazanym w konfiguracji Terraform).

8. Testowanie: napisz testy akceptacyjne, aby sprawdzić poprawność działania dostawcy.

Dodatkowe kroki mogą obejmować:

• Dokumentację dostawcy.
• Publikację dostawcy w Terraform Registry.
• Użycie Framework zamiast SDK dla bardziej nowoczesnego rozwoju.