The purpose of this repo is to provide required files to directly develop Golang Web API on Kubernetes with Okteto tool.

• Latest Okteto binary installed on your machine
• An operational Kubernetes or k3s cluster
• An Ingress Controller in your cluster (nginx in my case)
• A StorageClass to automaticaly create pv with pvc object. Your StorageClass should be set as default with this command:

kubectl patch storageclass MY-STORAGECLASS -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

I personnaly use cert-manager and HashiCorp Vault to get a valid TLS certificate for my subdomain. If you don't use these tools you need to rewrite backend-ing.yml in manifests directory to work with letsencrypt or http (no tls).
These documentations can help you:

• For cert-manager letsencrypt issuer: https://cert-manager.io/docs/configuration/acme
• For HTTP ingress: https://kubernetes.io/docs/concepts/services-networking/ingress/#the-ingress-resource

If it's the first time you use okteto and this repo you just need to do these commands:

git clone https://github.com/aamoyel/okteto-go-starter.git
kubectl apply -f manifests
okteto up

When you call 'okteto up' for the first time you need to select a kubernetes context.

You need to have Air binary to automatically build and run your go project. Your can find Air installation instructions down below.
After 'okteto up' (in dev container), run this command :

curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s -- -b $(go env GOPATH)/bin

After this, simply type 'air' in your terminal

Go to http://localhost:8080 to see local development container process and at your ingress url, https://dev.amoyel.loc in my case.
You can change domain and subdomain in backend-cert.yml file in manifests directory.

Simply enter CTRL+C to stop air binary.
Then do CTRL+D or type 'exit'.
And finaly type 'okteto down' to avoid resources consumption.

okteto up
air

Develop your Golang API ...
Do this step when you want to stop your dev session.

If you want to change Go version, simply change:

• Image tag in okteto.yml, eg: "image: golang:1.18.5-bullseye"
• Image tag in manifests/backend-deploy.yml, eg: "- image: golang:1.18.5-bullseye"

You can find other tags directly on Docker Hub.

To find more information on okteto.yml and okteto cli go to https://www.okteto.com/docs/reference/cli/