OpportunitiesEntities
Docs
    Ring Platform

    Futuro descentralizado que se construye a sí mismo

    Iniciar sesión
    Entities
    Opportunities
    Store
    Docs
    Conceptos de la plataforma
    RING EconomíaSonoratek LLCImpacto globalIA encuentra Web3
    Empezar
    Inicio rápidoCalculadoraHoja de ruta
    Privacidad|Contacto
    v1.104.26|Sonoratek LLC

    Documentation

    Conceptos, valor y escenarios típicos de clon — menos código.

    Primeros pasos
    Requisitos previos
    Instalación
    Validación del primer éxito
    Próximos pasos
    Funcionalidades
    Blogs de miembros
    Personalización
    Ringization playbook
    Despliegue
    Despliegue autoalojado
    Arquitectura
    Arquitectura de News Kingdom
    Desarrollo
    OSS frente a enterprise

    Entrada rápida (CTOs · auditores · agentes)

    Bienvenida — misión y audiencias
    Referencia rápida
    Primeros pasos
    Arquitectura y Auth.js
    Modos de backend y bases de datos (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Lecturas de seguridad y cumplimiento
    ringdom.org — base LegioX
    Código fuente — licencia MIT (GitHub)

    Documentation

    Conceptos, valor y escenarios típicos de clon — menos código.

    Primeros pasos
    Requisitos previos
    Instalación
    Validación del primer éxito
    Próximos pasos
    Funcionalidades
    Blogs de miembros
    Personalización
    Ringization playbook
    Despliegue
    Despliegue autoalojado
    Arquitectura
    Arquitectura de News Kingdom
    Desarrollo
    OSS frente a enterprise

    Entrada rápida (CTOs · auditores · agentes)

    Bienvenida — misión y audiencias
    Referencia rápida
    Primeros pasos
    Arquitectura y Auth.js
    Modos de backend y bases de datos (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Lecturas de seguridad y cumplimiento
    ringdom.org — base LegioX
    Código fuente — licencia MIT (GitHub)

    Documentation

    Conceptos, valor y escenarios típicos de clon — menos código.

    Primeros pasos
    Requisitos previos
    Instalación
    Validación del primer éxito
    Próximos pasos
    Funcionalidades
    Blogs de miembros
    Personalización
    Ringization playbook
    Despliegue
    Despliegue autoalojado
    Arquitectura
    Arquitectura de News Kingdom
    Desarrollo
    OSS frente a enterprise

    Entrada rápida (CTOs · auditores · agentes)

    Bienvenida — misión y audiencias
    Referencia rápida
    Primeros pasos
    Arquitectura y Auth.js
    Modos de backend y bases de datos (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Deploy (Docker · k8s)
    Lecturas de seguridad y cumplimiento
    ringdom.org — base LegioX
    Código fuente — licencia MIT (GitHub)
    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring Logo

    Loading documentation...

    Preparing Ring content

    Ring CLI

    Estado: Ring CLI se distribuye en el repositorio público en cli/. La documentación anterior decía que era exclusivo de enterprise, y eso ya no es cierto. upgrade, config y test funcionan con cualquier clon. prod y status esperan un clúster de Kubernetes al que accedas por SSH y manifiestos que aportes tú. Usa las pestañas Fundador / Desarrollador de la barra lateral para filtrar esta página.

    El comando ring es una pequeña herramienta de Node.js (commander, Node 18 o posterior) que vive junto a la aplicación en el repositorio de Layer 1: ring/cli/ al lado de ring/web/. Se encarga de tres tareas: traer a tu clon las actualizaciones de Ring desde upstream, mantener una configuración de despliegue local y desplegar una imagen Docker en Kubernetes.

    La documentación anterior decíaRepositorio actual
    La CLI no está en el repositorio público de GitHubcli/ se versiona en la raíz del repositorio y se publica
    Usa npm link y luego ring --versionEjecuta npm run cli:install desde web/ y luego ring --help
    ring deploy prodEl comando es ring prod. No existe el subcomando deploy
    La comunidad solo usa scriptsLa comunidad puede usar ring upgrade para fusiones seguras desde upstream

    Qué hace la CLI por tu clon

    Mantente al día

    ring upgrade muestra qué archivos del sistema Ring cambiaron en upstream y solo los fusiona cuando tú lo indicas.

    Alojamiento propio

    ¿Sin clúster? Usa install.sh y un servidor sencillo con Node o Docker. La CLI es opcional.

    Alojamiento gestionado

    A los colonos de Ringdom se les ejecuta el pipeline de compilación y despliegue.

    Escenarios típicos

    1. Hiciste un fork de Ring hace meses. Tu desarrollador ejecuta ring upgrade para ver qué cambió en upstream, revisa el diff y luego lo aplica. No se hace ningún commit automáticamente.
    2. Operas tu propio Kubernetes. Tu desarrollador apunta la CLI a tu nodo de control, tu registro y tu namespace, y publica nuevas versiones con .

    Instalación

    1. 1

      Enlaza el binario

    2. 2

      Apúntala a tu infraestructura

      La configuración se guarda en ~/.ring-platform.org/config.json y parte de los valores por defecto de cli/config.js.

    Comandos (de cli/index.js)

    ComandoQué haceOpciones principales
    ring upgradeFusión a tres bandas de los archivos del sistema de upstream en tu clon. Por defecto solo muestra una vista previa--apply, --repo <url>, --branch <name>, --force
    ring configLee y escribe ~/.ring-platform.org/config.json--set k=v, --get k, --list, --reset
    ring testComprobaciones de base de datos y servicios

    Carencias conocidas

    Documentación relacionada

    Related documentation

    Community tooling

    Siguiente paso: la lista completa de scripts públicos de configuración que acompañan a la CLI.

    OSS vs enterprise

    Ver también: qué partes del pipeline de la CLI solo funcionan dentro de Ringdom.

    Self-hosted deployment

    Mismo flujo: desplegar sin Kubernetes, donde la CLI es opcional.

    1. Docs
    2. /Ring CLI
    Actualizado 1 oct 20264 min de escucha

    Ring CLI

    Estado: Ring CLI se distribuye en el repositorio público en cli/. La documentación anterior decía que era exclusivo de enterprise, y eso ya no es cierto. upgrade, config y test funcionan con cualquier clon. prod y status esperan un clúster de Kubernetes al que accedas por SSH y manifiestos que aportes tú. Usa las pestañas Fundador / Desarrollador de la barra lateral para filtrar esta página.

    El comando ring es una pequeña herramienta de Node.js (commander, Node 18 o posterior) que vive junto a la aplicación en el repositorio de Layer 1: ring/cli/ al lado de ring/web/. Se encarga de tres tareas: traer a tu clon las actualizaciones de Ring desde upstream, mantener una configuración de despliegue local y desplegar una imagen Docker en Kubernetes.

    La documentación anterior decíaRepositorio actual
    La CLI no está en el repositorio público de GitHubcli/ se versiona en la raíz del repositorio y se publica
    Usa npm link y luego ring --versionEjecuta npm run cli:install desde web/ y luego ring --help
    ring deploy prodEl comando es ring prod. No existe el subcomando deploy
    La comunidad solo usa scriptsLa comunidad puede usar ring upgrade para fusiones seguras desde upstream

    Qué hace la CLI por tu clon

    Mantente al día

    ring upgrade muestra qué archivos del sistema Ring cambiaron en upstream y solo los fusiona cuando tú lo indicas.

    Alojamiento propio

    ¿Sin clúster? Usa install.sh y un servidor sencillo con Node o Docker. La CLI es opcional.

    Alojamiento gestionado

    A los colonos de Ringdom se les ejecuta el pipeline de compilación y despliegue.

    Escenarios típicos

    1. Hiciste un fork de Ring hace meses. Tu desarrollador ejecuta ring upgrade para ver qué cambió en upstream, revisa el diff y luego lo aplica. No se hace ningún commit automáticamente.
    2. Operas tu propio Kubernetes. Tu desarrollador apunta la CLI a tu nodo de control, tu registro y tu namespace, y publica nuevas versiones con .

    Instalación

    1. 1

      Enlaza el binario

    2. 2

      Apúntala a tu infraestructura

      La configuración se guarda en ~/.ring-platform.org/config.json y parte de los valores por defecto de cli/config.js.

    Comandos (de cli/index.js)

    ComandoQué haceOpciones principales
    ring upgradeFusión a tres bandas de los archivos del sistema de upstream en tu clon. Por defecto solo muestra una vista previa--apply, --repo <url>, --branch <name>, --force
    ring configLee y escribe ~/.ring-platform.org/config.json--set k=v, --get k, --list, --reset
    ring testComprobaciones de base de datos y servicios

    Carencias conocidas

    Documentación relacionada

    Related documentation

    Community tooling

    Siguiente paso: la lista completa de scripts públicos de configuración que acompañan a la CLI.

    OSS vs enterprise

    Ver también: qué partes del pipeline de la CLI solo funcionan dentro de Ringdom.

    Self-hosted deployment

    Mismo flujo: desplegar sin Kubernetes, donde la CLI es opcional.

    1. Docs
    2. /Ring CLI
    Actualizado 1 oct 20264 min de escucha

    Ring CLI

    Estado: Ring CLI se distribuye en el repositorio público en cli/. La documentación anterior decía que era exclusivo de enterprise, y eso ya no es cierto. upgrade, config y test funcionan con cualquier clon. prod y status esperan un clúster de Kubernetes al que accedas por SSH y manifiestos que aportes tú. Usa las pestañas Fundador / Desarrollador de la barra lateral para filtrar esta página.

    El comando ring es una pequeña herramienta de Node.js (commander, Node 18 o posterior) que vive junto a la aplicación en el repositorio de Layer 1: ring/cli/ al lado de ring/web/. Se encarga de tres tareas: traer a tu clon las actualizaciones de Ring desde upstream, mantener una configuración de despliegue local y desplegar una imagen Docker en Kubernetes.

    La documentación anterior decíaRepositorio actual
    La CLI no está en el repositorio público de GitHubcli/ se versiona en la raíz del repositorio y se publica
    Usa npm link y luego ring --versionEjecuta npm run cli:install desde web/ y luego ring --help
    ring deploy prodEl comando es ring prod. No existe el subcomando deploy
    La comunidad solo usa scriptsLa comunidad puede usar ring upgrade para fusiones seguras desde upstream

    Qué hace la CLI por tu clon

    Mantente al día

    ring upgrade muestra qué archivos del sistema Ring cambiaron en upstream y solo los fusiona cuando tú lo indicas.

    Alojamiento propio

    ¿Sin clúster? Usa install.sh y un servidor sencillo con Node o Docker. La CLI es opcional.

    Alojamiento gestionado

    A los colonos de Ringdom se les ejecuta el pipeline de compilación y despliegue.

    Escenarios típicos

    1. Hiciste un fork de Ring hace meses. Tu desarrollador ejecuta ring upgrade para ver qué cambió en upstream, revisa el diff y luego lo aplica. No se hace ningún commit automáticamente.
    2. Operas tu propio Kubernetes. Tu desarrollador apunta la CLI a tu nodo de control, tu registro y tu namespace, y publica nuevas versiones con .

    Instalación

    1. 1

      Enlaza el binario

    2. 2

      Apúntala a tu infraestructura

      La configuración se guarda en ~/.ring-platform.org/config.json y parte de los valores por defecto de cli/config.js.

    Comandos (de cli/index.js)

    ComandoQué haceOpciones principales
    ring upgradeFusión a tres bandas de los archivos del sistema de upstream en tu clon. Por defecto solo muestra una vista previa--apply, --repo <url>, --branch <name>, --force
    ring configLee y escribe ~/.ring-platform.org/config.json--set k=v, --get k, --list, --reset
    ring testComprobaciones de base de datos y servicios

    Carencias conocidas

    Documentación relacionada

    Related documentation

    Community tooling

    Siguiente paso: la lista completa de scripts públicos de configuración que acompañan a la CLI.

    OSS vs enterprise

    Ver también: qué partes del pipeline de la CLI solo funcionan dentro de Ringdom.

    Self-hosted deployment

    Mismo flujo: desplegar sin Kubernetes, donde la CLI es opcional.

    1. Docs
    2. /Ring CLI
    Actualizado 1 oct 20264 min de escucha
    ring prod
  1. Solo necesitas un servidor. Prescinde de la CLI. Sigue la guía de alojamiento propio.

    2. De serie, los valores por defecto de la CLI apuntan al clúster de producción y al registro propios de Ringdom. Pide a tu desarrollador que configure tus propios valores con ring config antes de ejecutar prod o status.

    --type db-connection|db-service|user-data|username
    ring prodBuild de Docker, push, kubectl apply, set image, espera del rollout--deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run
    ring statusPods, servicios e ingress por SSH, luego GET {app.url}/api/healthninguna

    ring prod también tiene --forge-buildkit y --from-forge. Ambas controlan el builder privado de Ringdom y no sirven fuera de él.

    Cómo funciona ring upgrade

    • Upstream: upgrade.repoUrl es por defecto https://github.com/connectplatform/ring, rama main, nombre del remoto ring-upstream.
    • Base: el último commit de upstream sincronizado (upgrade.lastSyncedRef). Solo se tocan los archivos que cambiaron entre la base y upstream.
    • Exclusiones: las rutas de .reggie-propagate-exclude.json siempre se omiten.
    • Seguridad: los conflictos se dejan como marcadores estándar de git. No se hace ningún commit. El historial se guarda en .ring-upgrade-history.json en la raíz de git.

    Qué necesita ring prod

    EntradaDe dónde sale
    Repositorio de la imagenRING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (por defecto: registro de Ringdom)
    Manifiestosweb/k8s/deployment.yaml, o si no k8s/ en el overlay de la org (cli/paths.js resolveK8sDir). No están en el repositorio público
    Secretos del clúster--apply-k8s-secrets lee RING_K8S_SECRETS_YAML o k8s/secrets.yaml
    Argumentos de buildJSON en RING_CLI_SECRETS_PATH (build_args)
    Host con kubectlk8s.controlNode, o RING_K8S_SSH_HOST para una sola ejecución

    Ejecuta siempre primero ring prod --dry-run. Imprime cada comando de build, push y kubectl sin ejecutarlos.

    ring prod
  2. Solo necesitas un servidor. Prescinde de la CLI. Sigue la guía de alojamiento propio.

    3. De serie, los valores por defecto de la CLI apuntan al clúster de producción y al registro propios de Ringdom. Pide a tu desarrollador que configure tus propios valores con ring config antes de ejecutar prod o status.

    --type db-connection|db-service|user-data|username
    ring prodBuild de Docker, push, kubectl apply, set image, espera del rollout--deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run
    ring statusPods, servicios e ingress por SSH, luego GET {app.url}/api/healthninguna

    ring prod también tiene --forge-buildkit y --from-forge. Ambas controlan el builder privado de Ringdom y no sirven fuera de él.

    Cómo funciona ring upgrade

    • Upstream: upgrade.repoUrl es por defecto https://github.com/connectplatform/ring, rama main, nombre del remoto ring-upstream.
    • Base: el último commit de upstream sincronizado (upgrade.lastSyncedRef). Solo se tocan los archivos que cambiaron entre la base y upstream.
    • Exclusiones: las rutas de .reggie-propagate-exclude.json siempre se omiten.
    • Seguridad: los conflictos se dejan como marcadores estándar de git. No se hace ningún commit. El historial se guarda en .ring-upgrade-history.json en la raíz de git.

    Qué necesita ring prod

    EntradaDe dónde sale
    Repositorio de la imagenRING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (por defecto: registro de Ringdom)
    Manifiestosweb/k8s/deployment.yaml, o si no k8s/ en el overlay de la org (cli/paths.js resolveK8sDir). No están en el repositorio público
    Secretos del clúster--apply-k8s-secrets lee RING_K8S_SECRETS_YAML o k8s/secrets.yaml
    Argumentos de buildJSON en RING_CLI_SECRETS_PATH (build_args)
    Host con kubectlk8s.controlNode, o RING_K8S_SSH_HOST para una sola ejecución

    Ejecuta siempre primero ring prod --dry-run. Imprime cada comando de build, push y kubectl sin ejecutarlos.

    ring prod
  3. Solo necesitas un servidor. Prescinde de la CLI. Sigue la guía de alojamiento propio.

    4. De serie, los valores por defecto de la CLI apuntan al clúster de producción y al registro propios de Ringdom. Pide a tu desarrollador que configure tus propios valores con ring config antes de ejecutar prod o status.

    --type db-connection|db-service|user-data|username
    ring prodBuild de Docker, push, kubectl apply, set image, espera del rollout--deploy-version, --skip-build, --skip-push, --skip-deploy, --skip-manifest-apply, --apply-k8s-secrets, --dry-run
    ring statusPods, servicios e ingress por SSH, luego GET {app.url}/api/healthninguna

    ring prod también tiene --forge-buildkit y --from-forge. Ambas controlan el builder privado de Ringdom y no sirven fuera de él.

    Cómo funciona ring upgrade

    • Upstream: upgrade.repoUrl es por defecto https://github.com/connectplatform/ring, rama main, nombre del remoto ring-upstream.
    • Base: el último commit de upstream sincronizado (upgrade.lastSyncedRef). Solo se tocan los archivos que cambiaron entre la base y upstream.
    • Exclusiones: las rutas de .reggie-propagate-exclude.json siempre se omiten.
    • Seguridad: los conflictos se dejan como marcadores estándar de git. No se hace ningún commit. El historial se guarda en .ring-upgrade-history.json en la raíz de git.

    Qué necesita ring prod

    EntradaDe dónde sale
    Repositorio de la imagenRING_DOCKER_REGISTRY / RING_DOCKER_NAMESPACE / RING_DOCKER_IMAGE (por defecto: registro de Ringdom)
    Manifiestosweb/k8s/deployment.yaml, o si no k8s/ en el overlay de la org (cli/paths.js resolveK8sDir). No están en el repositorio público
    Secretos del clúster--apply-k8s-secrets lee RING_K8S_SECRETS_YAML o k8s/secrets.yaml
    Argumentos de buildJSON en RING_CLI_SECRETS_PATH (build_args)
    Host con kubectlk8s.controlNode, o RING_K8S_SSH_HOST para una sola ejecución

    Ejecuta siempre primero ring prod --dry-run. Imprime cada comando de build, push y kubectl sin ejecutarlos.