Tutorial: deploy your application to a minikube cluster

Create a sample Go application

1. Create a new Go project.

2. Create a main.go file and add the following code:

   package main import ( "fmt" "net/http" ) func main() { http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { fmt.Fprintln(w, "Hello from GoLand and minikube!") }) http.ListenAndServe(":8080", nil) }

1. Open the Terminal tool window: go to View | Tool Windows | Terminal or press Alt+F12.

2. Run the following command to build the application:

   go build -o app .

3. Make sure that the app executable file appears in the project root.

Create a Dockerfile

1. In the Project tool window Alt+1, right-click the project root, point to New, and click File.

2. In the New File… dialog, type Dockerfile and press Enter.

   If prompted, agree to add the file to Git.

3. Paste the following code to the new Dockerfile:

   FROM golang:1.26-alpine AS builder WORKDIR /app COPY go.mod ./ RUN go mod download COPY . . RUN go build -o server . FROM alpine:latest WORKDIR /app COPY --from=builder /app/server . EXPOSE 8080 ENTRYPOINT ["./server"]

Build the Docker image

1. In the gutter inside the Dockerfile, click and select New Run Configuration.

   

2. In the Edit Run Configuration dialog, specify go-minikube-app in the Image tag field and go-minikube in the Container name field. Then, click Run.

GoLand creates a Dockerfile run configuration, which builds an image from the Dockerfile and then runs a container based on that image. To follow the whole process, open the Log tab in the Services tool window.

Start minikube with the Docker driver

1. Open the Terminal tool window: go to View | Tool Windows | Terminal or press Alt+F12.

2. Run the following command to start a local Kubernetes cluster and instruct minikube to use Docker as the virtualization driver:

   minikube start --driver=docker

3. Verify that your cluster is up and running by using the command:

   minikube status

Add the minikube cluster to GoLand

1. Open the Services tool window: go to View | Tool Windows | Services or press Alt+8.

2. Select the Kubernetes node, click the Add Cluster button, and then select From Default Directory from the context menu.

   

3. In the Add Clusters dialog, select minikube and click Add Clusters.

   The added cluster will become available in the Services tool window.

4. In the Services tool window, right-click the minikube cluster and select Connect Cluster.

   

Load the Docker image into minikube

1. Open the Terminal tool window: go to View | Tool Windows | Terminal or press Alt+F12.

2. Run the following command to build the container image in minikube:

   minikube image load go-minikube-app

3. Validate that the go-minikube-app image is available in your cluster by running:

   minikube image ls | grep go-minikube-app

   You should see docker.io/library/go-minikube-app:latest in the output.

Create a Deployment manifest

1. In the Project tool window (Alt+1) , right-click the project name and select New | Kubernetes Resource.

2. In the New Kubernetes Resource dialog, select the Deployment file type, specify go-minikube-deployment as the manifest name, and press Enter.

   

   If prompted, agree to add the file to Git.

3. Replace the content of the resulting go-minikube-deployment.yaml file with the following code:

   apiVersion: apps/v1 kind: Deployment metadata: name: go-minikube spec: replicas: 1 selector: matchLabels: app: go-minikube template: metadata: labels: app: go-minikube spec: containers: - name: go-minikube image: go-minikube-app:latest imagePullPolicy: IfNotPresent ports: - containerPort: 8080

4. On the floating toolbar, select the current cluster and namespace, then click Apply to deliver the changes to the local cluster.

   

Create a Service manifest

1. In the Project tool window (Alt+1) , right-click the project name and select New | Kubernetes Resource.

2. In the New Kubernetes Resource dialog, select the Service file type, specify go-minikube-service as the manifest name, and press Enter.

   If prompted, agree to add the file to Git.

3. Replace the content of the resulting go-minikube-service.yaml file with the following code:

   apiVersion: v1 kind: Service metadata: name: go-minikube spec: type: NodePort selector: app: go-minikube ports: - port: 8080 targetPort: 8080

4. On the floating toolbar, select the current cluster and namespace, then click Apply to deliver the changes to the local cluster.

Access the application

1. Open the go-minikube-deployment.yaml file in the editor.

2. Click the Forward Ports inlay hint next to the - containerPort: 8080 property.

3. In the Forward Ports dialog, leave the default values and click Forward.

4. In the go-minikube-deployment.yaml file, click the Open in Browser inlay hint.

   

   GoLand redirects you to your default browser, where you can check the Go application deployed in your local minikube cluster.