From 96f3c8b113331d71039fccb4804884a19617ceda Mon Sep 17 00:00:00 2001 From: Zhbert Date: Fri, 20 Feb 2026 12:35:20 +0300 Subject: [PATCH 01/17] Updates Signed-off-by: Zhbert --- content/documentation/admin/install.md | 139 ++++++++++++++++++++++ content/documentation/admin/install.ru.md | 135 ++++++++++++++++++++- 2 files changed, 273 insertions(+), 1 deletion(-) create mode 100644 content/documentation/admin/install.md diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md new file mode 100644 index 0000000..a0d72a3 --- /dev/null +++ b/content/documentation/admin/install.md @@ -0,0 +1,139 @@ +--- +title: Installation +weight: 11 +--- + +## Enabling the module + +To install Deckhouse Development Platform, enable the `development-platform` module in your Kubernetes cluster running on Deckhouse Kubernetes Platform. You can use [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) with minimal settings: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io # Super administrator email with full access to platform configuration. Can be changed at any time + security: + secretKey: "16charssecretkey" # Secret key for encrypting private data. If changed, API access tokens will need to be regenerated and users will need to re-enter their credentials +``` + +After installation, the Deckhouse Development Platform web UI will be available at `https://ddp.`. + +With this configuration, Redis and PostgreSQL will be deployed into the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use. For production, use dedicated PostgreSQL and Redis instances (see sections below). + +## Connecting external instances + +### Connecting external PostgreSQL + +To use an external PostgreSQL instance, specify connection parameters in the `postgres` section: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: external + host: postgres.example.com # PostgreSQL server hostname or IP address + port: 5432 # PostgreSQL port (default 5432) + database: ddp # Database name + username: ddp_user # Connection username + password: secure_password # Connection password +``` + +### Connecting external Redis + +To use an external Redis instance, specify connection parameters in the `redis` section: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + redis: + mode: external + host: redis.example.com # Redis server hostname or IP address + port: 6379 # Redis port (default 6379) + database: "0" # Redis database index (default "0") + password: redis_password # Connection password (optional; leave empty if Redis has no password) +``` + +### Full example with external instances + +Example configuration with external PostgreSQL and Redis: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: external + host: postgres.production.example.com + port: 5432 + database: ddp + username: ddp_user + password: secure_postgres_password + redis: + mode: external + host: redis.production.example.com + port: 6379 + database: "0" + password: secure_redis_password +``` + +## Installation with internal instances + +If you do not connect external databases (as in the sections above), the platform can deploy PostgreSQL and Redis inside the cluster. Example configuration with internal instances and a private Docker registry: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: internal + image: registry.example.com/postgres:16.3 # PostgreSQL image from private registry + redis: + mode: internal + image: registry.example.com/redis:7.4.0 # Redis image from private registry + additionalImagePullSecrets: + - "custom-registry-secret" # (optional) additional secrets for private registry access +``` diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index b1c0c24..13e7dee 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -3,4 +3,137 @@ title: Установка weight: 11 --- -Процесс установки Deckhouse Development Platform описан в секции [начало работы](https://deckhouse.ru/modules/development-platform/getting-started.html) в документации модуля. +## Включение модуля + +Для установки Deckhouse Development Platform включите модуль `development-platform` в вашем Kubernetes-кластере под управлением Deckhouse Kubernetes Platform. Для этого можно использовать [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) с минимальным количеством настроек: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io # Email супер-администратора, который будет иметь полный доступ к конфигурации платформы. Может быть изменен в любой момент + security: + secretKey: "16charssecretkey" # Секретный ключ для шифрования приватных данных. При изменении потребуется перегенерация токенов доступа к API платформы и повторное заполнение учетных данных пользователями +``` + +После установки веб-интерфейс Deckhouse Development Platform будет доступен по адресу `https://ddp.<ваш домен>`. + +При развертывании в такой конфигурации в кластер будут установлены Redis и PostgreSQL. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации. В промышленной эксплуатации рекомендуется использовать выделенные экземпляры PostgreSQL и Redis (см. разделы ниже). + +## Подключение внешних инстансов + +### Подключение внешнего PostgreSQL + +Для использования внешнего инстанса PostgreSQL необходимо указать параметры подключения в секции `postgres`: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: external + host: postgres.example.com # Имя хоста или IP-адрес сервера PostgreSQL + port: 5432 # Порт PostgreSQL (по умолчанию 5432) + database: ddp # Название базы данных + username: ddp_user # Имя пользователя для подключения + password: secure_password # Пароль для подключения +``` + +### Подключение внешнего Redis + +Для использования внешнего инстанса Redis необходимо указать параметры подключения в секции `redis`: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + redis: + mode: external + host: redis.example.com # Имя хоста или IP-адрес сервера Redis + port: 6379 # Порт Redis (по умолчанию 6379) + database: "0" # Индекс базы данных Redis (по умолчанию "0") + password: redis_password # Пароль для подключения (необязательно; если Redis без пароля — оставить пустым) +``` + +### Полный пример с внешними инстансами + +Пример конфигурации с подключением к внешним инстансам PostgreSQL и Redis: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: external + host: postgres.production.example.com + port: 5432 + database: ddp + username: ddp_user + password: secure_postgres_password + redis: + mode: external + host: redis.production.example.com + port: 6379 + database: "0" + password: secure_redis_password +``` + +## Установка с внутренними инстансами + +Если вы не подключаете внешние базы (как в разделах выше), платформа может разворачивать PostgreSQL и Redis внутри кластера. Пример конфигурации с внутренними инстансами и использованием приватного Docker registry: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: internal + image: registry.example.com/postgres:16.3 # Образ PostgreSQL из приватного registry + redis: + mode: internal + image: registry.example.com/redis:7.4.0 # Образ Redis из приватного registry + additionalImagePullSecrets: + - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry +``` From 9cc7961100109bd478d63f6c758843c73aca9836 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:38:23 +0300 Subject: [PATCH 02/17] Update content/documentation/admin/install.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index a0d72a3..7493ebe 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -17,7 +17,7 @@ spec: version: 1 settings: rbac: - superAdminEmail: admin@deckhouse.io # Super administrator email with full access to platform configuration. Can be changed at any time + superAdminEmail: admin@deckhouse.io # Super administrator email with full access to platform configuration. Can be changed at any time. security: secretKey: "16charssecretkey" # Secret key for encrypting private data. If changed, API access tokens will need to be regenerated and users will need to re-enter their credentials ``` From c57ab3ddfae8e4822219d4fbcebe808ed37ec792 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:39:44 +0300 Subject: [PATCH 03/17] Update content/documentation/admin/install.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index 7493ebe..b9ebc3d 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -19,7 +19,7 @@ spec: rbac: superAdminEmail: admin@deckhouse.io # Super administrator email with full access to platform configuration. Can be changed at any time. security: - secretKey: "16charssecretkey" # Secret key for encrypting private data. If changed, API access tokens will need to be regenerated and users will need to re-enter their credentials + secretKey: "16charssecretkey" # Secret key for encrypting private data. If changed, API access tokens will need to be regenerated and users will need to re-enter their credentials. ``` After installation, the Deckhouse Development Platform web UI will be available at `https://ddp.`. From 08be60f0ed76889557e51ea71effaab46941a42a Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:40:33 +0300 Subject: [PATCH 04/17] Update content/documentation/admin/install.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index b9ebc3d..77ea48f 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -47,7 +47,7 @@ spec: secretKey: "16charssecretkey" postgres: mode: external - host: postgres.example.com # PostgreSQL server hostname or IP address + host: postgres.example.com # PostgreSQL server hostname or IP address. port: 5432 # PostgreSQL port (default 5432) database: ddp # Database name username: ddp_user # Connection username From def3fdbac85fad5ce2b796ed65cd394c5037c5c7 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:40:44 +0300 Subject: [PATCH 05/17] Update content/documentation/admin/install.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index 77ea48f..81a7bc9 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -48,10 +48,10 @@ spec: postgres: mode: external host: postgres.example.com # PostgreSQL server hostname or IP address. - port: 5432 # PostgreSQL port (default 5432) - database: ddp # Database name - username: ddp_user # Connection username - password: secure_password # Connection password + port: 5432 # PostgreSQL port (default 5432). + database: ddp # Database name. + username: ddp_user # Connection username. + password: secure_password # Connection password. ``` ### Connecting external Redis From ce5349c53dfff70a412176ff69055e91e2999874 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:40:54 +0300 Subject: [PATCH 06/17] Update content/documentation/admin/install.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index 81a7bc9..923e2ee 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -73,10 +73,10 @@ spec: secretKey: "16charssecretkey" redis: mode: external - host: redis.example.com # Redis server hostname or IP address - port: 6379 # Redis port (default 6379) - database: "0" # Redis database index (default "0") - password: redis_password # Connection password (optional; leave empty if Redis has no password) + host: redis.example.com # Redis server hostname or IP address. + port: 6379 # Redis port (default 6379). + database: "0" # Redis database index (default "0"). + password: redis_password # Connection password (optional; leave empty if Redis has no password). ``` ### Full example with external instances From 6c8a7df23c6bfb56140478a7ff10965f3f2d84b4 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:41:07 +0300 Subject: [PATCH 07/17] Update content/documentation/admin/install.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index 923e2ee..fcca2e6 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -133,7 +133,7 @@ spec: image: registry.example.com/postgres:16.3 # PostgreSQL image from private registry redis: mode: internal - image: registry.example.com/redis:7.4.0 # Redis image from private registry + image: registry.example.com/redis:7.4.0 # Redis image from private registry. additionalImagePullSecrets: - - "custom-registry-secret" # (optional) additional secrets for private registry access + - "custom-registry-secret" # (optional) additional secrets for private registry access. ``` From d3fe1fd0782a758c24f86128a1c00daabc283cb4 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:41:22 +0300 Subject: [PATCH 08/17] Update content/documentation/admin/install.ru.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.ru.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index 13e7dee..c273a0e 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -17,9 +17,9 @@ spec: version: 1 settings: rbac: - superAdminEmail: admin@deckhouse.io # Email супер-администратора, который будет иметь полный доступ к конфигурации платформы. Может быть изменен в любой момент + superAdminEmail: admin@deckhouse.io # Email супер-администратора, который будет иметь полный доступ к конфигурации платформы. Может быть изменен в любой момент. security: - secretKey: "16charssecretkey" # Секретный ключ для шифрования приватных данных. При изменении потребуется перегенерация токенов доступа к API платформы и повторное заполнение учетных данных пользователями + secretKey: "16charssecretkey" # Секретный ключ для шифрования приватных данных. При изменении потребуется перегенерация токенов доступа к API платформы и повторное заполнение учетных данных пользователями. ``` После установки веб-интерфейс Deckhouse Development Platform будет доступен по адресу `https://ddp.<ваш домен>`. From 96dfd1cfae2562c7ea63f5b10a0783851e55ad19 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:41:31 +0300 Subject: [PATCH 09/17] Update content/documentation/admin/install.ru.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.ru.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index c273a0e..2d26faf 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -47,11 +47,11 @@ spec: secretKey: "16charssecretkey" postgres: mode: external - host: postgres.example.com # Имя хоста или IP-адрес сервера PostgreSQL - port: 5432 # Порт PostgreSQL (по умолчанию 5432) - database: ddp # Название базы данных - username: ddp_user # Имя пользователя для подключения - password: secure_password # Пароль для подключения + host: postgres.example.com # Имя хоста или IP-адрес сервера PostgreSQL. + port: 5432 # Порт PostgreSQL (по умолчанию 5432). + database: ddp # Название базы данных. + username: ddp_user # Имя пользователя для подключения. + password: secure_password # Пароль для подключения. ``` ### Подключение внешнего Redis From e70a5dabc8d4c94822db984f4dc0d708a73a5b08 Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:41:42 +0300 Subject: [PATCH 10/17] Update content/documentation/admin/install.ru.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.ru.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index 2d26faf..751547f 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -73,10 +73,10 @@ spec: secretKey: "16charssecretkey" redis: mode: external - host: redis.example.com # Имя хоста или IP-адрес сервера Redis - port: 6379 # Порт Redis (по умолчанию 6379) - database: "0" # Индекс базы данных Redis (по умолчанию "0") - password: redis_password # Пароль для подключения (необязательно; если Redis без пароля — оставить пустым) + host: redis.example.com # Имя хоста или IP-адрес сервера Redis. + port: 6379 # Порт Redis (по умолчанию 6379). + database: "0" # Индекс базы данных Redis (по умолчанию "0"). + password: redis_password # Пароль для подключения (необязательно; если Redis без пароля — оставить пустым). ``` ### Полный пример с внешними инстансами From 2593fa31e016e751af9a72b5657ee4839a8f62db Mon Sep 17 00:00:00 2001 From: Konstantin Nezhbert Date: Mon, 2 Mar 2026 15:41:53 +0300 Subject: [PATCH 11/17] Update content/documentation/admin/install.ru.md Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Konstantin Nezhbert --- content/documentation/admin/install.ru.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index 751547f..c4fcfd7 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -130,10 +130,10 @@ spec: secretKey: "16charssecretkey" postgres: mode: internal - image: registry.example.com/postgres:16.3 # Образ PostgreSQL из приватного registry + image: registry.example.com/postgres:16.3 # Образ PostgreSQL из приватного registry. redis: mode: internal - image: registry.example.com/redis:7.4.0 # Образ Redis из приватного registry + image: registry.example.com/redis:7.4.0 # Образ Redis из приватного registry. additionalImagePullSecrets: - - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry + - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry. ``` From 4b96a9fe6da29a8ee9516d65bd1f08c48e767205 Mon Sep 17 00:00:00 2001 From: Zhbert Date: Wed, 4 Mar 2026 17:24:12 +0300 Subject: [PATCH 12/17] Updates Signed-off-by: Zhbert --- content/documentation/admin/install.md | 58 ++++++++++++----------- content/documentation/admin/install.ru.md | 58 ++++++++++++----------- 2 files changed, 60 insertions(+), 56 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index fcca2e6..8ac24ae 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -3,6 +3,8 @@ title: Installation weight: 11 --- +Deckhouse Development Platform can be installed in two ways: with **external** PostgreSQL and Redis instances (connecting to databases already deployed outside the cluster) or with **internal** instances (deploying PostgreSQL and Redis inside the cluster). External instances are recommended for production; internal instances are suitable for testing and pilot use. Both options are described below. + ## Enabling the module To install Deckhouse Development Platform, enable the `development-platform` module in your Kubernetes cluster running on Deckhouse Kubernetes Platform. You can use [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) with minimal settings: @@ -24,7 +26,34 @@ spec: After installation, the Deckhouse Development Platform web UI will be available at `https://ddp.`. -With this configuration, Redis and PostgreSQL will be deployed into the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use. For production, use dedicated PostgreSQL and Redis instances (see sections below). +When you do not specify `postgres` and `redis` sections, the platform deploys **internal** PostgreSQL and Redis instances inside the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use; for production, use [external instances](#connecting-external-instances). + +### Configuring internal instances (optional) + +If you use internal instances, you can explicitly set `mode: internal` and specify images from a private Docker registry: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: internal + image: registry.example.com/postgres:16.3 # PostgreSQL image from private registry + redis: + mode: internal + image: registry.example.com/redis:7.4.0 # Redis image from private registry. + additionalImagePullSecrets: + - "custom-registry-secret" # (optional) additional secrets for private registry access. +``` ## Connecting external instances @@ -110,30 +139,3 @@ spec: database: "0" password: secure_redis_password ``` - -## Installation with internal instances - -If you do not connect external databases (as in the sections above), the platform can deploy PostgreSQL and Redis inside the cluster. Example configuration with internal instances and a private Docker registry: - -```yaml -apiVersion: deckhouse.io/v1alpha1 -kind: ModuleConfig -metadata: - name: development-platform -spec: - enabled: true - version: 1 - settings: - rbac: - superAdminEmail: admin@deckhouse.io - security: - secretKey: "16charssecretkey" - postgres: - mode: internal - image: registry.example.com/postgres:16.3 # PostgreSQL image from private registry - redis: - mode: internal - image: registry.example.com/redis:7.4.0 # Redis image from private registry. - additionalImagePullSecrets: - - "custom-registry-secret" # (optional) additional secrets for private registry access. -``` diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index c4fcfd7..b2fcc6e 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -3,6 +3,8 @@ title: Установка weight: 11 --- +Deckhouse Development Platform можно установить двумя способами: с **внешними** инстансами PostgreSQL и Redis (подключение к уже развёрнутым базам данных вне кластера) или с **внутренними** инстансами (развёртывание PostgreSQL и Redis внутри кластера). Внешние инстансы рекомендуются для production, внутренние подходят для тестов и пилотной эксплуатации. Ниже описаны оба варианта. + ## Включение модуля Для установки Deckhouse Development Platform включите модуль `development-platform` в вашем Kubernetes-кластере под управлением Deckhouse Kubernetes Platform. Для этого можно использовать [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) с минимальным количеством настроек: @@ -24,7 +26,34 @@ spec: После установки веб-интерфейс Deckhouse Development Platform будет доступен по адресу `https://ddp.<ваш домен>`. -При развертывании в такой конфигурации в кластер будут установлены Redis и PostgreSQL. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации. В промышленной эксплуатации рекомендуется использовать выделенные экземпляры PostgreSQL и Redis (см. разделы ниже). +При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние инстансы](#подключение-внешних-инстансов). + +### Настройка внутренних инстансов (опционально) + +Если вы используете внутренние инстансы, можно явно указать `mode: internal` и задать образы из приватного Docker registry: + +```yaml +apiVersion: deckhouse.io/v1alpha1 +kind: ModuleConfig +metadata: + name: development-platform +spec: + enabled: true + version: 1 + settings: + rbac: + superAdminEmail: admin@deckhouse.io + security: + secretKey: "16charssecretkey" + postgres: + mode: internal + image: registry.example.com/postgres:16.3 # Образ PostgreSQL из приватного registry. + redis: + mode: internal + image: registry.example.com/redis:7.4.0 # Образ Redis из приватного registry. + additionalImagePullSecrets: + - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry. +``` ## Подключение внешних инстансов @@ -110,30 +139,3 @@ spec: database: "0" password: secure_redis_password ``` - -## Установка с внутренними инстансами - -Если вы не подключаете внешние базы (как в разделах выше), платформа может разворачивать PostgreSQL и Redis внутри кластера. Пример конфигурации с внутренними инстансами и использованием приватного Docker registry: - -```yaml -apiVersion: deckhouse.io/v1alpha1 -kind: ModuleConfig -metadata: - name: development-platform -spec: - enabled: true - version: 1 - settings: - rbac: - superAdminEmail: admin@deckhouse.io - security: - secretKey: "16charssecretkey" - postgres: - mode: internal - image: registry.example.com/postgres:16.3 # Образ PostgreSQL из приватного registry. - redis: - mode: internal - image: registry.example.com/redis:7.4.0 # Образ Redis из приватного registry. - additionalImagePullSecrets: - - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry. -``` From 69ebc2bca52d83535dd4cc9a5fdd96eded7fe452 Mon Sep 17 00:00:00 2001 From: Zhbert Date: Wed, 4 Mar 2026 17:35:07 +0300 Subject: [PATCH 13/17] Updates Signed-off-by: Zhbert --- content/documentation/admin/install.md | 8 +++++--- content/documentation/admin/install.ru.md | 10 ++++++---- 2 files changed, 11 insertions(+), 7 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index 8ac24ae..e4c68e1 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -5,7 +5,7 @@ weight: 11 Deckhouse Development Platform can be installed in two ways: with **external** PostgreSQL and Redis instances (connecting to databases already deployed outside the cluster) or with **internal** instances (deploying PostgreSQL and Redis inside the cluster). External instances are recommended for production; internal instances are suitable for testing and pilot use. Both options are described below. -## Enabling the module +## Installation with internal resources To install Deckhouse Development Platform, enable the `development-platform` module in your Kubernetes cluster running on Deckhouse Kubernetes Platform. You can use [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) with minimal settings: @@ -26,7 +26,7 @@ spec: After installation, the Deckhouse Development Platform web UI will be available at `https://ddp.`. -When you do not specify `postgres` and `redis` sections, the platform deploys **internal** PostgreSQL and Redis instances inside the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use; for production, use [external instances](#connecting-external-instances). +When you do not specify `postgres` and `redis` sections, the platform deploys **internal** PostgreSQL and Redis instances inside the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use; for production, use [external resources](#installation-with-external-resources-for-production). ### Configuring internal instances (optional) @@ -55,7 +55,9 @@ spec: - "custom-registry-secret" # (optional) additional secrets for private registry access. ``` -## Connecting external instances +## Installation with external resources for production + +This installation option is recommended for production: the platform connects to PostgreSQL and Redis deployed outside the cluster, which improves resilience and simplifies backup and scaling of databases. ### Connecting external PostgreSQL diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index b2fcc6e..7b7ba11 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -3,9 +3,9 @@ title: Установка weight: 11 --- -Deckhouse Development Platform можно установить двумя способами: с **внешними** инстансами PostgreSQL и Redis (подключение к уже развёрнутым базам данных вне кластера) или с **внутренними** инстансами (развёртывание PostgreSQL и Redis внутри кластера). Внешние инстансы рекомендуются для production, внутренние подходят для тестов и пилотной эксплуатации. Ниже описаны оба варианта. +Deckhouse Development Platform можно установить двумя способами: с **внешними** инстансами PostgreSQL и Redis (подключение к уже развёрнутым базам данных вне кластера) или с **внутренними** инстансами (развёртывание PostgreSQL и Redis внутри кластера). Внешние инстансы рекомендуются для production, внутренние подходят для тестов и пилотной эксплуатации. -## Включение модуля +## Установка с внутренними ресурсами Для установки Deckhouse Development Platform включите модуль `development-platform` в вашем Kubernetes-кластере под управлением Deckhouse Kubernetes Platform. Для этого можно использовать [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) с минимальным количеством настроек: @@ -26,7 +26,7 @@ spec: После установки веб-интерфейс Deckhouse Development Platform будет доступен по адресу `https://ddp.<ваш домен>`. -При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние инстансы](#подключение-внешних-инстансов). +При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние ресурсы](#установка-с-внешними-ресурсами-для-продакшена). ### Настройка внутренних инстансов (опционально) @@ -55,7 +55,9 @@ spec: - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry. ``` -## Подключение внешних инстансов +## Установка с внешними ресурсами + +Этот вариант установки рекомендуется для production: платформа подключается к уже развёрнутым PostgreSQL и Redis вне кластера, что обеспечивает отказоустойчивость и упрощает резервное копирование и масштабирование баз данных. ### Подключение внешнего PostgreSQL From 4cd263191e6b3b91b92307f0be400439bd95daf8 Mon Sep 17 00:00:00 2001 From: Zhbert Date: Wed, 4 Mar 2026 17:38:44 +0300 Subject: [PATCH 14/17] Updates Signed-off-by: Zhbert --- content/documentation/admin/install.ru.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index 7b7ba11..7275c43 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -26,7 +26,7 @@ spec: После установки веб-интерфейс Deckhouse Development Platform будет доступен по адресу `https://ddp.<ваш домен>`. -При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние ресурсы](#установка-с-внешними-ресурсами-для-продакшена). +При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние ресурсы](#установка-с-внешними-ресурсами). ### Настройка внутренних инстансов (опционально) From 02ec50af1a13132342c78965167a1cceb491e2d8 Mon Sep 17 00:00:00 2001 From: Artem Kladov <6360800+z9r5@users.noreply.github.com> Date: Thu, 5 Mar 2026 14:15:57 +0300 Subject: [PATCH 15/17] Apply suggestions from code review Signed-off-by: Artem Kladov <6360800+z9r5@users.noreply.github.com> --- content/documentation/admin/install.md | 6 +++--- content/documentation/admin/install.ru.md | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index e4c68e1..c378a5f 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -3,9 +3,9 @@ title: Installation weight: 11 --- -Deckhouse Development Platform can be installed in two ways: with **external** PostgreSQL and Redis instances (connecting to databases already deployed outside the cluster) or with **internal** instances (deploying PostgreSQL and Redis inside the cluster). External instances are recommended for production; internal instances are suitable for testing and pilot use. Both options are described below. +Deckhouse Development Platform can be installed in two ways: with [external PostgreSQL and Redis instances](#installation-with-external-instances) (connecting to databases already deployed outside the cluster) or with [internal instances](#installation-with-internal-instances) (deploying PostgreSQL and Redis inside the cluster). External instances are recommended for production; internal instances are suitable for testing and pilot use. Both options are described below. -## Installation with internal resources +## Installation with internal instances To install Deckhouse Development Platform, enable the `development-platform` module in your Kubernetes cluster running on Deckhouse Kubernetes Platform. You can use [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) with minimal settings: @@ -55,7 +55,7 @@ spec: - "custom-registry-secret" # (optional) additional secrets for private registry access. ``` -## Installation with external resources for production +## Installation with external instances This installation option is recommended for production: the platform connects to PostgreSQL and Redis deployed outside the cluster, which improves resilience and simplifies backup and scaling of databases. diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index 7275c43..fb8f072 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -3,9 +3,9 @@ title: Установка weight: 11 --- -Deckhouse Development Platform можно установить двумя способами: с **внешними** инстансами PostgreSQL и Redis (подключение к уже развёрнутым базам данных вне кластера) или с **внутренними** инстансами (развёртывание PostgreSQL и Redis внутри кластера). Внешние инстансы рекомендуются для production, внутренние подходят для тестов и пилотной эксплуатации. +Deckhouse Development Platform можно установить двумя способами: с [внешними инстансами](#установка-с-внешними-инстансами) PostgreSQL и Redis (подключение к уже развёрнутым базам данных вне кластера) или с [внутренними инстансами](#установка-с-внутренними-инстансами) (развёртывание PostgreSQL и Redis внутри кластера). Внешние инстансы рекомендуются для production, внутренние подходят для тестов и пилотной эксплуатации. -## Установка с внутренними ресурсами +## Установка с внутренними инстансами Для установки Deckhouse Development Platform включите модуль `development-platform` в вашем Kubernetes-кластере под управлением Deckhouse Kubernetes Platform. Для этого можно использовать [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) с минимальным количеством настроек: @@ -55,7 +55,7 @@ spec: - "custom-registry-secret" # (опционально) дополнительные секреты для доступа к приватному registry. ``` -## Установка с внешними ресурсами +## Установка с внешними инстансами Этот вариант установки рекомендуется для production: платформа подключается к уже развёрнутым PostgreSQL и Redis вне кластера, что обеспечивает отказоустойчивость и упрощает резервное копирование и масштабирование баз данных. From 3faa59ddd18758c8d94c826331a24803e4759797 Mon Sep 17 00:00:00 2001 From: Artem Kladov <6360800+z9r5@users.noreply.github.com> Date: Thu, 5 Mar 2026 14:18:43 +0300 Subject: [PATCH 16/17] Apply suggestions from code review Signed-off-by: Artem Kladov <6360800+z9r5@users.noreply.github.com> --- content/documentation/admin/install.md | 2 +- content/documentation/admin/install.ru.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index c378a5f..f445481 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -26,7 +26,7 @@ spec: After installation, the Deckhouse Development Platform web UI will be available at `https://ddp.`. -When you do not specify `postgres` and `redis` sections, the platform deploys **internal** PostgreSQL and Redis instances inside the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use; for production, use [external resources](#installation-with-external-resources-for-production). +When you do not specify `postgres` and `redis` sections, the platform deploys **internal** PostgreSQL and Redis instances inside the cluster. This scenario is not recommended for production and is suitable only for testing and pilot use; for production, use [external resources](#installation-with-external-instances). ### Configuring internal instances (optional) diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index fb8f072..fcb1f3b 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -26,7 +26,7 @@ spec: После установки веб-интерфейс Deckhouse Development Platform будет доступен по адресу `https://ddp.<ваш домен>`. -При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние ресурсы](#установка-с-внешними-ресурсами). +При развёртывании без указания секций `postgres` и `redis` платформа разворачивает **внутренние** инстансы PostgreSQL и Redis внутри кластера. Такой сценарий не рекомендуется для production и подходит только для тестов и пилотной эксплуатации; для промышленной эксплуатации используйте [внешние ресурсы](#установка-с-внешними-инстансами). ### Настройка внутренних инстансов (опционально) From 63606ffab04fd2b28173afe270b23af1eb782c05 Mon Sep 17 00:00:00 2001 From: Artem Kladov <6360800+z9r5@users.noreply.github.com> Date: Thu, 5 Mar 2026 14:21:42 +0300 Subject: [PATCH 17/17] Apply suggestions from code review Signed-off-by: Artem Kladov <6360800+z9r5@users.noreply.github.com> --- content/documentation/admin/install.md | 2 +- content/documentation/admin/install.ru.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/documentation/admin/install.md b/content/documentation/admin/install.md index f445481..b9234e8 100644 --- a/content/documentation/admin/install.md +++ b/content/documentation/admin/install.md @@ -7,7 +7,7 @@ Deckhouse Development Platform can be installed in two ways: with [external Post ## Installation with internal instances -To install Deckhouse Development Platform, enable the `development-platform` module in your Kubernetes cluster running on Deckhouse Kubernetes Platform. You can use [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) with minimal settings: +To install Deckhouse Development Platform, enable the `development-platform` module in your Kubernetes cluster running on Deckhouse Kubernetes Platform. You can use [ModuleConfig](/products/kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) with minimal settings: ```yaml apiVersion: deckhouse.io/v1alpha1 diff --git a/content/documentation/admin/install.ru.md b/content/documentation/admin/install.ru.md index fcb1f3b..964ec23 100644 --- a/content/documentation/admin/install.ru.md +++ b/content/documentation/admin/install.ru.md @@ -7,7 +7,7 @@ Deckhouse Development Platform можно установить двумя спо ## Установка с внутренними инстансами -Для установки Deckhouse Development Platform включите модуль `development-platform` в вашем Kubernetes-кластере под управлением Deckhouse Kubernetes Platform. Для этого можно использовать [ModuleConfig](../../../../kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) с минимальным количеством настроек: +Для установки Deckhouse Development Platform включите модуль `development-platform` в вашем Kubernetes-кластере под управлением Deckhouse Kubernetes Platform. Для этого можно использовать [ModuleConfig](/products/kubernetes-platform/documentation/v1/reference/api/cr.html#moduleconfig) с минимальным количеством настроек: ```yaml apiVersion: deckhouse.io/v1alpha1