Loading documentation...
Preparing Ring content
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Preparing Ring content
Preparing Ring content
Preparing Ring content
Используйте вкладки Основатель / Разработчик на боковой панели документации, чтобы отфильтровать эту страницу. Шаги ниже сверены со структурой публичного репозитория: ring/install.sh, ring/web/, ring/cli/, ring/scripts/.
Публичный репозиторий connectplatform/ring (Apache 2.0) содержит всё необходимое, чтобы запустить клон на одном сервере: приложение Next.js в web/, мастер install.sh, сплющенную схему PostgreSQL, файлы Docker и ring CLI. Манифестов Kubernetes, CI-процессов и конвейера сборки Ringdom в нём нет.
Известная проблема: ./install.sh setup-db и npm run db:apply-schema не работают на свежем публичном checkout. Первая команда ищет web/scripts/setup-clone-db.sh, вторая ищет ring/data/schema.sql, и ни одного из этих путей после переезда в web/ не существует. Примените web/data/schema.sql через psql, как показано в шаге 2 ниже.
| Раньше в документации | Текущий публичный репозиторий |
|---|---|
Запустите scripts/setup-dev.sh, npm run setup:env, scripts/run-migration.sh | Ни одного из этих скриптов в публичном дереве нет. Мастером является ./install.sh (режим dev) |
| Примените нумерованные миграции | Новые установки применяют только web/data/schema.sql (сплющенная v4.1.0) |
cli/ игнорируется git | cli/ поставляется публично. См. Ring CLI |
docker compose up поднимает полный стек | В закоммиченном docker-compose.yml нет сервиса Postgres и нет DB_BACKEND_MODE. В docker-compose.template.yml есть и то, и другое |
Один Linux-сервер с Node и PostgreSQL: именно этот путь описан на странице. На обзорной странице сравниваются все варианты.
То же приложение в контейнере. Более простые обновления и откаты на любом хосте с Docker.
Хостинг для Next.js. Сочетайте его с Supabase, собственным PostgreSQL или режимом firebase-full.
Для поселенцев Ringdom хостинг в Kubernetes, CI и конвейер развёртывания запускают за них.
Нет, не в режиме k8s-postgres-fcm. Без NEXT_PUBLIC_FIREBASE_PROJECT_ID приложение пишет предупреждение в журнал и отключает push. Режим firebase-full устроен иначе: он требует ключей AUTH_FIREBASE_*.
Да. Используйте ring upgrade для предпросмотра, затем ring upgrade --apply. Команда сливает системные файлы из upstream и никогда не коммитит за вас.
Подробнее: все переменные окружения, которые читает приложение, сверх минимального набора с этой страницы.
Предпосылка: выбор между k8s-postgres-fcm, supabase-fcm и firebase-full.
Следующий шаг: упакуйте ту же сборку в контейнер.
См. также: что Ringdom запускает для поселенцев и чего нет в публичном репозитории.
Используйте вкладки Основатель / Разработчик на боковой панели документации, чтобы отфильтровать эту страницу. Шаги ниже сверены со структурой публичного репозитория: ring/install.sh, ring/web/, ring/cli/, ring/scripts/.
Публичный репозиторий connectplatform/ring (Apache 2.0) содержит всё необходимое, чтобы запустить клон на одном сервере: приложение Next.js в web/, мастер install.sh, сплющенную схему PostgreSQL, файлы Docker и ring CLI. Манифестов Kubernetes, CI-процессов и конвейера сборки Ringdom в нём нет.
Известная проблема: ./install.sh setup-db и npm run db:apply-schema не работают на свежем публичном checkout. Первая команда ищет web/scripts/setup-clone-db.sh, вторая ищет ring/data/schema.sql, и ни одного из этих путей после переезда в web/ не существует. Примените web/data/schema.sql через psql, как показано в шаге 2 ниже.
| Раньше в документации | Текущий публичный репозиторий |
|---|---|
Запустите scripts/setup-dev.sh, npm run setup:env, scripts/run-migration.sh | Ни одного из этих скриптов в публичном дереве нет. Мастером является ./install.sh (режим dev) |
| Примените нумерованные миграции | Новые установки применяют только web/data/schema.sql (сплющенная v4.1.0) |
cli/ игнорируется git | cli/ поставляется публично. См. Ring CLI |
docker compose up поднимает полный стек | В закоммиченном docker-compose.yml нет сервиса Postgres и нет DB_BACKEND_MODE. В docker-compose.template.yml есть и то, и другое |
Один Linux-сервер с Node и PostgreSQL: именно этот путь описан на странице. На обзорной странице сравниваются все варианты.
То же приложение в контейнере. Более простые обновления и откаты на любом хосте с Docker.
Хостинг для Next.js. Сочетайте его с Supabase, собственным PostgreSQL или режимом firebase-full.
Для поселенцев Ringdom хостинг в Kubernetes, CI и конвейер развёртывания запускают за них.
Нет, не в режиме k8s-postgres-fcm. Без NEXT_PUBLIC_FIREBASE_PROJECT_ID приложение пишет предупреждение в журнал и отключает push. Режим firebase-full устроен иначе: он требует ключей AUTH_FIREBASE_*.
Да. Используйте ring upgrade для предпросмотра, затем ring upgrade --apply. Команда сливает системные файлы из upstream и никогда не коммитит за вас.
Подробнее: все переменные окружения, которые читает приложение, сверх минимального набора с этой страницы.
Предпосылка: выбор между k8s-postgres-fcm, supabase-fcm и firebase-full.
Следующий шаг: упакуйте ту же сборку в контейнер.
См. также: что Ringdom запускает для поселенцев и чего нет в публичном репозитории.
Используйте вкладки Основатель / Разработчик на боковой панели документации, чтобы отфильтровать эту страницу. Шаги ниже сверены со структурой публичного репозитория: ring/install.sh, ring/web/, ring/cli/, ring/scripts/.
Публичный репозиторий connectplatform/ring (Apache 2.0) содержит всё необходимое, чтобы запустить клон на одном сервере: приложение Next.js в web/, мастер install.sh, сплющенную схему PostgreSQL, файлы Docker и ring CLI. Манифестов Kubernetes, CI-процессов и конвейера сборки Ringdom в нём нет.
Известная проблема: ./install.sh setup-db и npm run db:apply-schema не работают на свежем публичном checkout. Первая команда ищет web/scripts/setup-clone-db.sh, вторая ищет ring/data/schema.sql, и ни одного из этих путей после переезда в web/ не существует. Примените web/data/schema.sql через psql, как показано в шаге 2 ниже.
| Раньше в документации | Текущий публичный репозиторий |
|---|---|
Запустите scripts/setup-dev.sh, npm run setup:env, scripts/run-migration.sh | Ни одного из этих скриптов в публичном дереве нет. Мастером является ./install.sh (режим dev) |
| Примените нумерованные миграции | Новые установки применяют только web/data/schema.sql (сплющенная v4.1.0) |
cli/ игнорируется git | cli/ поставляется публично. См. Ring CLI |
docker compose up поднимает полный стек | В закоммиченном docker-compose.yml нет сервиса Postgres и нет DB_BACKEND_MODE. В docker-compose.template.yml есть и то, и другое |
Один Linux-сервер с Node и PostgreSQL: именно этот путь описан на странице. На обзорной странице сравниваются все варианты.
То же приложение в контейнере. Более простые обновления и откаты на любом хосте с Docker.
Хостинг для Next.js. Сочетайте его с Supabase, собственным PostgreSQL или режимом firebase-full.
Для поселенцев Ringdom хостинг в Kubernetes, CI и конвейер развёртывания запускают за них.
Нет, не в режиме k8s-postgres-fcm. Без NEXT_PUBLIC_FIREBASE_PROJECT_ID приложение пишет предупреждение в журнал и отключает push. Режим firebase-full устроен иначе: он требует ключей AUTH_FIREBASE_*.
Да. Используйте ring upgrade для предпросмотра, затем ring upgrade --apply. Команда сливает системные файлы из upstream и никогда не коммитит за вас.
Подробнее: все переменные окружения, которые читает приложение, сверх минимального набора с этой страницы.
Предпосылка: выбор между k8s-postgres-fcm, supabase-fcm и firebase-full.
Следующий шаг: упакуйте ту же сборку в контейнер.
См. также: что Ringdom запускает для поселенцев и чего нет в публичном репозитории.
install.sh, а затем передаёт вам сервер и секреты из .env.local.Клонируйте репозиторий и запустите мастер
Режим dev проверяет систему, создаёт ring-config.json из ring-config.template.json, если файла нет, выполняет npm install, проводит через настройку Firebase и OAuth и записывает web/.env.local из env.local.template со сгенерированным AUTH_SECRET. Пока отвечайте нет на вопрос о базе данных (см. предупреждение выше).
Создайте базу данных и примените схему
Предоставьте роли приложения доступ к схеме public. Не запускайте data/migrations/*.sql на пустой базе данных. Эти файлы уже включены в schema.sql.
Задайте обязательное окружение
| Переменная | Зачем |
|---|---|
DB_BACKEND_MODE=k8s-postgres-fcm | Обязательна. PostgreSQL плюс необязательный push через FCM. Кластер не обязательно должен быть Kubernetes |
DB_HOST, DB_NAME, DB_USER, DB_PASSWORD | Обязательны в этом режиме (validateBackendModeConfig) |
DB_PORT, DB_SSL | В шаблоне по умолчанию 5432 и false |
AUTH_SECRET | Шифрование сессий Auth.js |
NEXT_PUBLIC_API_URL, AUTH_URL | Ваш публичный origin |
PAYMENT_DEFAULT_PROCESSOR | wayforpay, stripe или paypal |
NEXT_PUBLIC_FIREBASE_PROJECT_ID | Необязательна. Если её нет, push отключён |
Соберите, запустите и проверьте состояние
npm start запускает собственный server.ts, а не next start. Держите его под менеджером процессов, например systemd. Из корня репозитория npm run build и npm start делегируют выполнение в web/ через scripts/run-web.sh.
install.sh./install.sh prod предлагает три варианта: Vercel (устанавливает Vercel CLI, выполняет vercel --prod), Ubuntu по SSH и Kubernetes. Вариант Kubernetes применяет k8s/*.yaml только тогда, когда вы сами создали каталог k8s/. Для контейнеров начните с Dockerfile (многоэтапный node:25-alpine, цель runtime, порт 3000) и docker-compose.template.yml.
| Путь | Причина |
|---|---|
Манифесты и секреты k8s/ | Продакшн-топология Ringdom |
Процессы .forgejo/ | Удаляются из зеркала на GitHub скриптом scripts/push-github-oss.sh |
Order Lab (features/crm/lab, my-orders, my-jobs, маршруты калькулятора) | Только в empire-оверлее. Это контролирует scripts/check-no-org-leak.sh |
install.sh, а затем передаёт вам сервер и секреты из .env.local.Клонируйте репозиторий и запустите мастер
Режим dev проверяет систему, создаёт ring-config.json из ring-config.template.json, если файла нет, выполняет npm install, проводит через настройку Firebase и OAuth и записывает web/.env.local из env.local.template со сгенерированным AUTH_SECRET. Пока отвечайте нет на вопрос о базе данных (см. предупреждение выше).
Создайте базу данных и примените схему
Предоставьте роли приложения доступ к схеме public. Не запускайте data/migrations/*.sql на пустой базе данных. Эти файлы уже включены в schema.sql.
Задайте обязательное окружение
| Переменная | Зачем |
|---|---|
DB_BACKEND_MODE=k8s-postgres-fcm | Обязательна. PostgreSQL плюс необязательный push через FCM. Кластер не обязательно должен быть Kubernetes |
DB_HOST, DB_NAME, DB_USER, DB_PASSWORD | Обязательны в этом режиме (validateBackendModeConfig) |
DB_PORT, DB_SSL | В шаблоне по умолчанию 5432 и false |
AUTH_SECRET | Шифрование сессий Auth.js |
NEXT_PUBLIC_API_URL, AUTH_URL | Ваш публичный origin |
PAYMENT_DEFAULT_PROCESSOR | wayforpay, stripe или paypal |
NEXT_PUBLIC_FIREBASE_PROJECT_ID | Необязательна. Если её нет, push отключён |
Соберите, запустите и проверьте состояние
npm start запускает собственный server.ts, а не next start. Держите его под менеджером процессов, например systemd. Из корня репозитория npm run build и npm start делегируют выполнение в web/ через scripts/run-web.sh.
install.sh./install.sh prod предлагает три варианта: Vercel (устанавливает Vercel CLI, выполняет vercel --prod), Ubuntu по SSH и Kubernetes. Вариант Kubernetes применяет k8s/*.yaml только тогда, когда вы сами создали каталог k8s/. Для контейнеров начните с Dockerfile (многоэтапный node:25-alpine, цель runtime, порт 3000) и docker-compose.template.yml.
| Путь | Причина |
|---|---|
Манифесты и секреты k8s/ | Продакшн-топология Ringdom |
Процессы .forgejo/ | Удаляются из зеркала на GitHub скриптом scripts/push-github-oss.sh |
Order Lab (features/crm/lab, my-orders, my-jobs, маршруты калькулятора) | Только в empire-оверлее. Это контролирует scripts/check-no-org-leak.sh |
install.sh, а затем передаёт вам сервер и секреты из .env.local.Клонируйте репозиторий и запустите мастер
Режим dev проверяет систему, создаёт ring-config.json из ring-config.template.json, если файла нет, выполняет npm install, проводит через настройку Firebase и OAuth и записывает web/.env.local из env.local.template со сгенерированным AUTH_SECRET. Пока отвечайте нет на вопрос о базе данных (см. предупреждение выше).
Создайте базу данных и примените схему
Предоставьте роли приложения доступ к схеме public. Не запускайте data/migrations/*.sql на пустой базе данных. Эти файлы уже включены в schema.sql.
Задайте обязательное окружение
| Переменная | Зачем |
|---|---|
DB_BACKEND_MODE=k8s-postgres-fcm | Обязательна. PostgreSQL плюс необязательный push через FCM. Кластер не обязательно должен быть Kubernetes |
DB_HOST, DB_NAME, DB_USER, DB_PASSWORD | Обязательны в этом режиме (validateBackendModeConfig) |
DB_PORT, DB_SSL | В шаблоне по умолчанию 5432 и false |
AUTH_SECRET | Шифрование сессий Auth.js |
NEXT_PUBLIC_API_URL, AUTH_URL | Ваш публичный origin |
PAYMENT_DEFAULT_PROCESSOR | wayforpay, stripe или paypal |
NEXT_PUBLIC_FIREBASE_PROJECT_ID | Необязательна. Если её нет, push отключён |
Соберите, запустите и проверьте состояние
npm start запускает собственный server.ts, а не next start. Держите его под менеджером процессов, например systemd. Из корня репозитория npm run build и npm start делегируют выполнение в web/ через scripts/run-web.sh.
install.sh./install.sh prod предлагает три варианта: Vercel (устанавливает Vercel CLI, выполняет vercel --prod), Ubuntu по SSH и Kubernetes. Вариант Kubernetes применяет k8s/*.yaml только тогда, когда вы сами создали каталог k8s/. Для контейнеров начните с Dockerfile (многоэтапный node:25-alpine, цель runtime, порт 3000) и docker-compose.template.yml.
| Путь | Причина |
|---|---|
Манифесты и секреты k8s/ | Продакшн-топология Ringdom |
Процессы .forgejo/ | Удаляются из зеркала на GitHub скриптом scripts/push-github-oss.sh |
Order Lab (features/crm/lab, my-orders, my-jobs, маршруты калькулятора) | Только в empire-оверлее. Это контролирует scripts/check-no-org-leak.sh |