Управление сервисами и репозиториями

В разделе Сервисы и репозитории доступны подразделы:

• Репозитории;
• Доступные чарты;
• Установленные сервисы;
• Маркетплейс продуктов.

Репозитории #

На странице Репозитории отображается перечень репозиториев, подключенных в кластере. Есть возможность добавить репозиторий, содержащий Helm-чарты сервисов.

Для добавления нового репозитория нажмите кнопку + Добавить репозиторий.

В открывшемся окне:

• задайте название подключаемому репозиторию;
• в поле URL пропишите путь до репозитория. Доступные протоколы для подключения: http, https, oci;
• выберите, нужна ли проверка сертификата для подключения;
• в случае, если к репозиторию ограничен доступ, пропишите логин и пароль пользователя;
• при необходимости определите лейблы и аннотации репозитория.

Чарты из созданного репозитория будут доступны на странице Доступные чарты раздела “Сервисы и репозитории” на вкладке с именем репозитория. Обратите внимание! В случае подключения репозитория с протоколом oci, на вкладке репозитория необходимо ввести название чарта для его последующей установки.

Для просмотра или редактирования данных ранее созданного репозитория нажмите на названия репозитория в списке репозиториев.

На вкладке Репозиторий можно просмотреть статус, состояние и данные подключенного репозитория.

Блок Состояние содержит список состояний, устанавливаемых при подключении репозитория. Чтобы просмотреть дополнительные сведения, нажмите на название состояния из списка. В сведениях состояния отображаются: название состояния, дата и время проверки статуса состояния, причина установки статуса состояния.

В случае неуспешной установки статуса состояния дополнительно доступно сообщение об ошибке подключения репозитория.

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

Также изменить данные возможно с помощью манифеста объекта. Для этого перейдите на вкладку Манифест. После внесения изменений в манифест выполните проверку. Результат проверки будет доступен в правой части экрана. Раскройте блок результата проверки, чтобы увидеть полный манифест. Если валидация формата манифеста репозитория не пройдена, недоступна проверка манифеста.

Сохраните изменения, внесенные в манифест. Несохраненные данные не будут применены.

Для удаления репозитория нажмите на в строке репозитория.

После удаления репозитория сервисы, установленные из чартов этого репозитория в кластеры, останутся в платформе.

Доступные чарты #

На странице Доступные чарты представлены Helm-чарты сервисов, доступных для установки в кластеры. Чарты размещены по вкладкам в соответствии с подключенными репозиториями. По умолчанию доступны Helm-чарты сервисов в репозитории Shturval.

Установка и настройка экземпляра сервиса #

Чтобы установить экземпляр сервиса, нажмите на кнопку Установить на карточке чарта сервиса. На странице Установка чарта необходимо произвести первичную конфигурацию экземпляра сервиса.

Для этого задайте название экземпляра сервиса. Выберите версию чарта (по умолчанию выбрана последняя доступная). Выберите неймспейс, в котором необходимо установить экземпляр сервиса. Внизу выпадающего списка неймспейсов доступна опция создания нового неймспейса.

Определите режим управления:

• Автоматический (Auto) - ресурсы сервиса в неймспейсе будут созданы автоматически, что приведет к авто запуску сервиса в кластере. При внесении изменений в конфигурацию сервиса выбирайте данный режим для автоматического применения обновлений.
• Ручной (Manual) - сервис запускается и обновляется вручную. Это может быть необходимо, если вы хотите использовать версию сервиса, отличную от версии, которая поставляется вместе с кластером.

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

При необходимости определите лейблы и аннотации.

Добавление чарта репозитория, подключенного по oci #

Если репозиторий подключен по протоколу oci, на вкладке репозитория введите название чарта репозитория для установки экземпляра сервиса. Нажмите Проверить версию, чтобы получить список версий чарта.

Когда введено корректное название чарта, будут получены доступные версии чарта для установки. Автоматически к названию подставится последняя версия чарта. Просмотреть список версий и выбрать версию чарта возможно на странице Установка чарта.

Для последующей установки чарта и конфигурации экземпляра сервиса нажмите Проверить чарт, откроется страница Установка чарта. Выполните первичную конфигурацию экземпляра сервиса. Название экземпляра сервиса и версия чарта будут предзаполнены в соответствии с названием чарта и версией, указанными на вкладке репозитория.

Далее настройки экземпляра сервиса на странице Установка чарта идентичны настройкам экземпляра сервиса репозитория shturval, раздел Установка и настройка экземпляра сервиса.

Спецификация сервисов #

Изначально Helm использует параметры конфигурации по умолчанию. Блок Спецификация сервиса есть ни что иное, как values, передаваемые в файле при инсталляции сервиса или его обновлении. Values должен быть в формате YAML. Часть сервисов платформы “Штурвал” имеют предварительную конфигурацию, которую вы можете увидеть сразу после развертывания кластера. Значения customvalues не перезаписываются при обновлении кластера.

Если с чартом сервиса поставляется набор доступных values, они будут отображены в правой части экрана. Values в правой части экрана отображается только для просмотра в том виде, в котором они есть в чарте. Все изменения (кастомизацию) необходимо вносить в левой части в блоке “Спецификация сервиса”.

Завершив первичную конфигурацию сервиса, нажмите кнопку Установить.

Установленный экземпляр сервиса будет доступен для просмотра и редактирования на странице Установленные сервисы.

Установленные сервисы #

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

Чтобы изменить спецификацию, лейблы и аннотации экземпляра сервиса, нажмите на кнопку Управлять на карточке установленного сервиса. После внесения изменений нажмите на кнопку Сохранить.

Обратите внимание: название установленного экземпляра сервиса недоступно для редактирования.

Чтобы удалить экземпляр установленного сервиса нажмите на кнопку Удалить на карточке установленного сервиса. Удаление и отключение критически важных для работы платформы сервисов заблокировано.

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

В случае необходимости самостоятельно изменить версию сервиса перейдите к редактированию сервиса в интерфейсе кастомных ресурсов. Для этого в API-группе ops.shturval.tech перейдите в список сервисов (ShturvalServiceConfig), выберите требуемый сервис и внесите изменение в поле version.

Сервисы репозитория Shturval #