Add ability to update to main branch of Go deps

Author: sjberman

.github/workflows/conformance.yml

@@ -79,6 +79,11 @@ jobs:
           cache-to: type=gha,mode=max
           pull: true
 
+      - name: Update Go Modules
+        if: ${{ github.event_name == 'schedule' }}
+        run: make update-go-modules
+        working-directory: ./conformance
+
       - name: Build Test Docker Image
         uses: docker/build-push-action@2eb1c1961a95fc15694676618e422e8ba1d63825 # v4.1.1
         with:
@@ -108,6 +113,5 @@ jobs:
         working-directory: ./conformance
 
       - name: Run conformance tests
-        run: |
-          make run-conformance-tests TAG=${{ github.sha }}
+        run: make run-conformance-tests TAG=${{ github.sha }}
         working-directory: ./conformance

Makefile

@@ -56,7 +56,7 @@ deps: ## Add missing and remove unused modules, verify deps and download them to
 create-kind-cluster: ## Create a kind cluster
 	$(eval KIND_IMAGE=$(shell grep -m1 'FROM kindest/node' <conformance/tests/Dockerfile | awk -F'[ ]' '{print $$2}'))
 	kind create cluster --image $(KIND_IMAGE)
-	kind export kubeconfig --kubeconfig $(KIND_KUBE_CONFIG)
+	kind export kubeconfig --kubeconfig $(KIND_KUBE_CONFIG_FOLDER)/config
 
 .PHONY: delete-kind-cluster
 delete-kind-cluster: ## Delete kind cluster

conformance/Makefile

@@ -14,6 +14,11 @@ NGINX_IMAGE=$(shell yq '.spec.template.spec.containers[1].image as $$nginx_ver |
 help: Makefile ## Display this help
 	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "; printf "Usage:\n\n    make \033[36m<target>\033[0m\n\nTargets:\n\n"}; {printf "    \033[36m%-30s\033[0m %s\n", $$1, $$2}'
 
+.PHONY: update-go-modules
+update-go-modules: ## Update the gateway-api go modules to latest main version
+	go get -u sigs.k8s.io/gateway-api@main
+	go mod tidy
+
 .PHONY: build-test-runner-image
 build-test-runner-image: ## Build conformance test runner image
 	docker build -t $(PREFIX):$(TAG) -f tests/Dockerfile ..
@@ -94,6 +99,10 @@ uninstall-nkg: ## Uninstall NKG on configured kind cluster
 undo-image-update: ## Undo the NKG image name and tag in deployment manifest
 	git checkout -- $(NKG_DEPLOYMENT_MANIFEST)
 
+.PHONY: reset-go-modules
+reset-go-modules: ## Reset the go modules changes
+	git checkout -- ../go.mod ../go.sum
+
 .PHONY: delete-kind-cluster
 delete-kind-cluster: ## Delete kind cluster
 	kind delete cluster

conformance/README.md

@@ -29,9 +29,11 @@ install-nkg-local-no-build     Install NKG from local build with provisioner on
 load-images                    Load NKG and NGINX containers on configured kind cluster
 preload-nginx-container        Preload NGINX container on configured kind cluster
 prepare-nkg-dependencies       Install NKG dependencies on configured kind cluster
+reset-go-modules               Reset the go modules changes
 run-conformance-tests          Run conformance tests
 undo-image-update              Undo the NKG image name and tag in deployment manifest
 uninstall-nkg                  Uninstall NKG on configured kind cluster
+update-go-modules              Update the gateway-api go modules to latest main version
 update-nkg-manifest            Update the NKG deployment manifest image name and imagePullPolicy
 ```
 
@@ -59,6 +61,13 @@ make create-kind-cluster
 
 ### Step 2 - Install Nginx Kubernetes Gateway to configured kind cluster
 
+> Note: If you want to run the latest conformance tests from the Gateway API `main` branch, set the following
+> environment variable before deploying NKG:
+> ```bash
+> export GW_API_VERSION=main
+>```
+> Otherwise, the latest stable version will be used by default.
+
 #### *Option 1* Build and install Nginx Kubernetes Gateway from local to configured kind cluster
 
 ```makefile
@@ -97,6 +106,13 @@ make install-nkg-edge
 
 ### Step 3 - Build conformance test runner image
 
+> Note: If you want to run the latest conformance tests from the Gateway API `main` branch, run the following
+> make command to update the Go modules to `main`:
+> ```makefile
+> make update-go-modules
+>```
+> Otherwise, the latest stable version will be used by default.
+
 ```makefile
 make build-test-runner-image
 ```
@@ -117,16 +133,21 @@ make cleanup-conformance-tests
 make uninstall-nkg
 ```
 
-### Step 6 - Revert changes to the NKG deployment manifest
+### Step 6 - Revert changes to Go modules
+**Optional** Not required if you aren't running the `main` Gateway API tests.
+```makefile
+make reset-go-modules
+```
+
+### Step 7 - Revert changes to the NKG deployment manifest
 **Optional** Not required if using `edge` image
 **Warning**: `make undo-image-update` will hard reset changes to the deploy/manifests/deployment.yaml file!
 
 ```makefile
 make undo-image-update
 ```
 
-### Step 7 - Delete kind cluster
-
+### Step 8 - Delete kind cluster
 ```makefile
 make delete-kind-cluster
 ```