Updating deps to k8s 1.32 and go 1.24 (#3697)

* Updating deps to k8s 1.32 and go 1.24

Co-authored-by: dtumkursreenivas <[email protected]>

* Temporary fix for register-gen regression in v1.32

* Moving reference docs gen to elastic/crd-ref-docs

* Bumping golangci-lint version, docs gen cleanup

---------

Co-authored-by: dtumkursreenivas <[email protected]>

Author: robscott

.github/dependabot.yml

@@ -54,7 +54,7 @@ updates:
 
   # Dependencies listed in requirements.txt
   - package-ecosystem: "pip"
-    directory: "/"
+    directory: "/hack/mkdocs/image"
     schedule:
       interval: "weekly"
     labels:

.gitignore

@@ -56,3 +56,4 @@ go.work.sum
 /cache
 .venv/
 release/
+site-src/reference/spec.md

Makefile

@@ -91,7 +91,7 @@ test.crds-validation:
 .PHONY: conformance
 conformance:
 	go test ${GO_TEST_FLAGS} -v ./conformance -run TestConformance -args ${CONFORMANCE_FLAGS}
-	
+
 # Install CRD's and example resources to a preexisting cluster.
 .PHONY: install
 install: crd example
@@ -159,14 +159,28 @@ image.multiarch.setup: image.buildx.verify
 release-staging: image.multiarch.setup
 	hack/build-and-push.sh
 
-# Generate a virtualenv install, which is useful for hacking on the
-# docs since it installs mkdocs and all the right dependencies.
-#
-# On Ubuntu, this requires the python3-venv package.
-virtualenv: .venv
-.venv: requirements.txt
-	@echo Creating a virtualenv in $@"... "
-	@python3 -m venv $@ || (rm -rf $@ && exit 1)
-	@echo Installing packages in $@"... "
-	@$@/bin/python3 -m pip install -q -r requirements.txt || (rm -rf $@ && exit 1)
-	@echo To enter the virtualenv type \"source $@/bin/activate\",  to exit type \"deactivate\"
+# Docs
+
+.PHONY: build-docs
+build-docs:
+	docker build --pull -t gaie/mkdocs hack/mkdocs/image
+	docker run --rm -v ${PWD}:/docs gaie/mkdocs build
+
+.PHONY: build-docs-netlify
+build-docs-netlify:
+	hack/mkdocs/generate.sh
+	pip install -r hack/mkdocs/image/requirements.txt
+	python -m mkdocs build
+
+.PHONY: live-docs
+live-docs:
+	docker build -t gw/mkdocs hack/mkdocs/image
+	docker run --rm -it -p 3000:3000 -v ${PWD}:/docs gw/mkdocs
+
+.PHONY: api-ref-docs
+api-ref-docs:
+	crd-ref-docs \
+		--source-path=${PWD}/apis \
+		--config=crd-ref-docs.yaml \
+		--renderer=markdown \
+		--output-path=${PWD}/site-src/reference/spec.md