Как да разработите свой собствен доставчик в…

За да разработите собствен доставчик на Terraform, е необходимо:

Изберете език: Go - основният език за доставчиците на Terraform.
Инсталирайте SDK: Go и Terraform Plugin SDK.

Създайте структура на проекта:

# Създаване на основните файлове
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

Реализирайте доставчика: създайте файл provider.go и определете структурата Provider, включително:

Schema: определяне на параметрите за конфигурация на доставчика.
ResourcesMap: картографиране на имената на ресурсите към техните реализации.
DataSourcesMap: картографиране на имената на източниците на данни към техните реализации.

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": { // Пример за параметър за конфигурация на доставчика
				Type:        schema.TypeString,
				Optional:    true,
				DefaultFunc: schema.EnvDefaultFunc("MYPROVIDER_ENDPOINT", nil),
			},
		},
		ResourcesMap: map[string]*schema.Resource{
			"myprovider_resource": resourceMyProviderResource(), // Реализация на ресурс
		},
		DataSourcesMap: map[string]*schema.Resource{
			// Реализация на източници на данни
		},
		ConfigureContextFunc: providerConfigure, // Функция за настройка на клиента
	}
}

func providerConfigure(ctx context.Context, d *schema.ResourceData) (interface{}, diag.Diagnostics) {
	// Логика за настройка на клиента на доставчика
	return nil, nil
}

func main() {
	// Точка за вход
}

Реализирайте ресурси и източници на данни: създайте отделни файлове за всеки ресурс и източник на данни (например, resource_myprovider_resource.go). Всеки ресурс трябва да реализира функциите:

Schema: определяне на параметрите на ресурса.
Create: създаване на ресурс.
Read: четене на състоянието на ресурса.
Update: актуализиране на ресурса.
Delete: изтриване на ресурса.
Exists: проверка за съществуване на ресурса (по желание).

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": { // Пример за параметър на ресурса
                Type:     schema.TypeString,
                Required: true,
            },
        },
    }
}

func resourceMyProviderResourceCreate(ctx context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
    // Логика за създаване на ресурс
    return nil
}
// ... Реализирайте Read, Update, Delete

Компилиране: компилирайте изпълнимия файл на доставчика.
Инсталиране: поставете компилирания бинарен файл в директорията с плъгини на Terraform (~/.terraform.d/plugins/ или друго място, посочено в конфигурацията на Terraform).
Тестване: напишете Acceptance Tests за проверка на правилната работа на доставчика.

Допълнителните стъпки могат да включват:

Документиране на доставчика.
Публикуване на доставчика в Terraform Registry.
Използване на Framework вместо SDK за по-модерна разработка.

Как да разработите свой собствен доставчик в Terraform?