Démarrer avec les outils de développement

Ce guide vous aide à déployer et configurer un serveur d'outils de développement sur ServerPrism. Vous apprendrez à commander votre serveur, à comprendre le processus de premier démarrage et à commencer à configurer l'outil choisi.

Commander sur ServerPrism

1. Sélectionnez un plan : Choisissez un plan avec au moins 2 Go de RAM. Pour des projets plus importants ou plus d'utilisateurs, envisagez 4 Go ou plus, jusqu'à 16 Go. Vous pouvez mettre à niveau votre plan ultérieurement depuis votre tableau de bord client ServerPrism.
2. Choisissez une région : Sélectionnez l'emplacement du centre de données le plus proche de vous ou de vos utilisateurs principaux pour des performances optimales.
3. Choisissez votre runtime : Pendant le processus de commande, sélectionnez l'outil de développement spécifique que vous souhaitez installer (par exemple, Code-Server, Forgejo, Gitea). Il sera installé automatiquement.
4. Déployez : Finalisez votre commande, et votre serveur commencera à être provisionné.

Premier démarrage

Après le déploiement, votre serveur démarrera automatiquement. Le processus de démarrage initial installe tous les composants nécessaires pour l'outil de développement choisi. Vous pouvez suivre la progression dans l'onglet Console du panneau ServerPrism.

Votre serveur est prêt lorsque vous voyez une sortie indiquant que le service a démarré avec succès, affichant souvent un port d'écoute ou un message de succès spécifique à l'outil (par exemple, "Server started", "Listening on port XXXX").

Connexion / invitation de joueurs

Les méthodes de connexion varient en fonction de l'outil que vous avez choisi :

• Code-Server, Forgejo, Gitea, Haste-Server, LanguageTool, Reposilite : Ces outils sont généralement accessibles via un navigateur web. L'adresse IP et le port de votre serveur seront affichés dans le panneau ServerPrism sous l'onglet Network. Pour un accès plus facile, vous pouvez attacher un sous-domaine gratuit depuis votre tableau de bord client ServerPrism.
  • Exemple d'URL : http://your_server_ip:port ou http://your-subdomain.serverprism.me:port
• Code-Server : Assurez-vous de noter tout mot de passe généré à partir de la sortie de la console lors du premier démarrage, car il est requis pour accéder à votre instance VS Code dans le navigateur.

Bases de la configuration

La plupart des configurations initiales peuvent être effectuées via l'interface web de l'outil choisi une fois qu'il est en cours d'exécution. Pour les paramètres au niveau du serveur ou les variables d'environnement, utilisez le panneau ServerPrism.

Étapes de configuration générale :

1. Accéder à l'interface web : Naviguez vers l'IP et le port de votre serveur dans un navigateur web.
2. Configuration initiale : Suivez les invites à l'écran pour la première configuration, comme la création d'un utilisateur administrateur, la définition d'un titre de site ou la configuration du stockage.

Notes de configuration spécifiques aux outils :

• Code-Server : Le mot de passe initial peut être imprimé dans la console lors du premier démarrage. Vous pouvez souvent le modifier ou configurer l'authentification via des variables d'environnement dans l'onglet Startup du panneau ServerPrism (par exemple, PASSWORD=yournewsecurepassword).
• Forgejo / Gitea : Lors de la configuration web initiale, vous configurerez la base de données, l'utilisateur administrateur et le chemin racine du dépôt. Assurez-vous que les paramètres de la base de données correspondent aux valeurs par défaut (généralement SQLite pour la simplicité, ou externe si vous le configurez).
• Haste-Server : Les fichiers de configuration sont généralement situés dans le répertoire du serveur (par exemple, config.js). Vous pouvez les modifier à l'aide du File Manager du panneau ServerPrism ou via SFTP. Les paramètres courants incluent le backend de stockage (système de fichiers ou Redis) et le port.
• LanguageTool : La configuration se fait souvent via server.cfg ou des paramètres de démarrage. Vérifiez l'onglet Startup dans le panneau ServerPrism pour les variables disponibles afin de personnaliser la mémoire, les modèles linguistiques ou le port.
• Reposilite : La configuration est principalement gérée par reposilite.yml dans le répertoire de travail du serveur. Utilisez le File Manager pour configurer les utilisateurs, les dépôts et les paramètres de sécurité.

De nombreux outils vous permettent d'ajuster les paramètres via les Startup Variables dans le panneau ServerPrism. Vérifiez l'onglet Startup pour les options disponibles spécifiques à votre runtime sélectionné.

Problèmes courants

• "Site can't be reached" ou connexion refusée :
  • Vérifier l'état du serveur : Assurez-vous que votre serveur est en cours d'exécution dans le panneau ServerPrism.
  • Pare-feu : ServerPrism gère automatiquement les règles de pare-feu de base pour votre service. Si vous avez modifié quoi que ce soit manuellement ou utilisez un port non standard, assurez-vous qu'il est ouvert.
  • Incompatibilité de port : Vérifiez que vous utilisez le bon port indiqué dans l'onglet Network du panneau ServerPrism.
• Mot de passe Code-Server perdu : Si vous oubliez le mot de passe Code-Server, vous pouvez souvent le réinitialiser en définissant une nouvelle variable d'environnement PASSWORD dans l'onglet Startup de votre panneau ServerPrism et en redémarrant le serveur.
• Avertissements d'espace disque (Forgejo/Gitea) : Si vous hébergez de nombreux dépôts, vous risquez de manquer d'espace disque. Vous pouvez mettre à niveau votre plan de serveur depuis votre tableau de bord client ServerPrism pour obtenir plus de stockage.
• Performances lentes :
  • RAM : Si votre outil fonctionne lentement, surtout sous charge, vous pourriez avoir besoin de plus de RAM. Vous pouvez mettre à niveau votre plan de serveur depuis votre tableau de bord client ServerPrism.
  • Configuration : Consultez la documentation spécifique de votre outil pour l'optimisation des performances (par exemple, optimisation de la base de données pour Forgejo/Gitea, paramètres JVM pour LanguageTool/Reposilite).

Si vous rencontrez des problèmes persistants, rassemblez votre ID de serveur et les journaux pertinents de l'onglet Console et ouvrez un ticket de support sur https://serverprism.com/tickets.

Prochaines étapes

Une fois votre outil de développement en cours d'exécution, vous pouvez explorer d'autres personnalisations :

• Intégrations : La plupart des outils offrent des intégrations avec d'autres services (par exemple, les hooks Git pour Forgejo/Gitea, les extensions pour Code-Server).
• Changement de runtime : Si vous décidez qu'un autre outil de développement conviendrait mieux à vos besoins, vous pouvez changer de runtime directement depuis l'onglet Startup de votre panneau ServerPrism. Cela vous permet d'installer un outil différent sans avoir à commander un nouveau serveur.
• Sauvegarde : Sauvegardez régulièrement toutes les données critiques, en particulier pour les solutions d'hébergement de code comme Forgejo et Gitea. Vous pouvez télécharger des fichiers via SFTP ou le File Manager de ServerPrism.