82 lines
5.4 KiB
Markdown
82 lines
5.4 KiB
Markdown
# Yonote Helm Chart
|
||
|
||
**Критическое изменение**
|
||
|
||
Данный чарт предназначен только для новых развертываний!
|
||
|
||
Версия 2.x.x не совместима с предыдущими версиями 1.x.x данного чарта. Если вы попытаетесь использовать этот чарт для обновления существующего развертывания Yonote, это приведет к потере данных.
|
||
|
||
Руководство по миграции будет предоставлено в ближайшее время.
|
||
|
||
|
||
## Обзор
|
||
|
||
Этот Helm chart позволяет развернуть **Yonote** в Kubernetes. Он предоставляет быстрый и простой способ установки, настройки и управления приложением с помощью Helm.
|
||
|
||
Мы запускаем сервисы Yonote в отдельных подах, что улучшает отказоустойчивость и стабильность системы. Такой подход позволяет каждому сервису иметь свою собственную среду выполнения и управлять ресурсами более эффективно.
|
||
|
||
## Требования
|
||
|
||
- Kubernetes cluster
|
||
- Helm
|
||
- Ingress Controller (nginx/traefik)
|
||
|
||
## Установка
|
||
|
||
### 1. Добавление репозиториев Helm
|
||
|
||
Перед установкой зависимостей необходимо добавить репозитории, из которых будут загружаться чарты:
|
||
|
||
```bash
|
||
helm repo add dysnix https://dysnix.github.io/charts
|
||
helm repo add bitnami https://charts.bitnami.com/bitnami
|
||
helm repo update
|
||
```
|
||
|
||
### 2. Выполните сборку зависимостей Helm chart
|
||
|
||
```bash
|
||
helm dependency build
|
||
```
|
||
|
||
### 3. Настройка значений
|
||
|
||
Перед развертыванием приложения через Helm необходимо внести валидные значения в файлы values.yaml и secret-values.yaml. Эти файлы содержат параметры конфигурации, которые будут использованы при установке приложения.
|
||
|
||
Настройте необходимые параметры. В файлах values.yaml и secret-values.yaml вы найдете различные секции, каждая из которых соответствует определенной части конфигурации приложения. Внимательно изучите комментарии в этих файлах; они указывают на места, где необходимо внести изменения. Обратите особое внимание на секцию ingress, так как её настройка важна для правильной работы приложения. Вам потребуется заменить или настроить значения в этой секции в соответствии с вашими требованиями.
|
||
Также обратите внимание на все строки с доменом example.com — его необходимо заменить на ваше собственное доменное имя, которое будет использоваться для работы приложения. Учтите, что путь в переменных и в конфигурации Ingress менять не нужно, заменяйте только сам домен.
|
||
|
||
Более подробно ознакомиться с переменными вы можете по следующей ссылке: https://yo.yonote.ru/share/onprem/doc/peremennye-okruzheniya-mOI8Jl6B05
|
||
|
||
### 4. Запуск приложения
|
||
|
||
После настройки значений выполните команду:
|
||
|
||
```bash
|
||
helm install app -f values.yaml -f secret-values.yaml -n yonote-onprem .
|
||
```
|
||
После выполнения команды начнётся установка приложения и всех дополнительных сервисов к нему. Остаётся только подождать, пока все сервисы запустятся.
|
||
|
||
### 5. Keycloak
|
||
|
||
Перед первым входом в Yonote необходимо обновить поле **Valid redirect URIs** клиента yonote в области (realm) Yonote в системе Keycloak.
|
||
|
||
Уже существуют две записи, поэтому достаточно просто скопировать их и отредактировать.
|
||
|
||
Например:
|
||
|
||
Существующие записи:
|
||
* http://example.com/*
|
||
* https://example.com/*
|
||
|
||
Добавить следующие:
|
||
* http://app.example.com/*
|
||
* https://app.example.com/*
|
||
* https://app.example.com/auth/oidc.callback/*
|
||
* https://team.example.com/*
|
||
|
||
Примечание: символы * в URL-адресах являются подстановочными знаками и обозначают любые дополнительные пути после указанного базового URL.
|
||
|
||
### Обратная связь
|
||
|
||
Если у вас есть вопросы или вам нужна помощь, пишите на email: hello@yonote.ru |