آغاز کار با مینی کیوب (minikube)

این آموزش به شما نشان می دهد که چگونه یک برنامه را در کوبرنتیز توسط مینی کی یوب (Minikube) اجرا کنید. این آموزش یک کانتینر NGINX را برای شما محیا می کند که به تمام درخواست هایتان پاسخ می دهد.

اهداف

• برنامه نمونه را در مینی کی یوب پیاده سازی کنید.
• برنامه را اجرا کنید.
• لاگ های برنامه را بررسی کنید.

قبل از آغاز

این آموزش با این باور شروع می شود که شما در حال حاضر مینی کی یوب را نصب کرده اید. در صورت نیاز به راهنمای نصب مینی کی یوب به Step1 در این سایت مراجعه کنید.

ابزار kubectl را هم احتیاج دارید.

برای نصب از قسمت ابزار بازدید کنید.

پیکربندی کلاستر

minikube start

باز کردن داشبورد

داشبورد کوبرنتیز در دو حالت قابل دسترسی می باشد.

• نمایش در مرورگر
• کپی آدرس

minikube dashboard

minikube dashboard --url

یک دیپلویمنت بسازید

هر پاد (Pod) در کوبرنتیز گروهی از یک یا چند کانتینر است که به دلیل مدیریت یا شبکه با هم گروه شده اند. پاد استفاده شده در این آموزش تنها یک کانتینر دارد. هر دیپلویمنت (Deployment) در کوبرنتیز پادهای خود را به صورت مداوم چک کرده و در صورت خاطمه یافنن کانتینر آن را دو باره راه اندازی می کنند .دیپلویمنت ها روش پیشنهادی استقرار، مدیریت و مقیاس بندی پاد ها در کوبرنتیز هستندد

‍۱. با استففاده از دستور kubectl create یک دیپلویمنت بسازید که پاد این آموزش را مدیریت کند. این پاد که یک کانتینر دارد بر پایه ایمیج (image) داکر مستقر می شود.

# Run a test container image that includes a webserver
kubectl create deployment hello-node --image=registry.k8s.io/e2e-test-images/agnhost:2.39 -- /agnhost netexec --http-port=8080

۲. دیپلویمنت را بررسی کنید:

kubectl get deployments

خروجی چیزی شبیه به این خواهد بود:

NAME         READY   UP-TO-DATE   AVAILABLE   AGE
hello-node   1/1     1            1           1m

(امکان دارد که بالا آمدن پاد چند لحظه طول بکشد. اگر خروجی به شما "0/1" را نشان می دهد بعد از چند لحظه مکس دوباره تلاش کنید.)

۳. پاد را بررسی کنید:

kubectl get pods

خروجی چیزی شبیه به این خواهد بود:

NAME                          READY     STATUS    RESTARTS   AGE
hello-node-5f76cf6ccf-br9b5   1/1       Running   0          1m

۴. ایونت های کلاستر را بررسی کنید:

kubectl get events

۵. تنظیمات kubectl را بررسی کنید:

kubectl config view

۶. بررسی لاگ های یک کانتینر در پاد .از دستور kubectl get pods استفاده کنید تا نام پاد خود را بدست آورید.

kubectl logs hello-node-5f76cf6ccf-br9b5

خروجی چیزی شبیه به این خواهد بود:

I0911 09:19:26.677397       1 log.go:195] Started HTTP server on port 8080
I0911 09:19:26.677586       1 log.go:195] Started UDP server on port  8081

ایجاد سرویس

به صورت پیش فرض پادها تنها در شبکه داخلی کوبرنتیز با ای پی (IP) های داخلی قابل دسترس هستند. در این آموزش برای ایجاد دسترسی خارجی به کانتینر hello-node شما باید این پاد را از طریق یک سرویس منتشر کنید.

1. Expose the Pod to the public internet using the kubectl expose command:

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

The --type=LoadBalancer flag indicates that you want to expose your Service outside of the cluster.

The application code inside the test image only listens on TCP port 8080. If you used kubectl expose to expose a different port, clients could not connect to that other port.

2. View the Service you created:

kubectl get services

خروجی چیزی شبیه به این خواهد بود:

NAME         TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
hello-node   LoadBalancer   10.108.144.78   <pending>     8080:30369/TCP   21s
kubernetes   ClusterIP      10.96.0.1       <none>        443/TCP          23m

On cloud providers that support load balancers, an external IP address would be provisioned to access the Service. On minikube, the LoadBalancer type makes the Service accessible through the minikube service command.

3. Run the following command:

minikube service hello-node

This opens up a browser window that serves your app and shows the app's response.

فعال کردن افزونه ها

The minikube tool includes a set of built-in addons that can be enabled, disabled and opened in the local Kubernetes environment.

1. List the currently supported addons:

minikube addons list

خروجی چیزی شبیه به این خواهد بود:

addon-manager: enabled
dashboard: enabled
default-storageclass: enabled
efk: disabled
freshpod: disabled
gvisor: disabled
helm-tiller: disabled
ingress: disabled
ingress-dns: disabled
logviewer: disabled
metrics-server: disabled
nvidia-driver-installer: disabled
nvidia-gpu-device-plugin: disabled
registry: disabled
registry-creds: disabled
storage-provisioner: enabled
storage-provisioner-gluster: disabled

1. Enable an addon, for example, metrics-server:

minikube addons enable metrics-server

خروجی چیزی شبیه به این خواهد بود:

The 'metrics-server' addon is enabled

1. View the Pod and Service you created by installing that addon:

kubectl get pod,svc -n kube-system

خروجی چیزی شبیه به این خواهد بود:

NAME                                        READY     STATUS    RESTARTS   AGE
pod/coredns-5644d7b6d9-mh9ll                1/1       Running   0          34m
pod/coredns-5644d7b6d9-pqd2t                1/1       Running   0          34m
pod/metrics-server-67fb648c5                1/1       Running   0          26s
pod/etcd-minikube                           1/1       Running   0          34m
pod/influxdb-grafana-b29w8                  2/2       Running   0          26s
pod/kube-addon-manager-minikube             1/1       Running   0          34m
pod/kube-apiserver-minikube                 1/1       Running   0          34m
pod/kube-controller-manager-minikube        1/1       Running   0          34m
pod/kube-proxy-rnlps                        1/1       Running   0          34m
pod/kube-scheduler-minikube                 1/1       Running   0          34m
pod/storage-provisioner                     1/1       Running   0          34m

NAME                           TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)             AGE
service/metrics-server         ClusterIP   10.96.241.45    <none>        80/TCP              26s
service/kube-dns               ClusterIP   10.96.0.10      <none>        53/UDP,53/TCP       34m
service/monitoring-grafana     NodePort    10.99.24.54     <none>        80:30002/TCP        26s
service/monitoring-influxdb    ClusterIP   10.111.169.94   <none>        8083/TCP,8086/TCP   26s

1. Check the output from metrics-server:

kubectl top pods

خروجی چیزی شبیه به این خواهد بود:

NAME                         CPU(cores)   MEMORY(bytes)   
hello-node-ccf4b9788-4jn97   1m           6Mi             

If you see the following message, wait, and try again:

error: Metrics API not available

1. Disable metrics-server:

minikube addons disable metrics-server

خروجی چیزی شبیه به این خواهد بود:

metrics-server was successfully disabled

پاکسازی

اکنون می‌توانید منابعی را که در کلاستر خود ایجاد کرده‌اید پاک‌سازی کنید:

kubectl delete service hello-node
kubectl delete deployment hello-node

کلاستر را متوقف کنید.

minikube stop

به صورت دلخواه، می توانید ماشین مجازی مینی کیوب را حذف کنید:

minikube delete

اگر می خواهید دوباره از مینی کی یوب استفاده کنید تا بیشتر کوبرنتیز را یاد بگیرید نیازی به حذف ماشین مجازی ندارید ندارید

جمع بندی

در این آموزش شما با نحوه راه اندازی یک کلاستر مینی کی یوب و بخش های ابتدایی یک کلاستر آشنا شدید.

گام بعدی

• Tutorial to deploy your first app on Kubernetes with kubectl.
• Learn more about Deployment objects.
• Learn more about Deploying applications.
• Learn more about Service objects.