terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/instance/resource.go

package postgresflexalpha

import (
	"context"
	_ "embed"
	"fmt"
	"math"
	"net/http"
	"strings"

	"github.com/hashicorp/terraform-plugin-framework/path"
	"github.com/hashicorp/terraform-plugin-framework/resource"
	"github.com/hashicorp/terraform-plugin-framework/resource/identityschema"
	"github.com/hashicorp/terraform-plugin-framework/types"
	"github.com/hashicorp/terraform-plugin-log/tflog"
	"github.com/stackitcloud/stackit-sdk-go/core/oapierror"

	postgresflex "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/pkg_gen/postgresflexalpha"
	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/conversion"
	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/core"
	postgresflexalpha "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/instance/resources_gen"
	postgresflexUtils "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/utils"
	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/utils"
	wait "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/wait/postgresflexalpha"
)

// Ensure the implementation satisfies the expected interfaces.
var (
	_ resource.Resource                   = &instanceResource{}
	_ resource.ResourceWithConfigure      = &instanceResource{}
	_ resource.ResourceWithImportState    = &instanceResource{}
	_ resource.ResourceWithModifyPlan     = &instanceResource{}
	_ resource.ResourceWithValidateConfig = &instanceResource{}
	_ resource.ResourceWithIdentity       = &instanceResource{}
)

// NewInstanceResource is a helper function to simplify the provider implementation.
func NewInstanceResource() resource.Resource {
	return &instanceResource{}
}

// resourceModel describes the resource data model.
type resourceModel = postgresflexalpha.InstanceModel

type InstanceResourceIdentityModel struct {
	ProjectID  types.String `tfsdk:"project_id"`
	Region     types.String `tfsdk:"region"`
	InstanceID types.String `tfsdk:"instance_id"`
}

// instanceResource is the resource implementation.
type instanceResource struct {
	client       *postgresflex.APIClient
	providerData core.ProviderData
}

func (r *instanceResource) ValidateConfig(
	ctx context.Context,
	req resource.ValidateConfigRequest,
	resp *resource.ValidateConfigResponse,
) {
	var data resourceModel
	resp.Diagnostics.Append(req.Config.Get(ctx, &data)...)

	if resp.Diagnostics.HasError() {
		return
	}

	if data.Replicas.IsNull() || data.Replicas.IsUnknown() {
		resp.Diagnostics.AddAttributeWarning(
			path.Root("replicas"),
			"Missing Attribute Configuration",
			"Expected replicas to be configured. "+
				"The resource may return unexpected results.",
		)
	}
}

// ModifyPlan implements resource.ResourceWithModifyPlan.
// Use the modifier to set the effective region in the current plan.
func (r *instanceResource) ModifyPlan(
	ctx context.Context,
	req resource.ModifyPlanRequest,
	resp *resource.ModifyPlanResponse,
) { // nolint:gocritic // function signature required by Terraform
	var configModel resourceModel
	// skip initial empty configuration to avoid follow-up errors
	if req.Config.Raw.IsNull() {
		return
	}
	resp.Diagnostics.Append(req.Config.Get(ctx, &configModel)...)
	if resp.Diagnostics.HasError() {
		return
	}

	var planModel resourceModel
	resp.Diagnostics.Append(req.Plan.Get(ctx, &planModel)...)
	if resp.Diagnostics.HasError() {
		return
	}

	utils.AdaptRegion(ctx, configModel.Region, &planModel.Region, r.providerData.GetRegion(), resp)
	if resp.Diagnostics.HasError() {
		return
	}

	resp.Diagnostics.Append(resp.Plan.Set(ctx, planModel)...)
	if resp.Diagnostics.HasError() {
		return
	}
}

// Metadata returns the resource type name.
func (r *instanceResource) Metadata(_ context.Context, req resource.MetadataRequest, resp *resource.MetadataResponse) {
	resp.TypeName = req.ProviderTypeName + "_postgresflexalpha_instance"
}

// Configure adds the provider configured client to the resource.
func (r *instanceResource) Configure(
	ctx context.Context,
	req resource.ConfigureRequest,
	resp *resource.ConfigureResponse,
) {
	var ok bool
	r.providerData, ok = conversion.ParseProviderData(ctx, req.ProviderData, &resp.Diagnostics)
	if !ok {
		return
	}

	apiClient := postgresflexUtils.ConfigureClient(ctx, &r.providerData, &resp.Diagnostics)
	if resp.Diagnostics.HasError() {
		return
	}
	r.client = apiClient
	tflog.Info(ctx, "Postgres Flex instance client configured")
}

/*
  until tfplugingen framework can handle plan modifiers, we use a function to add them
*/

//go:embed planModifiers.yaml
var modifiersFileByte []byte

// Schema defines the schema for the resource.
func (r *instanceResource) Schema(ctx context.Context, _ resource.SchemaRequest, resp *resource.SchemaResponse) {
	schema := postgresflexalpha.InstanceResourceSchema(ctx)
	fields, err := utils.ReadModifiersConfig(modifiersFileByte)
	if err != nil {
		resp.Diagnostics.AddError("error during read modifiers config file", err.Error())
		return
	}

	err = utils.AddPlanModifiersToResourceSchema(fields, &schema)
	if err != nil {
		resp.Diagnostics.AddError("error adding plan modifiers", err.Error())
		return
	}
	resp.Schema = schema
}

func (r *instanceResource) IdentitySchema(
	_ context.Context,
	_ resource.IdentitySchemaRequest,
	resp *resource.IdentitySchemaResponse,
) {
	resp.IdentitySchema = identityschema.Schema{
		Attributes: map[string]identityschema.Attribute{
			"project_id": identityschema.StringAttribute{
				RequiredForImport: true, // must be set during import by the practitioner
			},
			"region": identityschema.StringAttribute{
				RequiredForImport: true, // can be defaulted by the provider configuration
			},
			"instance_id": identityschema.StringAttribute{
				RequiredForImport: true, // can be defaulted by the provider configuration
			},
		},
	}
}

// Create creates the resource and sets the initial Terraform state.
func (r *instanceResource) Create(
	ctx context.Context,
	req resource.CreateRequest,
	resp *resource.CreateResponse,
) { // nolint:gocritic // function signature required by Terraform
	var model resourceModel

	diags := req.Plan.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	projectId := model.ProjectId.ValueString()
	region := model.Region.ValueString()
	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "region", region)

	var netAcl []string
	diag := model.Network.Acl.ElementsAs(ctx, &netAcl, false)
	resp.Diagnostics.Append(diags...)
	if diag.HasError() {
		return
	}

	if model.Replicas.ValueInt64() > math.MaxInt32 {
		resp.Diagnostics.AddError("invalid int32 value", "provided int64 value does not fit into int32")
		return
	}
	replVal := int32(model.Replicas.ValueInt64()) // nolint:gosec // check is performed above
	payload := modelToCreateInstancePayload(netAcl, model, replVal)

	// Create new instance
	createResp, err := r.client.CreateInstanceRequest(
		ctx,
		projectId,
		region,
	).CreateInstanceRequestPayload(payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "error creating instance", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)
	instanceId, ok := createResp.GetIdOk()
	if !ok {
		core.LogAndAddError(ctx, &resp.Diagnostics, "error creating instance", "could not find instance id in response")
		return
	}

	// Set data returned by API in identity
	identity := InstanceResourceIdentityModel{
		ProjectID:  types.StringValue(projectId),
		Region:     types.StringValue(region),
		InstanceID: types.StringValue(instanceId),
	}
	resp.Diagnostics.Append(resp.Identity.Set(ctx, identity)...)
	if resp.Diagnostics.HasError() {
		return
	}

	waitResp, err := wait.CreateInstanceWaitHandler(ctx, r.client, projectId, region, instanceId).
		WaitWithContext(ctx)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error creating instance",
			fmt.Sprintf("Wait handler error: %v", err),
		)
		return
	}

	err = mapGetInstanceResponseToModel(ctx, &model, waitResp)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error creating instance",
			fmt.Sprintf("Error creating model: %v", err),
		)
		return
	}

	// Set state to fully populated data
	diags = resp.State.Set(ctx, model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "Postgres Flex instance created")
}

func modelToCreateInstancePayload(
	netAcl []string,
	model postgresflexalpha.InstanceModel,
	replVal int32,
) postgresflex.CreateInstanceRequestPayload {
	var enc *postgresflex.InstanceEncryption
	if !model.Encryption.IsNull() && !model.Encryption.IsUnknown() {
		enc = &postgresflex.InstanceEncryption{
			KekKeyId:       model.Encryption.KekKeyId.ValueStringPointer(),
			KekKeyRingId:   model.Encryption.KekKeyRingId.ValueStringPointer(),
			KekKeyVersion:  model.Encryption.KekKeyVersion.ValueStringPointer(),
			ServiceAccount: model.Encryption.ServiceAccount.ValueStringPointer(),
		}
	}
	payload := postgresflex.CreateInstanceRequestPayload{
		BackupSchedule: model.BackupSchedule.ValueStringPointer(),
		Encryption:     enc,
		FlavorId:       model.FlavorId.ValueStringPointer(),
		Name:           model.Name.ValueStringPointer(),
		Network: &postgresflex.InstanceNetworkCreate{
			AccessScope: postgresflex.InstanceNetworkGetAccessScopeAttributeType(
				model.Network.AccessScope.ValueStringPointer(),
			),
			Acl: &netAcl,
		},
		Replicas:      postgresflex.CreateInstanceRequestPayloadGetReplicasAttributeType(&replVal),
		RetentionDays: model.RetentionDays.ValueInt64Pointer(),
		Storage: &postgresflex.StorageCreate{
			PerformanceClass: model.Storage.PerformanceClass.ValueStringPointer(),
			Size:             model.Storage.Size.ValueInt64Pointer(),
		},
		Version: model.Version.ValueStringPointer(),
	}
	return payload
}

// Read refreshes the Terraform state with the latest data.
func (r *instanceResource) Read(
	ctx context.Context,
	req resource.ReadRequest,
	resp *resource.ReadResponse,
) { // nolint:gocritic // function signature required by Terraform
	functionErrorSummary := "read instance failed"

	var model resourceModel
	diags := req.State.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	var projectId string
	if !model.ProjectId.IsNull() && !model.ProjectId.IsUnknown() {
		projectId = model.ProjectId.ValueString()
	}

	var region string
	if !model.Region.IsNull() && !model.Region.IsUnknown() {
		region = r.providerData.GetRegionWithOverride(model.Region)
	}

	var instanceId string
	if !model.InstanceId.IsNull() && !model.InstanceId.IsUnknown() {
		instanceId = model.InstanceId.ValueString()
	}

	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)
	ctx = tflog.SetField(ctx, "region", region)

	instanceResp, err := r.client.GetInstanceRequest(ctx, projectId, region, instanceId).Execute()
	if err != nil {
		oapiErr, ok := err.(*oapierror.GenericOpenAPIError) //nolint:errorlint //complaining that error.As should be used to catch wrapped errors, but this error should not be wrapped
		if ok && oapiErr.StatusCode == http.StatusNotFound {
			resp.State.RemoveResource(ctx)
			return
		}
		core.LogAndAddError(ctx, &resp.Diagnostics, functionErrorSummary, err.Error())
		return
	}

	ctx = core.LogResponse(ctx)

	respInstanceID, ok := instanceResp.GetIdOk()
	if !ok {
		core.LogAndAddError(ctx, &resp.Diagnostics, functionErrorSummary, "response provided no ID")
		return
	}
	if !model.InstanceId.IsUnknown() && !model.InstanceId.IsNull() {
		if respInstanceID != instanceId {
			core.LogAndAddError(
				ctx,
				&resp.Diagnostics,
				functionErrorSummary,
				"ID in response did not match ID in state",
			)
			return
		}
	}

	err = mapGetInstanceResponseToModel(ctx, &model, instanceResp)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			functionErrorSummary,
			fmt.Sprintf("Processing API payload: %v", err),
		)
		return
	}

	// Set refreshed state
	resp.Diagnostics.Append(resp.State.Set(ctx, model)...)
	if resp.Diagnostics.HasError() {
		return
	}

	// Set data returned by API in identity
	identity := InstanceResourceIdentityModel{
		ProjectID:  types.StringValue(projectId),
		Region:     types.StringValue(region),
		InstanceID: types.StringValue(instanceId),
	}
	resp.Diagnostics.Append(resp.Identity.Set(ctx, identity)...)
	if resp.Diagnostics.HasError() {
		return
	}

	tflog.Info(ctx, "Postgres Flex instance read")
}

// Update updates the resource and sets the updated Terraform state on success.
func (r *instanceResource) Update(
	ctx context.Context,
	req resource.UpdateRequest,
	resp *resource.UpdateResponse,
) { // nolint:gocritic // function signature required by Terraform
	var model resourceModel

	diags := req.Plan.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	// Read identity data
	var identityData InstanceResourceIdentityModel
	resp.Diagnostics.Append(req.Identity.Get(ctx, &identityData)...)
	if resp.Diagnostics.HasError() {
		return
	}

	projectId := identityData.ProjectID.ValueString()
	instanceId := identityData.InstanceID.ValueString()
	region := model.Region.ValueString()
	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)
	ctx = tflog.SetField(ctx, "region", region)

	var netAcl []string
	diag := model.Network.Acl.ElementsAs(ctx, &netAcl, false)
	resp.Diagnostics.Append(diags...)
	if diag.HasError() {
		return
	}

	if model.Replicas.ValueInt64() > math.MaxInt32 {
		resp.Diagnostics.AddError("invalid int32 value", "provided int64 value does not fit into int32")
		return
	}
	replInt32 := int32(model.Replicas.ValueInt64()) // nolint:gosec // check is performed above

	payload := postgresflex.UpdateInstanceRequestPayload{
		BackupSchedule: model.BackupSchedule.ValueStringPointer(),
		FlavorId:       model.FlavorId.ValueStringPointer(),
		Name:           model.Name.ValueStringPointer(),
		Network: &postgresflex.InstanceNetworkUpdate{
			Acl: &netAcl,
		},
		Replicas:      postgresflex.UpdateInstanceRequestPayloadGetReplicasAttributeType(&replInt32),
		RetentionDays: model.RetentionDays.ValueInt64Pointer(),
		Storage: &postgresflex.StorageUpdate{
			Size: model.Storage.Size.ValueInt64Pointer(),
		},
		Version: model.Version.ValueStringPointer(),
	}

	// Update existing instance
	err := r.client.UpdateInstanceRequest(
		ctx,
		projectId,
		region,
		instanceId,
	).UpdateInstanceRequestPayload(payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance", err.Error())
		return
	}

	ctx = core.LogResponse(ctx)

	waitResp, err := wait.PartialUpdateInstanceWaitHandler(
		ctx,
		r.client,
		projectId,
		region,
		instanceId,
	).WaitWithContext(ctx)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error updating instance",
			fmt.Sprintf("Instance update waiting: %v", err),
		)
		return
	}

	err = mapGetInstanceResponseToModel(ctx, &model, waitResp)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error updating instance",
			fmt.Sprintf("Processing API payload: %v", err),
		)
		return
	}

	diags = resp.State.Set(ctx, model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "Postgresflex instance updated")
}

// Delete deletes the resource and removes the Terraform state on success.
func (r *instanceResource) Delete(
	ctx context.Context,
	req resource.DeleteRequest,
	resp *resource.DeleteResponse,
) { // nolint:gocritic // function signature required by Terraform
	var model resourceModel

	diags := req.State.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	projectId := model.ProjectId.ValueString()
	instanceId := model.InstanceId.ValueString()
	region := model.Region.ValueString()
	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)
	ctx = tflog.SetField(ctx, "region", region)

	// Delete existing instance
	err := r.client.DeleteInstanceRequest(ctx, projectId, region, instanceId).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting instance", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)

	_, err = r.client.GetInstanceRequest(ctx, projectId, region, instanceId).Execute()
	if err != nil {
		oapiErr, ok := err.(*oapierror.GenericOpenAPIError) //nolint:errorlint //complaining that error.As should be used to catch wrapped errors, but this error should not be wrapped
		if ok && oapiErr.StatusCode != http.StatusNotFound {
			core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting instance", err.Error())
			return
		}
	}

	resp.State.RemoveResource(ctx)
	tflog.Info(ctx, "Postgres Flex instance deleted")
}

// ImportState imports a resource into the Terraform state on success.
// The expected format of the resource import identifier is: project_id,region,instance_id
func (r *instanceResource) ImportState(
	ctx context.Context,
	req resource.ImportStateRequest,
	resp *resource.ImportStateResponse,
) {
	ctx = core.InitProviderContext(ctx)

	if req.ID != "" {
		idParts := strings.Split(req.ID, core.Separator)

		if len(idParts) != 3 || idParts[0] == "" || idParts[1] == "" || idParts[2] == "" {
			core.LogAndAddError(
				ctx, &resp.Diagnostics,
				"Error importing instance",
				fmt.Sprintf(
					"Expected import identifier with format [project_id],[region],[instance_id]  Got: %q",
					req.ID,
				),
			)
			return
		}

		resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("project_id"), idParts[0])...)
		resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("region"), idParts[1])...)
		resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("instance_id"), idParts[2])...)
		return
	}

	// If no ID is provided, attempt to read identity attributes from the import configuration
	var identityData InstanceResourceIdentityModel
	resp.Diagnostics.Append(req.Identity.Get(ctx, &identityData)...)
	if resp.Diagnostics.HasError() {
		return
	}

	projectId := identityData.ProjectID.ValueString()
	region := identityData.Region.ValueString()
	instanceId := identityData.InstanceID.ValueString()

	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("project_id"), projectId)...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("region"), region)...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("instance_id"), instanceId)...)

	tflog.Info(ctx, "Postgres Flex instance state imported")
}