Feature/dns skip wait and partial state

Makefile

@@ -1,5 +1,10 @@
 ROOT_DIR              ?= $(shell git rev-parse --show-toplevel)
 SCRIPTS_BASE          ?= $(ROOT_DIR)/scripts
+BIN_DIR               ?= $(ROOT_DIR)/bin
+
+# https://github.com/golangci/golangci-lint/releases
+GOLANGCI_LINT_VERSION = 1.64.8
+GOLANGCI_LINT         = $(BIN_DIR)/golangci-lint
 
 # SETUP AND TOOL INITIALIZATION TASKS
 project-help:
@@ -8,10 +13,14 @@ project-help:
 project-tools:
 	@$(SCRIPTS_BASE)/project.sh tools
 
+# GOLANGCI-LINT INSTALLATION
+$(GOLANGCI_LINT):
+	@GOLANGCI_LINT_VERSION=$(GOLANGCI_LINT_VERSION) $(SCRIPTS_BASE)/install-golangci-lint.sh
+
 # LINT
-lint-golangci-lint:
+lint-golangci-lint: $(GOLANGCI_LINT)
 	@echo "Linting with golangci-lint"
-	@$(SCRIPTS_BASE)/lint-golangci-lint.sh
+	@$(SCRIPTS_BASE)/lint-golangci-lint.sh $(GOLANGCI_LINT)
 
 lint-tf: 
 	@echo "Linting terraform files"

scripts/install-golangci-lint.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -e
+. $(dirname ${0})/utility.sh
+
+BINARY_NAME=golangci-lint
+INSTALL_TO=${BIN_DIR}/${BINARY_NAME}
+
+install() {
+    echo "  installing ${BINARY_NAME} ${GOLANGCI_LINT_VERSION}"
+
+    TYPE=windows
+    if [[ "${OSTYPE}" == linux* ]]; then
+        TYPE=linux
+    elif [[ "${OSTYPE}" == darwin* ]]; then
+        TYPE=darwin
+    fi
+
+    case $(uname -m) in
+    arm64|aarch64)
+        ARCH=arm64
+        ;;
+    *)
+        ARCH=amd64
+        ;;
+    esac
+
+    BASE_URL=https://github.com/golangci/golangci-lint/releases/download/v${GOLANGCI_LINT_VERSION}
+    URL=${BASE_URL}/golangci-lint-${GOLANGCI_LINT_VERSION}-${TYPE}-${ARCH}.tar.gz
+    echo "  Downloading: ${URL}"
+    download ${URL} | tar --extract --gzip --strip-components 1 --preserve-permissions -C ${BIN_DIR} -f-
+
+    # Ensure the binary has the correct name
+    if [ -f "${BIN_DIR}/golangci-lint" ] && [ "${BIN_DIR}/golangci-lint" != "${INSTALL_TO}" ]; then
+        mv "${BIN_DIR}/golangci-lint" "${INSTALL_TO}"
+    fi
+}
+
+get_version() {
+    ${INSTALL_TO} version 2>/dev/null | awk '{print $4}'
+}
+
+update_if_necessary ${GOLANGCI_LINT_VERSION}

scripts/lint-golangci-lint.sh

@@ -1,18 +1,19 @@
 #!/usr/bin/env bash
 # This script lints the SDK modules and the internal examples
-# Pre-requisites: golangci-lint
+# Pre-requisites: golangci-lint (provided by Makefile or system)
 set -eo pipefail
 
 ROOT_DIR=$(git rev-parse --show-toplevel)
 GOLANG_CI_YAML_PATH="${ROOT_DIR}/golang-ci.yaml"
 GOLANG_CI_ARGS="--allow-parallel-runners --timeout=5m --config=${GOLANG_CI_YAML_PATH}"
 
-if type -p golangci-lint >/dev/null; then
-    :
-else
-    echo "golangci-lint not installed, unable to proceed."
+# Use provided golangci-lint binary or fallback to system installation
+GOLANGCI_LINT_BIN="${1:-golangci-lint}"
+
+if [ ! -x "${GOLANGCI_LINT_BIN}" ] && ! type -p "${GOLANGCI_LINT_BIN}" >/dev/null; then
+    echo "golangci-lint not found at ${GOLANGCI_LINT_BIN} and not installed in PATH, unable to proceed."
     exit 1
 fi
 
 cd ${ROOT_DIR}
-golangci-lint run ${GOLANG_CI_ARGS}
+${GOLANGCI_LINT_BIN} run ${GOLANG_CI_ARGS}

scripts/utility.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Common utility functions for tool installation scripts
+
+ROOT_DIR=$(git rev-parse --show-toplevel)
+BIN_DIR="${ROOT_DIR}/bin"
+
+# Ensure bin directory exists
+mkdir -p "${BIN_DIR}"
+
+# Download function using curl
+download() {
+    local URL=$1
+    if command -v curl &> /dev/null; then
+        curl -sSfL "${URL}"
+    elif command -v wget &> /dev/null; then
+        wget -qO- "${URL}"
+    else
+        echo "Error: Neither curl nor wget found. Please install one of them."
+        exit 1
+    fi
+}
+
+# Update tool if necessary
+update_if_necessary() {
+    local EXPECTED_VERSION=$1
+
+    if [ -x "${INSTALL_TO}" ]; then
+        CURRENT_VERSION=$(get_version 2>/dev/null || echo "")
+        if [ "${CURRENT_VERSION}" = "${EXPECTED_VERSION}" ]; then
+            echo "  ${BINARY_NAME} ${EXPECTED_VERSION} already installed"
+            return 0
+        else
+            echo "  ${BINARY_NAME} version mismatch (current: ${CURRENT_VERSION}, expected: ${EXPECTED_VERSION})"
+            echo "  updating to ${EXPECTED_VERSION}..."
+        fi
+    fi
+
+    install
+
+    INSTALLED_VERSION=$(get_version 2>/dev/null || echo "unknown")
+    if [ "${INSTALLED_VERSION}" = "${EXPECTED_VERSION}" ]; then
+        echo "  ${BINARY_NAME} ${EXPECTED_VERSION} installed successfully"
+    else
+        echo "  Warning: installed version (${INSTALLED_VERSION}) does not match expected version (${EXPECTED_VERSION})"
+    fi
+}

stackit/internal/services/dns/recordset/resource.go

@@ -2,7 +2,9 @@ package dns
 
 import (
 	"context"
+	"errors"
 	"fmt"
+	"net/http"
 	"strings"
 
 	"github.com/hashicorp/terraform-plugin-framework-validators/int64validator"
@@ -16,6 +18,7 @@ import (
 	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
 	"github.com/hashicorp/terraform-plugin-framework/types"
 	"github.com/hashicorp/terraform-plugin-log/tflog"
+	"github.com/stackitcloud/stackit-sdk-go/core/oapierror"
 	"github.com/stackitcloud/stackit-sdk-go/services/dns"
 	"github.com/stackitcloud/stackit-sdk-go/services/dns/wait"
 	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/conversion"
@@ -219,18 +222,30 @@ func (r *recordSetResource) Create(ctx context.Context, req resource.CreateReque
 	}
 
 	// Write id attributes to state before polling via the wait handler - just in case anything goes wrong during the wait handler
-	utils.SetAndLogStateFields(ctx, &resp.Diagnostics, &resp.State, map[string]any{
-		"project_id":    projectId,
-		"zone_id":       zoneId,
-		"record_set_id": *recordSetResp.Rrset.Id,
-	})
+	recordSetId := *recordSetResp.Rrset.Id
+	model.RecordSetId = types.StringValue(recordSetId)
+	model.Id = utils.BuildInternalTerraformId(projectId, zoneId, recordSetId)
+
+	// Set all unknown/null fields to null before saving state
+	if err := utils.SetModelFieldsToNull(ctx, &model); err != nil {
+		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating record set", fmt.Sprintf("Setting model fields to null: %v", err))
+		return
+	}
+
+	diags = resp.State.Set(ctx, model)
+	resp.Diagnostics.Append(diags...)
 	if resp.Diagnostics.HasError() {
 		return
 	}
 
+	if !utils.ShouldWait() {
+		tflog.Info(ctx, "Skipping wait; async mode for Crossplane/Upjet")
+		return
+	}
+
 	waitResp, err := wait.CreateRecordSetWaitHandler(ctx, r.client, projectId, zoneId, *recordSetResp.Rrset.Id).WaitWithContext(ctx)
 	if err != nil {
-		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating record set", fmt.Sprintf("Instance creation waiting: %v", err))
+		tflog.Warn(ctx, fmt.Sprintf("Record set creation waiting failed: %v. The record set creation was triggered but waiting for completion was interrupted. The record set may still be creating.", err))
 		return
 	}
 
@@ -266,6 +281,12 @@ func (r *recordSetResource) Read(ctx context.Context, req resource.ReadRequest,
 
 	recordSetResp, err := r.client.GetRecordSet(ctx, projectId, zoneId, recordSetId).Execute()
 	if err != nil {
+		var oapiErr *oapierror.GenericOpenAPIError
+		ok := errors.As(err, &oapiErr)
+		if ok && (oapiErr.StatusCode == http.StatusNotFound || oapiErr.StatusCode == http.StatusGone) {
+			resp.State.RemoveResource(ctx)
+			return
+		}
 		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading record set", fmt.Sprintf("Calling API: %v", err))
 		return
 	}
@@ -319,9 +340,15 @@ func (r *recordSetResource) Update(ctx context.Context, req resource.UpdateReque
 		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating record set", err.Error())
 		return
 	}
+
+	if !utils.ShouldWait() {
+		tflog.Info(ctx, "Skipping wait; async mode for Crossplane/Upjet")
+		return
+	}
+
 	waitResp, err := wait.PartialUpdateRecordSetWaitHandler(ctx, r.client, projectId, zoneId, recordSetId).WaitWithContext(ctx)
 	if err != nil {
-		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating record set", fmt.Sprintf("Instance update waiting: %v", err))
+		tflog.Warn(ctx, fmt.Sprintf("Record set update waiting failed: %v. The record set update was triggered but waiting for completion was interrupted. The record set may still be updating.", err))
 		return
 	}
 
@@ -358,11 +385,25 @@ func (r *recordSetResource) Delete(ctx context.Context, req resource.DeleteReque
 	// Delete existing record set
 	_, err := r.client.DeleteRecordSet(ctx, projectId, zoneId, recordSetId).Execute()
 	if err != nil {
+		// If resource is already gone (404 or 410), treat as success for idempotency
+		var oapiErr *oapierror.GenericOpenAPIError
+		ok := errors.As(err, &oapiErr)
+		if ok && (oapiErr.StatusCode == http.StatusNotFound || oapiErr.StatusCode == http.StatusGone) {
+			tflog.Info(ctx, "Record set already deleted")
+			return
+		}
 		core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting record set", fmt.Sprintf("Calling API: %v", err))
+		return
+	}
+
+	if !utils.ShouldWait() {
+		tflog.Info(ctx, "Skipping wait; async mode for Crossplane/Upjet")
+		return
 	}
+
 	_, err = wait.DeleteRecordSetWaitHandler(ctx, r.client, projectId, zoneId, recordSetId).WaitWithContext(ctx)
 	if err != nil {
-		core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting record set", fmt.Sprintf("Instance deletion waiting: %v", err))
+		tflog.Warn(ctx, fmt.Sprintf("Record set deletion waiting failed: %v. The record set deletion was triggered but waiting for completion was interrupted. The record set may still be deleting.", err))
 		return
 	}
 	tflog.Info(ctx, "DNS record set deleted")
@@ -380,11 +421,23 @@ func (r *recordSetResource) ImportState(ctx context.Context, req resource.Import
 		return
 	}
 
-	utils.SetAndLogStateFields(ctx, &resp.Diagnostics, &resp.State, map[string]interface{}{
-		"project_id":    idParts[0],
-		"zone_id":       idParts[1],
-		"record_set_id": idParts[2],
-	})
+	var model Model
+	model.ProjectId = types.StringValue(idParts[0])
+	model.ZoneId = types.StringValue(idParts[1])
+	model.RecordSetId = types.StringValue(idParts[2])
+	model.Id = utils.BuildInternalTerraformId(idParts[0], idParts[1], idParts[2])
+
+	if err := utils.SetModelFieldsToNull(ctx, &model); err != nil {
+		core.LogAndAddError(ctx, &resp.Diagnostics, "Error importing zone", fmt.Sprintf("Setting model fields to null: %v", err))
+		return
+	}
+
+	diags := resp.State.Set(ctx, model)
+	resp.Diagnostics.Append(diags...)
+	if diags.HasError() {
+		return
+	}
+
 	tflog.Info(ctx, "DNS record set state imported")
 }