Primeros pasos con herramientas de desarrollo

Esta guía te ayuda a implementar y configurar un servidor de herramientas de desarrollo en ServerPrism. Aprenderás cómo pedir tu servidor, entender el proceso de primer arranque y comenzar a configurar la herramienta elegida.

Cómo pedir en ServerPrism

1. Selecciona un plan: Elige un plan con al menos 2 GB de RAM. Para proyectos más grandes o más usuarios, considera 4 GB o más, hasta 16 GB. Puedes actualizar tu plan más tarde desde el panel de cliente de ServerPrism.
2. Elige una región: Selecciona la ubicación del centro de datos más cercana a ti o a tus usuarios principales para obtener el mejor rendimiento.
3. Elige tu entorno de ejecución: Durante el proceso de pedido, selecciona la herramienta de desarrollo específica que deseas instalar (por ejemplo, Code-Server, Forgejo, Gitea). Esta se instalará automáticamente.
4. Implementar: Completa tu pedido y tu servidor comenzará a aprovisionarse.

Primer arranque

Después de la implementación, tu servidor se iniciará automáticamente. El proceso de arranque inicial instala todos los componentes necesarios para la herramienta de desarrollo elegida. Puedes monitorear el progreso en la pestaña Console del panel de ServerPrism.

Tu servidor estará listo cuando veas una salida que indique que el servicio se ha iniciado correctamente, a menudo mostrando un puerto de escucha o un mensaje de éxito específico de la herramienta (por ejemplo, "Server started", "Listening on port XXXX").

Conexión / invitación de jugadores

Los métodos de conexión varían según la herramienta que hayas elegido:

• Code-Server, Forgejo, Gitea, Haste-Server, LanguageTool, Reposilite: Estas herramientas suelen ser accesibles a través de un navegador web. La dirección IP y el puerto de tu servidor se mostrarán en el panel de ServerPrism en la pestaña Network. Para un acceso más fácil, puedes adjuntar un subdominio gratuito desde tu panel de cliente de ServerPrism.
  • URL de ejemplo: http://your_server_ip:port o http://your-subdomain.serverprism.me:port
• Code-Server: Asegúrate de anotar cualquier contraseña generada en la salida de la consola durante el primer arranque, ya que es necesaria para acceder a tu instancia de VS Code en el navegador.

Conceptos básicos de configuración

La mayoría de las configuraciones iniciales se pueden realizar a través de la interfaz web de la herramienta elegida una vez que esté en funcionamiento. Para configuraciones a nivel de servidor o variables de entorno, utiliza el panel de ServerPrism.

Pasos generales de configuración:

1. Accede a la interfaz web: Navega a la IP y el puerto de tu servidor en un navegador web.
2. Configuración inicial: Sigue las indicaciones en pantalla para la configuración por primera vez, como crear un usuario administrador, establecer un título de sitio o configurar el almacenamiento.

Notas de configuración de herramientas específicas:

• Code-Server: La contraseña inicial puede imprimirse en la consola en el primer arranque. A menudo puedes cambiarla o configurar la autenticación a través de variables de entorno en la pestaña Startup del panel de ServerPrism (por ejemplo, PASSWORD=yournewsecurepassword).
• Forgejo / Gitea: Durante la configuración web inicial, configurarás la base de datos, el usuario administrador y la ruta raíz del repositorio. Asegúrate de que la configuración de la base de datos coincida con la predeterminada (generalmente SQLite para simplificar, o externa si la configuras).
• Haste-Server: Los archivos de configuración suelen estar ubicados en el directorio del servidor (por ejemplo, config.js). Puedes editarlos usando el File Manager del panel de ServerPrism o a través de SFTP. Las configuraciones comunes incluyen el backend de almacenamiento (sistema de archivos o Redis) y el puerto.
• LanguageTool: La configuración a menudo se realiza a través de server.cfg o parámetros de inicio. Consulta la pestaña Startup en el panel de ServerPrism para ver las variables disponibles para personalizar la memoria, los modelos de lenguaje o el puerto.
• Reposilite: La configuración se gestiona principalmente mediante reposilite.yml en el directorio de trabajo del servidor. Utiliza el File Manager para configurar usuarios, repositorios y ajustes de seguridad.

Muchas herramientas te permiten ajustar la configuración a través de Startup Variables en el panel de ServerPrism. Consulta la pestaña Startup para ver las opciones disponibles específicas para el entorno de ejecución seleccionado.

Problemas comunes

• "No se puede acceder al sitio" o conexión rechazada:
  • Verifica el estado del servidor: Asegúrate de que tu servidor esté funcionando en el panel de ServerPrism.
  • Firewall: ServerPrism maneja automáticamente las reglas básicas del firewall para tu servicio. Si has modificado algo manualmente o estás utilizando un puerto no estándar, asegúrate de que esté abierto.
  • Desajuste de puertos: Verifica que estás utilizando el puerto correcto que aparece en la pestaña Network del panel de ServerPrism.
• Contraseña de Code-Server perdida: Si olvidas la contraseña de Code-Server, a menudo puedes restablecerla configurando una nueva variable de entorno PASSWORD en la pestaña Startup de tu panel de ServerPrism y reiniciando el servidor.
• Advertencias de espacio en disco (Forgejo/Gitea): Si alojas muchos repositorios, eventualmente podrías quedarte sin espacio en disco. Puedes actualizar tu plan de servidor desde tu panel de cliente de ServerPrism para obtener más almacenamiento.
• Rendimiento lento:
  • RAM: Si tu herramienta funciona lentamente, especialmente bajo carga, es posible que necesites más RAM. Puedes actualizar tu plan de servidor desde tu panel de cliente de ServerPrism.
  • Configuración: Revisa la documentación específica de tu herramienta para la optimización del rendimiento (por ejemplo, optimización de la base de datos para Forgejo/Gitea, configuración de JVM para LanguageTool/Reposilite).

Si encuentras problemas persistentes, recopila tu ID de servidor y los registros relevantes de la pestaña Console y abre un ticket de soporte en https://serverprism.com/tickets.

Próximos pasos

Una vez que tu herramienta de desarrollo esté funcionando, puedes explorar más personalizaciones:

• Integraciones: La mayoría de las herramientas ofrecen integraciones con otros servicios (por ejemplo, Git hooks para Forgejo/Gitea, extensiones para Code-Server).
• Cambio de entorno de ejecución: Si decides que una herramienta de desarrollo diferente se adapta mejor a tus necesidades, puedes cambiar los entornos de ejecución directamente desde la pestaña Startup en tu panel de ServerPrism. Esto te permite instalar una herramienta diferente sin volver a pedir tu servidor.
• Copia de seguridad: Realiza copias de seguridad regularmente de cualquier dato crítico, especialmente para soluciones de alojamiento de código como Forgejo y Gitea. Puedes descargar archivos a través de SFTP o el File Manager de ServerPrism.