Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Preparing Ring content
Preparing Ring content
Preparing Ring content
Статус: Ring CLI поставляется в публичном репозитории в cli/. Раньше документация утверждала, что CLI доступен только в enterprise-версии, но это уже не так. upgrade, config и test работают для любого клона. prod и status ожидают кластер Kubernetes, к которому вы подключаетесь по SSH, и манифесты, которые вы предоставляете сами. Используйте вкладки Основатель / Разработчик на боковой панели, чтобы отфильтровать эту страницу.
Команда ring представляет собой небольшой инструмент на Node.js (commander, Node 18 или новее), который лежит рядом с приложением в репозитории Layer 1: ring/cli/ рядом с ring/web/. Она решает три задачи: подтягивает обновления Ring из upstream в ваш клон, хранит локальную конфигурацию развёртывания и выкатывает Docker-образ в Kubernetes.
| Раньше в документации | Текущий репозиторий |
|---|---|
| CLI нет в публичном репозитории GitHub | cli/ отслеживается в корне репозитория и публикуется |
Выполните npm link, затем ring --version | Выполните npm run cli:install из web/, затем ring --help |
ring deploy prod | Команда называется ring prod. Подкоманды deploy нет |
| Сообщество пользуется только скриптами | Сообщество может использовать ring upgrade для безопасных слияний из upstream |
ring upgrade показывает, какие системные файлы Ring изменились в upstream, и сливает их только по вашей команде.
Нет кластера? Используйте install.sh и обычный хост с Node или Docker. CLI не обязателен.
Для поселенцев Ringdom конвейер сборки и развёртывания запускают за них.
ring upgrade, чтобы увидеть изменения в upstream, просматривает diff и затем применяет его. Ничего не коммитится автоматически.Статус: Ring CLI поставляется в публичном репозитории в cli/. Раньше документация утверждала, что CLI доступен только в enterprise-версии, но это уже не так. upgrade, config и test работают для любого клона. prod и status ожидают кластер Kubernetes, к которому вы подключаетесь по SSH, и манифесты, которые вы предоставляете сами. Используйте вкладки Основатель / Разработчик на боковой панели, чтобы отфильтровать эту страницу.
Команда ring представляет собой небольшой инструмент на Node.js (commander, Node 18 или новее), который лежит рядом с приложением в репозитории Layer 1: ring/cli/ рядом с ring/web/. Она решает три задачи: подтягивает обновления Ring из upstream в ваш клон, хранит локальную конфигурацию развёртывания и выкатывает Docker-образ в Kubernetes.
| Раньше в документации | Текущий репозиторий |
|---|---|
| CLI нет в публичном репозитории GitHub | cli/ отслеживается в корне репозитория и публикуется |
Выполните npm link, затем ring --version | Выполните npm run cli:install из web/, затем ring --help |
ring deploy prod | Команда называется ring prod. Подкоманды deploy нет |
| Сообщество пользуется только скриптами | Сообщество может использовать ring upgrade для безопасных слияний из upstream |
ring upgrade показывает, какие системные файлы Ring изменились в upstream, и сливает их только по вашей команде.
Нет кластера? Используйте install.sh и обычный хост с Node или Docker. CLI не обязателен.
Для поселенцев Ringdom конвейер сборки и развёртывания запускают за них.
ring upgrade, чтобы увидеть изменения в upstream, просматривает diff и затем применяет его. Ничего не коммитится автоматически.Статус: Ring CLI поставляется в публичном репозитории в cli/. Раньше документация утверждала, что CLI доступен только в enterprise-версии, но это уже не так. upgrade, config и test работают для любого клона. prod и status ожидают кластер Kubernetes, к которому вы подключаетесь по SSH, и манифесты, которые вы предоставляете сами. Используйте вкладки Основатель / Разработчик на боковой панели, чтобы отфильтровать эту страницу.
Команда ring представляет собой небольшой инструмент на Node.js (commander, Node 18 или новее), который лежит рядом с приложением в репозитории Layer 1: ring/cli/ рядом с ring/web/. Она решает три задачи: подтягивает обновления Ring из upstream в ваш клон, хранит локальную конфигурацию развёртывания и выкатывает Docker-образ в Kubernetes.
| Раньше в документации | Текущий репозиторий |
|---|---|
| CLI нет в публичном репозитории GitHub | cli/ отслеживается в корне репозитория и публикуется |
Выполните npm link, затем ring --version | Выполните npm run cli:install из web/, затем ring --help |
ring deploy prod | Команда называется ring prod. Подкоманды deploy нет |
| Сообщество пользуется только скриптами | Сообщество может использовать ring upgrade для безопасных слияний из upstream |
ring upgrade показывает, какие системные файлы Ring изменились в upstream, и сливает их только по вашей команде.
Нет кластера? Используйте install.sh и обычный хост с Node или Docker. CLI не обязателен.
Для поселенцев Ringdom конвейер сборки и развёртывания запускают за них.
ring upgrade, чтобы увидеть изменения в upstream, просматривает diff и затем применяет его. Ничего не коммитится автоматически.ring prodСразу после установки значения CLI по умолчанию указывают на собственный продакшн-кластер и реестр Ringdom. Попросите разработчика задать ваши значения через ring config, прежде чем запускать prod или status.
ring prod | Сборка Docker, push, kubectl apply, set image, ожидание rollout | --deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run |
ring status | Поды, сервисы и ingress по SSH, затем GET {app.url}/api/health | нет |
У ring prod также есть --forge-buildkit и --from-forge. Оба параметра управляют приватным сборщиком Ringdom и вне его бесполезны.
ring upgradeupgrade.repoUrl по умолчанию https://github.com/connectplatform/ring, ветка main, имя remote ring-upstream.upgrade.lastSyncedRef). Затрагиваются только файлы, изменённые между базой и upstream..reggie-propagate-exclude.json всегда пропускаются..ring-upgrade-history.json в корне git.ring prod| Входные данные | Откуда берутся |
|---|---|
| Репозиторий образа | RING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (по умолчанию: реестр Ringdom) |
| Манифесты | web/k8s/deployment.yaml, иначе k8s/ в org-оверлее (cli/paths.js resolveK8sDir). Их нет в публичном репозитории |
| Секреты кластера | --apply-k8s-secrets читает RING_K8S_SECRETS_YAML или k8s/secrets.yaml |
| Аргументы сборки | JSON в RING_CLI_SECRETS_PATH (build_args) |
| Хост с kubectl | k8s.controlNode или RING_K8S_SSH_HOST для одного запуска |
Всегда сначала запускайте ring prod --dry-run. Эта команда выводит каждую команду сборки, push и kubectl, не выполняя их.
ring prodСразу после установки значения CLI по умолчанию указывают на собственный продакшн-кластер и реестр Ringdom. Попросите разработчика задать ваши значения через ring config, прежде чем запускать prod или status.
ring prod | Сборка Docker, push, kubectl apply, set image, ожидание rollout | --deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run |
ring status | Поды, сервисы и ingress по SSH, затем GET {app.url}/api/health | нет |
У ring prod также есть --forge-buildkit и --from-forge. Оба параметра управляют приватным сборщиком Ringdom и вне его бесполезны.
ring upgradeupgrade.repoUrl по умолчанию https://github.com/connectplatform/ring, ветка main, имя remote ring-upstream.upgrade.lastSyncedRef). Затрагиваются только файлы, изменённые между базой и upstream..reggie-propagate-exclude.json всегда пропускаются..ring-upgrade-history.json в корне git.ring prod| Входные данные | Откуда берутся |
|---|---|
| Репозиторий образа | RING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (по умолчанию: реестр Ringdom) |
| Манифесты | web/k8s/deployment.yaml, иначе k8s/ в org-оверлее (cli/paths.js resolveK8sDir). Их нет в публичном репозитории |
| Секреты кластера | --apply-k8s-secrets читает RING_K8S_SECRETS_YAML или k8s/secrets.yaml |
| Аргументы сборки | JSON в RING_CLI_SECRETS_PATH (build_args) |
| Хост с kubectl | k8s.controlNode или RING_K8S_SSH_HOST для одного запуска |
Всегда сначала запускайте ring prod --dry-run. Эта команда выводит каждую команду сборки, push и kubectl, не выполняя их.
ring prodСразу после установки значения CLI по умолчанию указывают на собственный продакшн-кластер и реестр Ringdom. Попросите разработчика задать ваши значения через ring config, прежде чем запускать prod или status.
ring prod | Сборка Docker, push, kubectl apply, set image, ожидание rollout | --deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run |
ring status | Поды, сервисы и ingress по SSH, затем GET {app.url}/api/health | нет |
У ring prod также есть --forge-buildkit и --from-forge. Оба параметра управляют приватным сборщиком Ringdom и вне его бесполезны.
ring upgradeupgrade.repoUrl по умолчанию https://github.com/connectplatform/ring, ветка main, имя remote ring-upstream.upgrade.lastSyncedRef). Затрагиваются только файлы, изменённые между базой и upstream..reggie-propagate-exclude.json всегда пропускаются..ring-upgrade-history.json в корне git.ring prod| Входные данные | Откуда берутся |
|---|---|
| Репозиторий образа | RING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (по умолчанию: реестр Ringdom) |
| Манифесты | web/k8s/deployment.yaml, иначе k8s/ в org-оверлее (cli/paths.js resolveK8sDir). Их нет в публичном репозитории |
| Секреты кластера | --apply-k8s-secrets читает RING_K8S_SECRETS_YAML или k8s/secrets.yaml |
| Аргументы сборки | JSON в RING_CLI_SECRETS_PATH (build_args) |
| Хост с kubectl | k8s.controlNode или RING_K8S_SSH_HOST для одного запуска |
Всегда сначала запускайте ring prod --dry-run. Эта команда выводит каждую команду сборки, push и kubectl, не выполняя их.