.. _Install_FaultTolerance_Minikube_StartingDashboard:

Запуск Dashboard
################

Подготовка к запуску
********************

Сначала необходимо извлечь docker-образ Dashboard из дистрибутива.
Далее запускаем терминал и выполняем в нем команды, настраивающие его на работу с хранилищем docker-образов в Minikube:

.. code-block:: console

    minikube docker-env
    eval $(minikube -p minikube docker-env)

.. note::

    В примерах будет использоваться полный номер версии TerraLink xDE Pro 3.2403.23145.1, который включает номер релиза и билда.
    В случае использования другого номера версии, замените его во всех приведенных примерах команд и содержимого файлов.

Загрузка docker-образа
**********************

Переходим в папку ``Integration.Dashboard`` и загружаем docker-образ из tar-файла:

.. code-block:: console

    docker load -i terralink-xdepro-integration-dashboard-3.2403.23145.1.tar

Результатом выполнения команды будет сообщение о загрузке образа:

.. image:: ./img/Dashboard-LoadImage.png
      :align: center
      :alt: Загрузка docker-образа из файла
      :scale: 69

Создание приложения
*******************

Создаем файл ``dashboard-deployment.yaml`` с конфигурацией приложения:

.. code-block:: yaml

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: dashboard
      labels:
        name: xdepro
        component: dashboard
    spec:
      replicas: 1
      selector:
        matchLabels:
          name: xdepro
          component: dashboard
      template:
        metadata:
          labels:
            name: xdepro
            component: dashboard
        spec:
          volumes:
            - name: dashboard-logs-storage
              persistentVolumeClaim:
                claimName: logs-pv-claim
          containers:
            - name: dashboard-container
              image: terralink-xdepro-integration-dashboard:3.2403.23145.1
              imagePullPolicy: Never
              ports:
                - containerPort: 80
              volumeMounts:
                - mountPath: "/usr/share/TerraLink.xDEPro"
                  name: dashboard-logs-storage
              env:
                - name: DOCFLOW_REST_API_URL
                  value: "http://192.168.49.2:30689/"
                - name: DOCFLOW_LOG_TARGET
                  value: "AsyncFileLog"

В этой конфигурации:

 - создается 1 реплика;
 - в папку ``/usr/share/TerraLink.xDEPro`` монтируется том с логами ``logs-pv-claim``, созданный ранее;
 - для создания контейнеров используется образ ``terralink-xdepro-integration-dashboard:3.2403.23145.1``;
 - параметры контейнера указываются в переменных окружения, хранящихся в поле ``.spec.template.spec.containers.env``.
   Обратите внимание, что для переменной DOCFLOW_REST_API_URL указан адрес, полученный при развертывании компонента Integration API.

Применяем конфигурацию:

.. code-block:: console

    kubectl apply -f dashboard-deployment.yaml

Создание сервиса
****************

Теперь необходимо создать сервис для доступа к приложению извне. Для этого создадим файл ``dashboard-service.yaml`` с конфигурацией сервиса:

.. code-block:: yaml

    apiVersion: v1
    kind: Service
    metadata:
      name: dashboard-service
      labels:
        name: xdepro
        component: dashboard
    spec:
      selector:
        name: xdepro
        component: dashboard
      ports:
        - port: 80
          targetPort: 80
      type: LoadBalancer

Применяем конфигурацию:

.. code-block:: console

    kubectl apply -f dashboard-service.yaml

Получение адреса сервиса
************************

Получаем адрес, по которому можно подключиться к созданному сервису:

.. code-block:: console

    minikube service --url dashboard-service

Команда выведет URL-адрес сервиса, который будет использован для подключения к Dashboard.

.. image:: ./img/Dashboard-GetServiceUrl.png
      :align: center
      :alt: Получение url сервиса
      :scale: 83

Проверка установленного компонента
**********************************

В качестве проверки успешности запуска Dashboard можно открыть страницу в браузере, перейти по полученному адресу и авторизоваться в Dashboard.