Minikube: akses apps

Sumber: https://minikube.sigs.k8s.io/docs/handbook/accessing/

How to access applications running within minikube There are two major categories of services in Kubernetes:

Berikut adalah cara mengakses aplikasi yang berjalan di dalam minikube. Ada dua kategori utama layanan di Kubernetes:

• NodePort
• LoadBalancer

minikube mendukung ke dua-nya.

NodePort access

NodePort service adalah cara paling dasar untuk mendapatkan lalu lintas eksternal langsung ke service tersebit. NodePort, seperti namanya, membuka port tertentu, dan lalu lintas apa pun yang dikirim ke port ini diteruskan ke service yang dimaksud.

Mendapatkan NodePort menggunakan perintah service

Kita memiliki jalan pintas untuk mengambil IP minikube dan NodePort service:

minikube service <service-name> --url

Menggunakan minikube service dengan tunnel

Jaringan terbatas jika menggunakan driver Docker di Darwin, Windows, atau WSL, dan IP Node tidak dapat dijangkau secara langsung. Menjalankan minikube di Linux dengan driver Docker tidak akan membuat tunnel. Service dari NodePort dapat di akses melalui perintah,

minikube service <service-name> --url 

Itu harus dijalankan di window terminal yang terpisah agar tunnel tetap terbuka. Ctrl-C di terminal dapat digunakan untuk menghentikan proses saat rute jaringan akan clean up.

Contoh NodePort

Membuat Kubernetes deployment

kubectl create deployment hello-minikube1 --image=kicbase/echo-server:1.0

Membuat Kubernetes service type NodePort

kubectl expose deployment hello-minikube1 --type=NodePort --port=8080

Cek Node Port

$ kubectl get svc
NAME              TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
hello-minikube1   NodePort    10.100.238.34   <none>        8080:31389/TCP   3s

Run service tunnel

minikube service hello-minikube1 --url

minikube service hello-minikube1 --url run sebagai proses, membuat tunnel ke cluster. Perintah tersebut membuka service secara langsung ke program apapun yang jalan di sistem operasi host.

contoh service output

Cek ssh tunnel di terminal lain

$ ps -ef | grep docker@127.0.0.1
ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -N docker@127.0.0.1 -p 55972 -i /Users/FOO/.minikube/machines/minikube/id_rsa -L TUNNEL_PORT:CLUSTER_IP:TARGET_PORT

Coba menggunakan browser. Buka di browser pastikan tidak ada proxy yang di set,

http://127.0.0.1:TUNNEL_PORT

Mendapatkan NodePort menggunakan kubectl

VM minikube diekspos ke sistem host melalui alamat IP host-only, yang dapat diperoleh dengan perintah ip minikube. Semua layanan bertipe NodePort dapat diakses melalui alamat IP tersebut, di NodePort. Untuk menentukan NodePort untuk layanan kita, kita dapat menggunakan perintah kubectl seperti ini (perhatikan bahwa nodePort dimulai dengan huruf kecil n di keluaran JSON):

kubectl get service <service-name> --output='jsonpath="{.spec.ports[0].nodePort}"'

Meningkatkan NodePort range

Secara default, minikube hanya membuka port 30000-32767. Jika ini tidak berhasil, kita dapat menyesuaikan range dengan menggunakan:

minikube start --extra-config=apiserver.service-node-port-range=1-65535

Flag ini juga menerima daftar port dan range port yang dipisahkan koma.

LoadBalancer access

LoadBalancer service adalah cara standar untuk memexpose service ke internet. Dengan metode ini, setiap service mendapatkan IP address-nya sendiri.

Menggunakan minikube tunnel

Service bertipe LoadBalancer dapat diakses melalui perintah minikube tunnel. Itu harus dijalankan di window terminal terpisah agar LoadBalancer tetap berjalan. Ctrl-C di terminal dapat digunakan untuk menghentikan proses saat rute jaringan akan di clear up.

Contoh LoadBalancer

Jalankan tunnel di terminal terpisah Itu akan meminta password.

minikube tunnel

minikube tunnel berjalan sebagai sebuah proses, membuat rute jaringan pada host ke layanan CIDR cluster menggunakan alamat IP cluster sebagai gateway. Perintah tunnel membuka IP eksternal langsung ke program apa pun yang berjalan di sistem operasi host.

contoh tunnel output

Membuat Kubernetes deployment

kubectl create deployment hello-minikube1 --image=kicbase/echo-server:1.0

Membuat Kubernetes service dengan type LoadBalancer

kubectl expose deployment hello-minikube1 --type=LoadBalancer --port=8080

Cek external IP

kubectl get svc
$ kc get svc
NAME              TYPE           CLUSTER-IP      EXTERNAL-IP     PORT(S)          AGE
hello-minikube1   LoadBalancer   10.96.184.178   10.96.184.178   8080:30791/TCP   40s

Catatan tanpa minikube tunnel, Kubernetes akan memperlihatkan external IP sebagai “pending”.

Coba di Browser. Bukan browser (pastikan tidak ada proxt)

http://REPLACE_WITH_EXTERNAL_IP:8080

Setiap layanan akan memperoleh external IP masing-masing.

DNS resolution (experimental)

Jika kita menggunakan macOS, perintah tunnel juga memungkinkan resolusi DNS untuk service Kubernetes dari host.

CATATAN: driver docker tidak mendukung resolusi DNS

Cleaning up orphaned routes

If the minikube tunnel shuts down in an abrupt manner, it may leave orphaned network routes on your system. If this happens, the ~/.minikube/tunnels.json file will contain an entry for that tunnel. To remove orphaned routes, run:

minikube tunnel --cleanup

NOTE: --cleanup flag’s default value is true.

Avoiding password prompts

Adding a route requires root privileges for the user, and thus there are differences in how to run minikube tunnel depending on the OS. If you want to avoid entering the root password, consider setting NOPASSWD for “ip” and “route” commands:

https://superuser.com/questions/1328452/sudoers-nopasswd-for-single-executable-but-allowing-others

Access to ports <1024 on Windows requires root permission

If you are using Docker driver on Windows, there is a chance that you have an old version of SSH client you might get an error like - Privileged ports can only be forwarded by root. or you might not be able to access the service even after minikube tunnel if the access port is less than 1024 but for ports greater than 1024 works fine.

In order to resolve this, ensure that you are running the latest version of SSH client. You can install the latest version of the SSH client on Windows by running the following in a Command Prompt with an Administrator Privileges (Requires chocolatey package manager)

choco install openssh

The latest version (OpenSSH_for_Windows_7.7p1, LibreSSL 2.6.5) which is available on Windows 10 by default doesn’t work. You can track the issue with this over here - https://github.com/PowerShell/Win32-OpenSSH/issues/1693

Referensi

• https://minikube.sigs.k8s.io/docs/handbook/accessing/

Pranala Menarik

• minikube