How to setup HTTPS access to a local development cluster

Why HTTPS on a Local Dev Cluster

Since Google’s SameSite Cookie Changes Roll-out, you will find it is getting harder to test a local Web UI client with an API backend running in a local K8s dev cluster. Firstly, you need to set your cookie’s SameSite setting to “None” in order to enable cross-origin requests. However, a cookie with “SameSite=None” setting only will also be rejected by Google Chrome unless you set “Secure=true” to make the cookie only available through HTTPS connections. This makes HTTPS access a “must-have” when test your local cluster for the use case above.


Install Cert Manager

To issue a self-signed certificate for your cluster, you need to install cert-manager first:

# If your cluster version is Kubernetes >= 1.16
kubectl apply --validate=false -f

# If your cluster version is Kubernetes <= 1.15
kubectl apply --validate=false -f
# If you haven't install jetstack helm chart repo yet
helm repo add jetstack

# Create namespace for cert-manager
kubectl create namespace cert-manager

# If you use Helm v3+
helm install cert-manager jetstack/cert-manager --namespace cert-manager --version v1.0.4

# If you use Helm v2
helm install --name cert-manager --namespace cert-manager --version v1.0.4 jetstack/cert-manager

Create Self-Signed Cert Issuer

Run the following command:

kubectl apply -f

to create a ClusterIssuer with name selfsigned-issuer.

Setting Up Ingress for deployed MAGDA

minikube addons enable ingress
apiVersion: extensions/v1beta1
kind: Ingress
    name: local-ingress
    annotations: selfsigned-issuer
        # optional allow max file upload size 100M 100M 100M
        - host:
                  - path: /
                        serviceName: gateway
                        servicePort: 80
        - hosts:
          secretName: magda-local-cert-tls


kubectl -n [my-namespace] apply -f ingress.yaml

to create the ingress in the your MAGDA deployment namespace.

Access your cluster via HTTPS

To make test domain accessible locally, you also need to add the following entry to file /etc/hosts (on windows, it is c:\Windows\System32\Drivers\etc\hosts):

# Here is your minikube cluster IP.
# You can use command `minikube ip` to find it out.

Before access your test domain, you also need to make your local machine trust the self-signed certificate issued by local issuer.

Generally, you can: