Сценарии администрирования#

  1. Администрирование приложения администратором происходит в кластере Kubernetes, в том числе, посредством доступа к консоли Kubernetes.

  2. Для развертывания компонента DataMapper в Kubernetes администратору необходимы права на чтение и запись всех используемых Helm charts, а также возможность читать логи pods.

Администратор в Kubernetes-кластере осуществляет:

  • конфигурирование IGEG (Ingress Gateway и Egress Gateway) в рамках первичной установки дистрибутива, разворачивая соответствующие конфигурации;

  • обеспечение сетевой безопасности при использовании компонента;

  • отслеживание работоспособности pods.

Загрузка конфигураций#

После установки DataMapper, все Pods должны запуститься автоматически. Если же этого не произошло или по каким-либо причинам необходим ручной запуск Pods, то ниже приведены последовательности действий для запуска.

Запуск компонента#

Шаг

Действия

Аутентификация в web-консоли Kubernetes

1. Перейдите по ссылке web-консоли нужного кластера Kubernetes
2. Введите в окне ввода учетных данных логин и пароль

Переход в нужный проект

1. Выберите пункт меню Projects
2. Выберите нужный проект из открывшегося списка

Запуск DataMapper Runtime

1. Выберите пункт меню Workload/Deployments
2. Выберите на странице нужный Deployment
3. Перейдите по ссылке в наименовании на вкладку Detail и нажмите стрелку Вверх, чтобы увеличить количество pods сервиса DataMapper

С использованием консоли Kubernetes

Шаг

Действия

Описание

Настройка Kubectl

Настройте файл конфигурации, выполнив команды:
kubectl config set-credentials логин/хост:порт --username=логин --password=пароль
kubectl config set-cluster хост:порт --insecure-skip-tls-verify=true --server=https://хост:порт
kubectl config set-context неймспейс/хост:порт/логин --user=логин/хост:порт --namespace=неймспейс --cluster=хост:порт
kubectl config use-context неймспейс/хост:порт/логин

Переход в нужный проект

Введите команду: kubectl config set-context --current --namespace=<имя проекта>

Запуск сервиса DataMapper Runtime

Выполните в консоли команду: kubectl scale --replicas=<N> deployment/<имя deployment>

Остановка компонента#

Шаг

Действия

Настройка Kubectl

Настройте файл конфигурации, выполнив команды:
kubectl config set-credentials логин/хост:порт --username=логин --password=пароль
kubectl config set-cluster хост:порт --insecure-skip-tls-verify=true --server=https://хост:порт
kubectl config set-context неймспейс/хост:порт/логин --user=логин/хост:порт --namespace=неймспейс --cluster=хост:порт
kubectl config use-context неймспейс/хост:порт/логин

Переход в нужный проект

Введите команду: kubectl config set-context --current --namespace=<имя проекта>

Запуск сервиса DataMapper Runtime

Выполните в консоли команду: kubectl scale --replicas=<0> deployment/<имя deployment >

Проверка работоспособности#

Шаг

Действие

Вход в веб-консоль Kubernetes

Перейдите по ссылке (URL) веб-консоли нужного кластера Kubernetes, в окне ввода учетных данных введите токен пользователя или kubeconfig

Переход в нужный проект

Выберите нужный проект в выпадающем списке в шапке веб-интерфейса Kubernetes

Переход во вкладку Pod

В меню выберите пункт Workload/Pods
В рамках таблицы Pods проверьте столбец «Status», валидное значение «Running». Также подтвердите значение в столбце «Restarts», равное 0

Настройка выделения ресурсов#

Шаг

Действия

Логин в веб-консоль Kubernetes

1. Перейдите по ссылке веб-консоли нужного кластера Kubernetes
2. Введите в окне ввода учетных данных логин и пароль

Переход в нужный проект

1. Выберите пункт меню Projects
2. Выберите нужный проект из открывшегося списка

Выбор развертывания

1. Выберите пункт меню Workload/Deployments
2. Выберите на странице нужное развертывание с DataMapper (при необходимости воспользуйтесь поиском по имени)
3. Перейдите по ссылке в наименовании на вкладку Detail и перейдите на вкладку YAML

Настройка параметров

1. Найдите в окне редактирования параметры: spec.template.spec.containers[0].resources.limits.cpu, spec.template.spec.containers[0].resources.limits.memory, spec.template.spec.containers[0].resources.requests.cpu, spec.template.spec.containers[0].resources.requests.memory.
2. Установите нужные значения

Сохранение

Нажмите кнопку Save

Проверка конфигурации

Нажмите кнопку Reload и убедитесь, что изменения применились

С использованием консоли Kubernetes

Шаг

Действие

Запрос kubeconfig для kubectl

Запросите у администратора кластера kubeconfig для kubectl

Настройка выделения ресурсов

В консоли выполните команду: kubectl --kubeconfig=<путь_к_файлу_kubeconfig> set resources deployment kiali-se --limits=cpu=<указать cpu>,memory=<указать memory> --requests=cpu=<указать cpu>,memory=<указать memory>

Изменение количества Pod#

С использованием веб-интерфейса Kubernetes

Шаг

Действия

Логин в веб-консоль Kubernetes

1. Перейдите по ссылке веб-консоли нужного кластера Kubernetes
2. Введите в окне ввода учетных данных логин и пароль

Переход в нужный проект

1. Выберите пункт меню Projects
2. Выберите нужный проект из открывшегося списка

Изменение количества pod

1. Выберите в меню пункт Workload/Deployments
2. Выберите на странице нужное развертывание с Unimapper (при необходимости воспользуйтесь поиском по имени)
3. Перейдите по ссылке в наименовании на вкладку Detail и нажмите стрелку Вверх, чтобы увеличить количество запущенных pod сервиса Unimapper, или стрелку Вниз, чтобы уменьшить

С использованием консоли Kubernetes

Шаг

Действия

Описание

Настройка Kubectl

Настройте файл конфигурации, выполнив команды
kubectl config set-credentials логин/хост:порт --username=логин --password=пароль
kubectl config set-cluster хост:порт --insecure-skip-tls-verify=true --server=https://хост:порт
kubectl config set-context неймспейс/хост:порт/логин --user=логин/хост:порт --namespace=неймспейс --cluster=хост:порт
kubectl config use-context неймспейс/хост:порт/логин

Переход в нужный проект

Введите команду: kubectl config set-context --current --namespace=<имя проекта>

Изменение количества pod

Выполните в консоли команду: kubectl scale --replicas=<N> deployment/<имя deployment>

Выгрузка системного журнала#

С использованием веб-интерфейса Kubernetes

Шаг

Действия

Логин в веб-консоль Kubernetes

1. Перейдите по ссылке веб-консоли нужного кластера Kubernetes.
2. Введите в окне ввода учетных данных логин и пароль

Переход в нужный проект

1. Выберите пункт меню Projects.
2. Выберите нужный проект из открывшегося списка

Изменение количества pod

1. Выберите в меню пункт Workload/Deployments.
2. Выберите на странице нужное развертывание (при необходимости воспользуйтесь поиском по имени).
3. Перейдите по ссылке в наименовании на вкладку Detail и нажмите стрелку Вверх, чтобы увеличить количество запущенных pods сервиса Unimapper или стрелку Вниз, чтобы уменьшить

Выгрузка журнала

1. Выберите в меню пункт Workload/Deployments.
2. Выберите на странице нужное развертывание с Unimapper (при необходимости воспользуйтесь поиском по имени).
3. Перейдите по ссылке в наименовании на вкладку Detail и перейдите на вкладку Pods.
4. Найдите в списке нужный pods, перейдите по ссылке в его наименовании на вкладку Detail.
5. Перейдите на вкладку Logs и нажмите кнопку Download, чтобы скачать журнал

Выход из веб-консоли Kubernetes

1. Нажмите на имя пользователя.
2. Выберите в меню пользователя пункт Log out

С использованием консоли Kubernetes

Шаг

Действия

Описание

Настройка Kubectl

Настройте файл конфигурации, выполнив команды
kubectl config set-credentials логин/хост:порт --username=логин --password=пароль
kubectl config set-cluster хост:порт --insecure-skip-tls-verify=true --server=https://хост:порт
kubectl config set-context неймспейс/хост:порт/логин --user=логин/хост:порт --namespace=неймспейс --cluster=хост:порт
kubectl config use-context неймспейс/хост:порт/логин

Переход в нужный проект

Введите команду: kubectl config set-context --current --namespace=<имя проекта>

Изменение количества pod

Выполните в консоли команду: kubectl scale --replicas=<N> deployment/<имя deployment>

N > 0 — требуемое количество запущенных pods сервиса Unimapper

Выгрузка журнала

Выполните в консоли команду: kubectl logs <имя контейнера> <имя pods> > <имя файла>.txt, где <имя контейнера> может быть названием контейнера приложения сервиса DataMapper