Administradores # Ejecuta tu propio servidor de Welley Nuestra herramienta de línea de comandos instala todo lo que Welley necesita en una sola máquina Linux. Puede ser un servidor en la nube o tu propio hardware. [Leer: Inicio rápido: despliegue mínimo de Welley](https://welley.com/es/administrators/docs/quick-start/) [Leer: Welley CLI](https://welley.com/es/administrators/docs/cli/) [Instala Docker Engine](https://docs.docker.com/engine/install/) Planeamos publicar Welley como código abierto en el futuro. Todavía no se ha anunciado una fecha de lanzamiento ni una licencia. ## Prepara el host, el DNS y el correo Estos son los requisitos iniciales de la guía de inicio rápido. La capacidad que necesitas depende de tus usuarios y de tu carga de trabajo. ### Host Linux - Ubuntu 24.04 LTS u otra distribución actual similar. - Empieza con 2 vCPU, 4 GB de RAM y 60 GB de disco. - Usa una dirección IPv4 pública fija y un usuario que no sea root con sudo. ### Red - Permite TCP 80 y 443 de entrada desde internet. Permite TCP 22 desde tu propia red. - Deja libre el puerto 80 para el desafío del certificado y la renovación semanal del certificado. ### DNS del sitio - Apunta tu dominio y storage. a la dirección IP del host. - Crea ambos registros antes de instalar. La CLI los comprueba y se detiene si no resuelven al host. ### SMTP y correo del administrador - Ten a mano el host SMTP, el usuario, la contraseña y la dirección del remitente. El valor predeterminado es STARTTLS en el puerto 587. - También necesitarás un correo de administrador para el primer inicio de sesión y para recuperar la contraseña. ### DNS del correo - Configura SPF, DMARC y el DKIM que genera tu proveedor, para el dominio de la dirección del remitente. - Usa el valor SPF exacto de tu proveedor. Combínalo con tu registro SPF existente en lugar de añadir un segundo registro. - La CLI te avisa si falta SPF o DMARC. No puede comprobar el selector DKIM de tu proveedor. ## Instala Docker Engine y Compose Sigue las instrucciones oficiales de Docker para tu distribución de Linux. Después, da acceso a Docker a tu usuario de despliegue. [Instalación de Docker Engine](https://docs.docker.com/engine/install/) ### Añade al usuario al grupo de Docker Reemplaza por tu usuario de despliegue que no sea root. Después de ejecutar este comando, cierra sesión y vuelve a iniciarla. ``` sudo usermod -aG docker ``` ### Comprueba Docker y Compose Ambos comandos deben funcionar para ese usuario. ``` docker ps docker compose version ``` ## Descarga la CLI Elige el binario para la máquina en la que ejecutarás la CLI. El host de despliegue en sí tiene que ejecutar Linux. ### Linux, x86-64 ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/amd64" -o wlycli chmod +x wlycli ./wlycli -v ``` ### Linux, ARM64 ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/arm64" -o wlycli chmod +x wlycli ./wlycli -v ``` ### macOS, Apple silicon ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/arm64" -o wlycli chmod +x wlycli ./wlycli -v ``` ### macOS, Intel ``` curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/amd64" -o wlycli chmod +x wlycli ./wlycli -v ``` - Estos comandos descargan del canal estable y muestran la versión de la CLI. - La versión cambia con cada lanzamiento nuevo. Usa la documentación más reciente de la CLI cuando instales. ## Crea el despliegue Ejecuta este comando en el host Linux que preparaste. Reemplaza el dominio, el correo y los valores SMTP de ejemplo por los tuyos. ``` ./wlycli deploy create \ -d example.com \ -e admin@example.com \ --smtp-host smtp.example.com \ --smtp-user "$MAIL_USER" \ --smtp-password "$MAIL_PASSWORD" \ --smtp-from noreply@example.com ``` | Ajuste | Valor predeterminado | | --- | --- | | Directorio de instalación | ~/.welley/. El dominio de ejemplo produce el nombre de proyecto example\_com. | | Base de datos | PostgreSQL incluido, con los datos dentro del directorio de instalación. | | Componentes | Plataforma Welley, pipeline de RAG, Nginx, Redis y PostgreSQL, con contenedores de mantenimiento. | | Certificados | Let’s Encrypt mediante Certbot, con renovación semanal. | | Multimedia | Subidas y archivos estáticos en https://storage.. | | Actualizaciones | Canal estable, con revisión diaria. El proceso de actualización evita las interrupciones del servicio siempre que es posible. | | Servicios opcionales | La configuración mínima no añade una base de datos administrada, CDN, telemetría ni integración con Slack. | - Antes de ejecutarlo, define MAIL\_USER y MAIL\_PASSWORD con tus credenciales SMTP. - La guía de inicio rápido requiere estas seis opciones. - El comando comprueba el DNS, escribe los archivos del despliegue, obtiene un certificado con Certbot e inicia los contenedores. - El comando deploy es un alias de deployment. ## Inicia sesión y comprueba el resultado La contraseña de administrador generada está en el registro de la plataforma. Mantén esa salida en privado. ### Encuentra la contraseña inicial Este nombre de contenedor es para example.com. Para tu propio dominio, cambia el nombre del proyecto. ``` docker logs example_com-platform-blue-1 | grep "Auto-init complete" ``` ### Inicia sesión Abre tu dominio e inicia sesión con el correo de administrador que indicaste con -e. Cambia de inmediato la contraseña generada. ### Comprueba los contenedores Según la guía de inicio rápido, deberías ver nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal y snoopy. ``` docker ps ``` ## Usa la CLI para administrar La CLI también tiene comandos para la API de la plataforma. Tu cuenta sigue necesitando los permisos de cada operación. - Antes de ejecutar una operación, revisa sus opciones actuales en la ayuda del comando. - El comando login recibe la URL base de la API, el correo y la contraseña. Guarda el token de sesión que recibe. - Por ahora, el comando de inicio de sesión muestra su token de sesión en el registro cuando termina correctamente. Mantén esa salida en privado. Grupos de comandos: `accounts`, `posts`, `apps`, `emojis`, `feeds`, `reports`, `rules`, `settings`. ### Mostrar los comandos disponibles ``` ./wlycli --help ``` ### Mostrar los comandos de despliegue ``` ./wlycli deployment --help ``` ### Mostrar las opciones de inicio de sesión ``` ./wlycli login --help ``` ### Mostrar las opciones de configuración ``` ./wlycli settings --help ``` ## Actualizaciones y recuperación De forma predeterminada, un despliegue busca actualizaciones estables todos los días. El administrador del servidor puede gestionar las versiones en la interfaz de administración. - Si los archivos de tu despliegue siguen siendo válidos pero algunos contenedores fallan, la guía de inicio rápido indica que ejecutes restart, que vuelve a crear los contenedores. - Create no se ejecutará de nuevo mientras el directorio del proyecto o sus contenedores sigan existiendo. - La opción de eliminación forzada borra los archivos del despliegue y la base de datos incluida. No es un paso de recuperación y no conserva tus datos. - La skill deploy-server todavía usa el nombre deployment update. La CLI actual tiene deployment auto-update en su lugar. Revisa la ayuda actual de la CLI antes de hacer mantenimiento a mano. ### Volver a crear los contenedores desde el despliegue existente ``` ./wlycli deploy restart -d example.com ``` Vuelve a crear los contenedores a partir de tu configuración guardada. No borra los datos del despliegue. ## Desplegar con un asistente de IA Si tu asistente de IA admite paquetes SKILL.md, descarga nuestra skill oficial deploy-server. Te guía en un despliegue en DigitalOcean. Por ahora, la skill solo cubre DigitalOcean. El inicio rápido de la CLI también funciona con otros proveedores de nube y con tu propio host Linux. ### Cómo usarlo - Extrae el paquete y carga el directorio deploy-server de la forma en que tu asistente instala skills. - Pide al asistente que use $deploy-server. - La skill te pide el dominio, el acceso al DNS, la configuración de SSH, los datos de SMTP y el correo del administrador. - Puede configurar una VM en DigitalOcean y, si quieres, una base de datos PostgreSQL administrada. Confirma contigo los datos del despliegue y el precio de la base de datos administrada. ### Antes de descargar - El paquete es una copia sin cambios de la skill original. - Sus ejemplos de descarga y actualización están desactualizados. Obtén la URL de descarga estable actual en el inicio rápido de este sitio web. Revisa la ayuda de la CLI antes del mantenimiento. - La skill no incluye credenciales de la nube ni un servidor en funcionamiento, y no podemos garantizar que funcione con todos los asistentes. El paquete tiene `SKILL.md`, `agents/openai.yaml` y `references/digitalocean.md`. Ambas descargas tienen los mismos archivos. [Descargar deploy-server.zip (10,7 KB)](https://welley.com/downloads/deploy-server.zip) [Descargar deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Documentos de referencia La documentación completa de la CLI y los archivos de la skill de despliegue. Puedes leerlos aquí sin una cuenta. - [**Welley CLI** docs/index.md](https://welley.com/es/administrators/docs/cli/) - [**Inicio rápido: despliegue mínimo de Welley** docs/quick-start.md](https://welley.com/es/administrators/docs/quick-start/) - [**Desplegar el servidor** skills/deploy-server/SKILL.md](https://welley.com/es/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/es/administrators/docs/deploy-server-openai-yaml/) - [**Referencia de DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/es/administrators/docs/deploy-server-digitalocean/)