Подготовка окружения

Установка и запуск minikube

Установим/обновим minikube, следуя инструкциям проекта. Убедимся, что у нас используется самая свежая версия minikube, доступная по приведённой ссылке.

Создаём новый Kubernetes-кластер с minikube:

# Удалим существующий minikube-кластер (если он есть).
minikube delete
# Запустим новый minikube-кластер.
minikube start --driver=hyperkit

Выставим Namespace по умолчанию, чтобы не указывать его при каждом вызове kubectl:

kubectl config set-context minikube --namespace=werf-guide-app

В ответ отобразится следующее:

Context "minikube" modified.

Если утилита kubectl всё ещё не установлена, то установим её, следуя инструкциям.

Теперь проверим работоспособность нового кластера Kubernetes, а точнее посмотрим список всех Pod’ов, запущенных в кластере:

kubectl get --all-namespaces pod

В ответ отобразится примерно следующее:

NAMESPACE     NAME                               READY   STATUS    RESTARTS   AGE
kube-system   coredns-558bd4d5db-8jfng           1/1     Running   0          48s
kube-system   etcd-minikube                      1/1     Running   0          61s
kube-system   kube-apiserver-minikube            1/1     Running   0          54s
kube-system   kube-controller-manager-minikube   1/1     Running   0          54s
kube-system   kube-proxy-b87f2                   1/1     Running   0          48s
kube-system   kube-scheduler-minikube            1/1     Running   0          65s
kube-system   storage-provisioner                1/1     Running   0          56s

Кластер Kubernetes запущен и работает, если оба условия выполняются:

• в 4-м столбце все Pod’ы из полученного списка находятся в состояниях Running или Completed;
• в 3-м столбце для всех Pod’ов в Running число слева (X) от / равно числу справа (Y) в выражениях вроде X/Y (т.е. контейнеры Pod’а успешно запустились).

Если не все Pod’ы успешно запустились, то подождите и снова выполните команду выше для получения статуса всех Pod’ов.

Установка NGINX Ingress Controller

Устанавливаем NGINX Ingress Controller:

minikube addons enable ingress

В ответ отобразится следующее:

...
🔎  Verifying ingress addon...
🌟  The 'ingress' addon is enabled

Немного подождём, после чего убедимся, что Ingress Controller успешно запустился:

kubectl -n ingress-nginx get pod

В ответ отобразится примерно следующее:

NAME                                        READY   STATUS      RESTARTS   AGE
ingress-nginx-admission-create-qrcdg        0/1     Completed   0          8m12s
ingress-nginx-admission-patch-8pw4d         0/1     Completed   0          8m12s
ingress-nginx-controller-59b45fb494-fscgf   1/1     Running     0          8m12s

Обновление файла hosts

Для доступа к приложению мы будем использовать домен werf-guide-app.test. Для этого обновим файл hosts:

echo "$(minikube ip) werf-guide-app.test" | sudo tee -a /etc/hosts

Установка и запуск minikube

Установим/обновим minikube, следуя инструкциям проекта. Убедимся, что у нас используется самая свежая версия minikube, доступная по приведённой ссылке.

Создаём новый Kubernetes-кластер с minikube:

# Удалим существующий minikube-кластер (если он есть).
minikube delete
# Запустим новый minikube-кластер.
minikube start --driver=docker

Выставим Namespace по умолчанию, чтобы не указывать его при каждом вызове kubectl:

kubectl config set-context minikube --namespace=werf-guide-app

В ответ отобразится следующее:

Context "minikube" modified.

Если утилита kubectl всё ещё не установлена, то установим её, следуя инструкциям.

Теперь проверим работоспособность нового кластера Kubernetes, а точнее посмотрим список всех Pod’ов, запущенных в кластере:

kubectl get --all-namespaces pod

В ответ отобразится примерно следующее:

NAMESPACE     NAME                               READY   STATUS    RESTARTS   AGE
kube-system   coredns-558bd4d5db-8jfng           1/1     Running   0          48s
kube-system   etcd-minikube                      1/1     Running   0          61s
kube-system   kube-apiserver-minikube            1/1     Running   0          54s
kube-system   kube-controller-manager-minikube   1/1     Running   0          54s
kube-system   kube-proxy-b87f2                   1/1     Running   0          48s
kube-system   kube-scheduler-minikube            1/1     Running   0          65s
kube-system   storage-provisioner                1/1     Running   0          56s

Кластер Kubernetes запущен и работает, если оба условия выполняются:

• в 4-м столбце все Pod’ы из полученного списка находятся в состояниях Running или Completed;
• в 3-м столбце для всех Pod’ов в Running число слева (X) от / равно числу справа (Y) в выражениях вроде X/Y (т.е. контейнеры Pod’а успешно запустились).

Если не все Pod’ы успешно запустились, то подождите и снова выполните команду выше для получения статуса всех Pod’ов.

Установка NGINX Ingress Controller

Устанавливаем NGINX Ingress Controller:

minikube addons enable ingress

В ответ отобразится следующее:

...
🔎  Verifying ingress addon...
🌟  The 'ingress' addon is enabled

Немного подождём, после чего убедимся, что Ingress Controller успешно запустился:

kubectl -n ingress-nginx get pod

В ответ отобразится примерно следующее:

NAME                                        READY   STATUS      RESTARTS   AGE
ingress-nginx-admission-create-qrcdg        0/1     Completed   0          8m12s
ingress-nginx-admission-patch-8pw4d         0/1     Completed   0          8m12s
ingress-nginx-controller-59b45fb494-fscgf   1/1     Running     0          8m12s

Сделаем NGINX Ingress Controller доступным на 80-м порту после запуска minikube tunnel:

kubectl expose service -n ingress-nginx ingress-nginx-controller --name ingress-nginx-controller-lb --type LoadBalancer --port 80 --target-port http

Важно проверить, что в нашей системе не занят 80-й порт. Следующая команда, выполненная от Администратора, должна выдать пустой результат:

netstat -anb | Select-String :80

В случае если порт занят, то в ответ отобразится примерно следующее:

TCP     0.0.0.0:80        0.0.0.0:0       LISTENING
TCP     [::]:80           [::]:0          LISTENING

— в этом случае необходимо найти и остановить запущенный сервер.

Теперь нам надо не забывать держать запущенным minikube tunnel в отдельном окне PowerShell. Это необходимо для доступа с нашего хоста к ресурсам в кластере через Ingress:

minikube tunnel --cleanup=true

Обновление файла hosts

Для доступа к приложению мы будем использовать домен werf-guide-app.test. Для этого обновим файл hosts (в PowerShell от администратора):

Add-Content "C:\Windows\System32\drivers\etc\hosts" "`n127.0.0.1 werf-guide-app.test"