diff --git a/loop-enterprise-edition/README.md b/loop-enterprise-edition/README.md index 6a6eb29..39ceea8 100644 --- a/loop-enterprise-edition/README.md +++ b/loop-enterprise-edition/README.md @@ -299,7 +299,7 @@ kubectl create secret tls your-tls-secret --cert=path/to/cert.crt --key=path/to/ Укажите тег образа Loop: ```yaml image: - tag: "2025-06-10-1" # Например, 2025-06-10-1 + tag: "2025-11-20-1" # Например, 2025-11-20-1 ``` ## 2.3 Настройка Ingress diff --git a/loop-enterprise-edition/values.yaml b/loop-enterprise-edition/values.yaml index 7645ec4..a809bfd 100644 --- a/loop-enterprise-edition/values.yaml +++ b/loop-enterprise-edition/values.yaml @@ -1,7 +1,7 @@ image: registry: registry.loop.ru repository: loop/server - tag: 2025-06-10-1 + tag: 2025-11-20-1 pullPolicy: IfNotPresent # pullSecrets: # - myRegistryKeySecretName diff --git a/loop-enterprise-stack/README.md b/loop-enterprise-stack/README.md index fee0f1c..e6b91a5 100644 --- a/loop-enterprise-stack/README.md +++ b/loop-enterprise-stack/README.md @@ -55,8 +55,7 @@ To run with HTTPS you will need to add a Kubernetes secret for your SSL/TLS cert At minimum the following settings must be updated: -* `global.siteURL` - set this to the URL your users will use to access Loop, e.g. `https://loop.example.com` -* `global.loopLicense` - set this to the contents of your license file or provide an existing secret. `global.existingLicenseSecret.name` `global.existingLicenseSecret.key` +* `MM_SERVICESETTINGS_SITEURL:` - set this to the URL your users will use to access Loop, e.g. `https://loop.example.com` * Database Configuration * Object Storage Configuration @@ -66,11 +65,11 @@ Without these settings, Loop will not run correctly. To set the Loop application version, update: -* `loopApp.image.tag` - set this to the Loop server version you wish to install (e.g. `7.10.2`) +* `image.tag` - set this to the Loop server version you wish to install (e.g. `2025-06-10-1`) ## 2.3 Ingress -If you are using nginx-ingress, set the following under `loopApp`: +If you are using nginx-ingress, set the following: ```yaml ingress: @@ -79,13 +78,13 @@ ingress: - loop.example.com ``` -where `loop.example.com` is your domain name and matches `global.siteURL`. +where `loop.example.com` is your domain name and matches `MM_SERVICESETTINGS_SITEURL:`. ### 2.3.1 HTTPS To run with HTTPS, add an SSL/TLS certificate as a secret to your Kubernetes cluster, either manually or [using cert-manager](#14-certificate-manager). -Set the following under `loopApp` to enable HTTPS: +Set the following to enable HTTPS: ```yaml ingress: @@ -114,13 +113,19 @@ Depending on the DNS service and Ingress you're using, the steps can vary. If yo ### 2.4.1 Database -We use the Bitnami Postgresql chart. - We recommend updating the following settings: -* `postgresql.global.postgresql.auth.password` -* `postgresql.global.postgresql.auth.user` -* `postgresql.global.postgresql.auth.database` +Loop: + +* Set `MM_SQLSETTINGS_DRIVERNAME:` to `postgres` +* Set `MM_SQLSETTINGS_DATASOURCE:`, in secret-values.yaml, to your master DB connection string +* (Optional) Set `MM_SQLSETTINGS_DATASOURCEREPLICAS:` to an array of read replica connection strings + +Postgresql: + +* `postgresql.userDatabase.name` +* `postgresql.userDatabase.user` +* `postgresql.userDatabase.password` ### 2.4.2 Storage @@ -128,10 +133,20 @@ We use Minio for file storage. We recommend updating the following settings: -* `loop-minio.accessKey` -* `loop-minio.secretKey` -* `loop-minio.defaultBuckets` -* `loop-minio.provisioning.users` +Loop: +* `MM_FILESETTINGS_AMAZONS3ACCESSKEYID:` +* `MM_FILESETTINGS_AMAZONS3SECRETACCESSKEY:` +* `MM_FILESETTINGS_AMAZONS3BUCKET:` +* `MM_FILESETTINGS_AMAZONS3ENDPOINT:` + +Minio: +* `rootUser:` +* `rootPassword:` +```yaml + users: + - accessKey: + secretKey: +``` ## 2.5 Push Notifications @@ -153,7 +168,7 @@ $ helm install loop/loop-enterprise-stack --version For example: ```bash $ helm repo add loop https://artifacts.wilix.dev/repository/helm-loop -$ helm install loop/loop-enterprise-stack --version v0.8.2 +$ helm install loop/loop-enterprise-stack --version 2.0.0 ``` If no Helm Chart version is specified the latest version will be installed. @@ -219,27 +234,31 @@ helm repo add loop https://artifacts.wilix.dev/repository/helm-loop ## 2.1 Обязательные настройки -- `global.siteURL` — установите в адрес, по которому пользователи будут получать доступ к Loop, например: +**Минимально необходимые настройки:** + +-- `MM_SERVICESETTINGS_SITEURL:` — установите в адрес, по которому пользователи будут получать доступ к Loop, например: `https://loop.example.com` -- `global.loopLicense` — укажите содержимое лицензионного файла **или** задайте существующий Kubernetes-секрет с ключом: - `global.existingLicenseSecret.name` и `global.existingLicenseSecret.key` +- **Конфигурация базы данных (раздел 2.4.1)** — необходимо настроить подключение к PostgreSQL. + Это может быть внешний сервер или встроенный через Helm-чарт. -- **Конфигурация базы данных** — необходимо настроить подключение к PostgreSQL. +- **Конфигурация объектного хранилища (раздел 2.6.1)** — нужно подключить MinIO или другое совместимое S3-хранилище. -- **Конфигурация объектного хранилища** — нужно подключить MinIO или другое совместимое S3-хранилище. - -Без этих параметров Loop **не будет работать корректно** +Без этих параметров Loop **не будет работать корректно** — сервис не сможет ни загрузить данные, ни сохранить файлы. ## 2.2 Версия приложения -Чтобы указать версию Loop, установите: +Укажите тег образа Loop: +```yaml +image: + tag: "2025-06-10-1" # Например, 2025-06-10-1 +``` -* `loopApp.image.tag` — укажите версию Loop-сервера, которую хотите установить (например: `7.10.2`) +## 2.3 Настройка Ingress -## 2.3 Ingress +### **2.3.1 Ingress с nginx ingress controller** -Если вы используете nginx-ingress, настройте следующее внутри `loopApp`: +Если вы используете `nginx-ingress-controller`, добавьте следующее: ```yaml ingress: @@ -248,13 +267,14 @@ ingress: - loop.example.com ``` -где `loop.example.com` — это ваше доменное имя, совпадающее с `global.siteURL`. +Здесь `loop.example.com` — это ваш домен, и он **должен совпадать с `MM_SERVICESETTINGS_SITEURL:`** (например, `https://loop.example.com`). -### 2.3.1 HTTPS +### **2.3.2 HTTPS (SSL/TLS)** -Для работы по HTTPS добавьте SSL/TLS сертификат в виде секрета в кластер Kubernetes вручную или [с помощью cert-manager](#14-certificate-manager). +Чтобы использовать HTTPS: -Чтобы включить HTTPS, укажите следующее в `loopApp`: +1. Создайте TLS-секрет в Kubernetes **вручную** или с помощью **cert-manager**. +2. Укажите его в `values.yaml` Helm-чарта: ```yaml ingress: @@ -267,6 +287,8 @@ ingress: - loop.example.com ``` + `secretName` — это имя созданного TLS-секрета с ключом и сертификатом (например, от Let's Encrypt или корпоративного CA). + ### 2.3.2 DNS Чтобы направить пользователей с вашего домена на установку Loop, укажите домен на внешний IP или имя хоста, которое предоставляет ваш ingress. @@ -284,13 +306,21 @@ ingress: ### 2.4.1 База данных -Мы используем чарт Bitnami Postgresql. +Мы используем чарт Postgresql. Рекомендуется обновить следующие параметры: -* `postgresql.global.postgresql.auth.password` -* `postgresql.global.postgresql.auth.user` -* `postgresql.global.postgresql.auth.database` +Loop: + +* Установите `MM_SQLSETTINGS_DRIVERNAME:` в значение postgres +* Настройте `MM_SQLSETTINGS_DATASOURCE:` в файле secret-values.yaml, указав строку подключения к основной базе данных +* (Опционально) Настройте `MM_SQLSETTINGS_DATASOURCEREPLICAS:` как массив строк подключения к репликам для чтения + +Postgresql: + +* `postgresql.userDatabase.name` +* `postgresql.userDatabase.user` +* `postgresql.userDatabase.password` ### 2.4.2 Хранилище @@ -298,10 +328,20 @@ ingress: Рекомендуется обновить следующие параметры: -* `loop-minio.accessKey` -* `loop-minio.secretKey` -* `loop-minio.defaultBuckets` -* `loop-minio.provisioning.users` +Loop: +* `MM_FILESETTINGS_AMAZONS3ACCESSKEYID:` +* `MM_FILESETTINGS_AMAZONS3SECRETACCESSKEY:` +* `MM_FILESETTINGS_AMAZONS3BUCKET:` +* `MM_FILESETTINGS_AMAZONS3ENDPOINT:` + +Minio: +* `rootUser:` +* `rootPassword:` +```yaml + users: + - accessKey: + secretKey: +``` ## 2.5 Push-уведомления @@ -320,7 +360,7 @@ $ helm install loop/loop-enterprise-stack --version ```bash $ helm repo add loop https://artifacts.wilix.dev/repository/helm-loop -$ helm install loop/loop-enterprise-stack --version v0.8.2 +$ helm install loop/loop-enterprise-stack --version 2.0.0 ``` Если версия чарта не указана, будет установлена последняя доступная. diff --git a/loop-enterprise-stack/values.yaml b/loop-enterprise-stack/values.yaml index fdb0e3e..e379fd3 100644 --- a/loop-enterprise-stack/values.yaml +++ b/loop-enterprise-stack/values.yaml @@ -4,7 +4,7 @@ loop-enterprise-edition: image: registry: registry.loop.ru repository: loop/server - tag: 2025-06-10-1 + tag: 2025-11-20-1 pullPolicy: IfNotPresent name: loop-server