Обновление основного экземпляра системы

Запуск установщика

Чтобы запустить установщик основного экземпляра системы, после скачивания run-файла перейдите в директорию его хранения и запустите его с помощью bash:

bash ./evo.platform_<version>.run
Требуемая версия bash: 4.0 или выше.

Или сделайте его исполняемым и запустите непосредственно:

chmod +x ./evo.platform_<version>.run
./evo.platform_<version>.run

Если в каталоге с установщиком есть файлы переменных окружения, но вам нужно настроить параметры установки вручную, запустите установщик с переменной SKIP_ENV_FILE:

SKIP_ENV_FILE=true bash ./evo.platform_<version>.run

Установщик выведет следующие сведения:

Выбор файла с переменными окружения

Если в каталоге с установщиком находятся один или несколько файлов с переменными окружения и при его запуске не была указана переменная SKIP_ENV_FILE, установщик загрузит файл в соответствии со следующей логикой:

  • Если файл в каталоге только один, установщик будет использовать переменные из этого файла.

  • Если файлов в каталоге больше одного, отобразится окно с их списком, в котором потребуется выбрать нужный файл.

    select env file

Этапы установщика, на которых требуется ввести переменные, указанные в файле конфигурации, будут пропущены. Например, если в файле указаны переменные ANSIBLE_USER и ANSIBLE_PASSWORD или ANSIBLE_BECOME_PASSWORD, этап ввода учетных данных Ansible будет пропущен.

Начало обновления

Выберите режим работы Updating previous version.

install updating

Если версии ClickHouse, PostgreSQL и/или NATS, установленные в кластере, не соответствуют техническим требованиям, при запуске обновления системы установщик попытается обновить их автоматически.

Если версии компонентов значительно устарели, автоматическое обновление будет недоступно и отобразится сообщение с ключевыми словами Please perform a manual update. Пример для PostgreSQL:

Please perform a manual update postgresql to required version >= 15.0.0.

В таком случае выполните ручное обновление необходимых компонентов согласно инструкциям из раздела Ручное обновление компонентов системы и перезапустите обновление системы.

Автоматическое обновление доступно для ClickHouse и PostgreSQL, только если они установлены в кластере Kubernetes. Обновление вынесенных инсталляций ClickHouse и PostgreSQL администратор кластера должен выполнять самостоятельно.

Выбор пространства имен Kubernetes

Выберите пространство имен (namespace) Kubernetes, в котором будет обновлен основной экземпляр системы, на этапе Kubernetes cluster namespace to install.

update namespace selection

Пространство имен по умолчанию default создается автоматически при развертывании кластера Kubernetes и может быть использовано для установки компонентов системы.

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

  • ingress-nginx;

  • kube-node-lease;

  • kube-prometheus-stack;

  • kube-public;

  • kube-system;

  • local-path-provisioner;

  • metallb-system;

  • piraeus-datastore.

Настройка метода загрузки Docker-образов

На этапе Images upload выберите метод загрузки Docker-образов компонентов системы:

  • Direct upload to cluster nodes by Ansible (need SSH-access) — загрузка образов непосредственно на узлы кластера с помощью Ansible.

    Чтобы загрузка образов непосредственно на узлы кластера прошла успешно, удостоверьтесь, что перед установкой системы был настроен SSH-доступ к worker-узлам кластера.
  • Upload to existing images registry — загрузка образов во внешний Docker registry (реестр Docker-образов).

  • Skip images uploading — пропуск загрузки образов, если они уже были ранее загружены на узлы кластера.

images upload method

Если выбрана опция Upload to existing images registry, потребуется указать следующие данные для подключения к Docker registry:

  • Адрес Docker registry, в который будут загружены образы компонентов системы, в следующем формате:

    <registry_host>:<port>/<subpath>

    Здесь:

    • <registry_host> — доменное имя или IP-адрес Docker registry.

    • <port> (опционально) — порт для отправки запросов к Docker registry.

    • <subpath> (опционально) — путь к подкаталогу Docker registry.

    images registry path

  • Требуется ли использовать TLS-соединение при загрузке образов установщиком.

    images registry use tls

  • Логин пользователя, от имени которого осуществляется доступ к Docker registry. Если аутентификация в Docker registry не требуется, поле следует оставить пустым.

    images registry user

  • Если аутентификация в Docker registry требуется — пароль пользователя, от имени которого осуществляется доступ к Docker registry.

    images registry pass

Настройка Ansible

Задайте параметры Ansible на этапе Ansible creds:

  1. Задайте имя пользователя.

    install ansible creds username

  2. Выберите метод аутентификации: по паролю или через ключ.

    install ansible creds auth method

  3. Если выбрана аутентификация по паролю, задайте и подтвердите пароль пользователя.

  4. Если выбрана аутентификация через ключ, выберите вариант повышения привилегий указанного пользователя через sudo:

    install ansible become sudo

    1. Use sudo without password — выберите этот вариант, если для пользователя настроено повышение привилегий через sudo без пароля.

    2. Need password for sudo — выберите этот вариант, если для повышения привилегий пользователя через sudo необходимо ввести пароль. В таком случае введите этот пароль на следующем шаге:

      install ansible become pass

Выбор обновляемых компонентов модуля evo.infra

Выберите, какие компоненты модуля evo.infra необходимо обновить:

infra components

Перемещение по списку опций осуществляется с помощью клавиш со стрелками вверх и вниз. Чтобы выбрать опцию или отменить ее выбор, нажмите на клавишу SPACE.

Настройка сбора метрик и логов с помощью Vector

На этапе Space: Vector observability настройте источники метрик для демона Vector и режим сбора логов хоста.

Каждый из этапов настройки сбора метрик и логов отображается, только если соответствующая настройка не была выполнена при установке системы. В ином случае этап будет пропущен и в системе сохранится ранее указанное значение настройки.
  1. Выберите источник метрик процессора, ОЗУ, диска и сети. Доступные варианты:

    • Vector host_metrics — демон Vector получает метрики напрямую с хоста, монтируя его директории /proc и /sys с помощью томов типа hostPath.

    • Node Exporter — демон Vector обращается к сервису Prometheus Node Exporter. Тома типа hostPath не монтируются.

    vector host metrics source

  2. Выберите источник метрик процессора и ОЗУ подов сервисов:

    • cgroups — метрики контрольных групп (cgroups) собирает sidecar-контейнер, который монтирует директории /proc и /sys с помощью томов типа hostPath.

    • cAdvisor — демон Vector обращается к компоненту Kubelet по порту 10250 и адресу /metrics/cadvisor. Тома типа hostPath не монтируются.

    vector workload metrics source

  3. Выберите режим сбора логов хоста:

    • hostPath — демон Vector получает логи напрямую с хоста, монтируя его директории /var/log и /etc/localtime с помощью томов типа hostPath.

    • sidecar — демон Vector не собирает логи. Сервисы отправляют логи в sidecar-контейнер.

    vector host logs

  4. Выберите, требуется ли добавить liveness-пробы для контейнера vector-sidecar в подах сервисов:

    • false — не добавлять liveness-пробы; сбой контейнера vector-sidecar не приведет к перезапуску всего пода.

    • true — добавить liveness-пробы; сбой контейнера vector-sidecar может привести к перезапуску всего пода.

    vector liveness probes

Завершение обновления

Если обновление прошло успешно, на экране отобразится соответствующее сообщение. Также на экран будет выведен URL-адрес для подключения к системе.

Была ли полезна эта страница?

Обратная связь