Перейти к основному контенту

K8S

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

  1. Загрузите версию v1.25.9 с помощью команды:

    curl -LO https://dl.k8s.io/release/v1.25.9/bin/linux/amd64/kubectl
    
  2. Сделайте бинарный файл kubectl исполняемым:

    chmod +x ./kubectl
    
  3. Переместите бинарный файл в директорию из переменной окружения PATH:

    sudo mv ./kubectl /usr/local/bin/kubectl
    
  4. Убедитесь, что установлена последняя версия:

    kubectl version --client
    

  5. Установите CLI для OpenStack:

    sudo pip install cryptography==3.3.2
    sudo pip install python-openstackclient
    sudo pip install python-cinderclient python-magnumclient
    
  6. Загрузите учетные данные, для получения доступа к API. Для этого необходимо авторизоваться на cloud.resds.ru в правом верхнем углу нажмите на клавишу "Загрузите файл OpenStack RC" и выберете в выпадающем меню "OpenStack RC-файл" и переместите этот файл в локальную директорию пользователя с названием "openstack-client.sh"

  7. Добавьте в переменные среды полученные данные из прошлого шага:

    source ~/openstack-client.sh
    

    При добавлении переменных среды, будет запрошен пароль, и добавлен в переменные среды на время сессии

  8. Для проверки работоспособности клиента можно попробовать получить список вычислительных узлов в проекте

    openstack server list
    

    Также можно увидеть список кластер k8s

    openstack coe cluster list
    
  9. Также добавим автодополнение для bash:

    echo 'source <(kubectl completion bash)' >>~/.bashrc
    source ~/.bashrc
    

Создание кластера

  1. Авторизуйтесь cloud.resds.ru
  2. Перейдите в Проект->Container Infra->Clusters
  3. Нажмите Create Cluster
  4. Задайте название кластера в поле Cluster Name, название кластера Training-cluster-{Фамилия}, как пример Training-cluster-Tarabanov
  5. В Cluster Template выберите пункт c39-kube-1.25-oct-ing
  6. Зона доступности кластера nova
  7. Выберите ключевую пару
  8. Как размер кластера выберете 1 мастер узел и 2 рабочих узла
  9. Нажмите отправить
  10. После отправки необходимо дождаться создания кластера, это может занять некоторое время. Кластер можно считать созданным после смены статуса на CREATE_COMPLETE и Health Status в HEALTHY

Работа с кластером

  1. Перейдите на предварительно настроенный узел

  2. Добавьте переменные среды

  3. Получите конфигурационный файл для подключения к кластеру с помощью CLI

    openstack coe cluster config {Название кластера созданного вами}
    

    export KUBECONFIG=/home/cloudadmin/config
    
  4. Проверьте работу kubectl

    kubectl get nodes
    

  5. Начнем с создания ингреса для нашего приложения:

    Ингрес будет использовать облачный балансировщик Octavia, который реализуют балансировщик на базе облачной платформы OpenStack. Для начала можно посмотреть существующие балансировщики в облачной платформе с помощью команды:

    openstack loadbalancer list
    

    Создадим файл с конфигурацией ингреса ingress.yaml

    apiVersion: networking.k8s.io/v1
    kind: Ingress
    metadata:
      annotations:
        kubernetes.io/ingress.class: openstack
        octavia.ingress.kubernetes.io/internal: "false"
      name: octavia-ingress
    spec:
      rules:
      - host: test.com
        http:
          paths:
          - backend:
              service:
                name: sample-front
                port:
                  number: 80
            path: /
            pathType: Prefix
    

    Данный фрагмент конфигурации определяет параметры создаваемого ингресса в Kubernetes. Этот конфиг определяет следующие основные параметры:

    • apiVersion: Версия API, используемая для определения структуры конфигурации.
    • kind: Тип объекта, в данном случае, это ингресс.
    • metadata: Метаданные объекта, такие как имя и пространство имен.
    • annotations: Аннотации предоставляют дополнительные метаданные об ингрессе.
    • spec: Определяет спецификацию правил ингресса, включая хосты и пути, а также их бекенды. Для данного ингресса мы определили, что будет использоваться домен test.com и для него будет использоваться бекенд сервисом sample-front и посылать запросы на 80 порт сервиса, переход будет осуществляться при любом запросе к домену http://test.com/. Чтобы применить выполненную команду, необходимо ввести команду:
kubectl apply -f ingress.yaml

После выполнения данной команды начнется создание балансировщика в платформе OpenStack, чтобы отследить создание балансировщика можно выполнять команду:

openstack loadbalancer list

Если после создания балансировщика появилась ошибка в столбце provisioning_status у вашего балансировщика, выполните команду:

openstack loadbalancer failover <loadbalancer id>

Если все еще находится в состоянии ошибки и не выходит после этой команды, пишите @tarabanov

Пока наш балансировщик никуда не обращается, давайте создадим поды и сервисы для нашего веб приложения.
 Для этого начнем создание конфигурационного файла для фронтенда приложения, для этого начнем с создания файла sample-web-deployments.yaml

---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: sample-front
  labels:
    app: sample-front
spec:
  selector:
    matchLabels:
      app: sample-front
  template:
    metadata:
      labels:
        app: sample-front
    spec:
      containers:
      - name: sample-front
        image: registry.gitlab.resds.ru/itt/sample-project:front
        ports:
        - containerPort: 3000

Этот фрагмент конфигурации представляет собой определение деплоймента в Kubernetes, который управляет подами для запуска и масштабирования приложения. Давайте разберем его по шагам:

  • apiVersion: apps/v1 и kind: Deployment: Эти строки определяют, что мы создаем деплоймент в Kubernetes API версии 1 для управления подами.
  • metadata: В этом разделе определяется метаданные деплоймента, такие, как его имя и метки (labels), которые могут использоваться для идентификации и поиска этого ресурса в Kubernetes кластере.
  • spec: Этот раздел определяет спецификацию деплоймента, включая:
    • selector: Определяет, какие поды должны быть управляемы деплойментом. В данном случае, деплоймент будет управлять подами, которые имеют метку app: sample-front
    • template: Определяет шаблон для создания новых подов. Внутри template указываются метаданные и спецификация контейнера.
    • metadata.labels: Это метки, которые будут присвоены создаваемым подам. В данном случае, создаваемые поды будут иметь метку app: sample-front, что соответствует селектору деплоймента.
    • spec.containers: Определяет контейнеры, которые будут запущены в подах. В данном случае, определен только один контейнер:
      • name: sample-front: Это имя контейнера.
      • image: registry.gitlab.resds.ru/itt/sample-project:front: Это образ контейнера, который будет загружен и запущен в поде.
      • ports: Это список портов, которые контейнер будет прослушивать. В данном случае, контейнер будет прослушивать порт 3000 внутри себя, что означает, что приложение в контейнере будет доступно по этому порту внутри кластера Kubernetes.

Теперь создадим сервис для фронтенда sample-web-deployments.yaml

kind: Service
apiVersion: v1
metadata:
  name: sample-front
  labels:
    app: sample-front
spec:
  ports:
  - port: 3000
    targetPort: 3000
  selector:
    app: sample-front
  type: NodePort

Можно заметить, что мы использовали порт 3000 для работы сервиса, а в ингрес контроллере указывали 80 при его создании, давайте отредактируем ингресс на 3000 порт.

kubectl edit ing/octavia-ingress

В нем необходимо изменить:

port:
  number: 80

На

port:
  number: 3000

Проверим создался наш фронтед, для этого сначала проверим какой ip адрес получил ingress, для этого введем команду:

kubectl get ing

В столбце ADDRESS будет указан внешний адрес балансировщика.

Откройте в браузере наш фронтенд и убедитесь, что он запустился и работает.

Стоит заметить, что ответ будет происходить только при запросе по доменному имени. Стоит обеспечить доступность домен по DNS или добавить в файл hosts вашей операционной системы.

После удачной проверки работы фронтенда приступим к добавлению бекенда. back-service-pods.yaml:

---
kind: Service
apiVersion: v1
metadata:
  name: sample-back
  labels:
    app: sample-back
spec:
  ports:
  - port: 5000
    targetPort: 5000
  selector:
    app: sample-back
  type: NodePort

back-pods.yaml:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: sample-back
  labels:
    app: sample-back
spec:
  replicas: 2
  selector:
    matchLabels:
      app: sample-back
  template:
    metadata:
      labels:
        app: sample-back
    spec:
      containers:
      - name: sample-back
        image: registry.gitlab.resds.ru/itt/sample-project:back
        ports:
        - containerPort: 5000

Также необходимо отредактировать ingress, в этот раз мы сделаем это с помощью редактирования конфигурационного файла(ingress.yaml):

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    kubernetes.io/ingress.class: openstack
    octavia.ingress.kubernetes.io/internal: "false"
  name: test-octavia-ingress
  namespace: default
spec:
  rules:
  - host: test.com
    http:
      paths:
      - backend:
          service:
            name: sample-back
            port:
              number: 5000
        path: /api
        pathType: Prefix
      - backend:
          service:
            name: sample-back
            port:
              number: 5000
        path: /api/notes
        pathType: Prefix
      - backend:
          service:
            name: sample-front
            port:
              number: 3000
        path: /
        pathType: Prefix

и применим изменившеюся конфигурацию:

kubectl apply -f ingress.yaml

Проверьте работу веб приложения.