Administrateurs # Faites tourner votre propre serveur Welley Notre outil en ligne de commande installe tout ce dont Welley a besoin sur une seule machine Linux. Un serveur cloud convient, et votre propre matériel aussi. [Lire : Démarrage rapide : déploiement minimal de Welley](https://welley.com/fr/administrators/docs/quick-start/) [Lire : Welley CLI](https://welley.com/fr/administrators/docs/cli/) [Installer Docker Engine](https://docs.docker.com/engine/install/) Nous prévoyons de publier Welley en open source à l'avenir. Aucune date de sortie ni licence n'est encore annoncée. ## Préparez l'hôte, le DNS et l'e-mail Voici les exigences de départ du guide de démarrage rapide. La capacité dont vous avez besoin dépend de vos utilisateurs et de votre charge. ### Hôte Linux - Ubuntu 24.04 LTS, ou une distribution récente similaire. - Commencez avec 2 vCPU, 4 Go de RAM et 60 Go de disque. - Utilisez une adresse IPv4 publique fixe et un utilisateur non root avec sudo. ### Réseau - Autorisez le trafic TCP entrant sur les ports 80 et 443 depuis Internet. Autorisez le trafic TCP sur le port 22 depuis votre propre réseau. - Gardez le port 80 libre pour le défi du certificat et le renouvellement hebdomadaire du certificat. ### DNS du site - Faites pointer votre domaine et storage. vers l'adresse IP de l'hôte. - Créez les deux enregistrements avant l'installation. La CLI les vérifie et s'arrête s'ils ne pointent pas vers l'hôte. ### SMTP et e-mail de l'administrateur - Ayez sous la main votre hôte SMTP, l'utilisateur, le mot de passe et l'adresse d'expédition. Par défaut, c'est STARTTLS sur le port 587. - Il vous faudra aussi un e-mail d'administrateur pour la première connexion et pour la récupération du mot de passe. ### DNS de l'e-mail - Configurez SPF, DMARC et le DKIM généré par votre fournisseur, pour le domaine de l'adresse d'expédition. - Utilisez la valeur SPF exacte de votre fournisseur. Fusionnez-la dans votre enregistrement SPF existant au lieu d'en ajouter un second. - La CLI vous avertit s'il manque SPF ou DMARC. Elle ne peut pas vérifier le sélecteur DKIM de votre fournisseur. ## Installez Docker Engine et Compose Suivez les instructions officielles de Docker pour votre distribution Linux. Donnez ensuite à l'utilisateur de déploiement l'accès à Docker. [Installation de Docker Engine](https://docs.docker.com/engine/install/) ### Ajouter l'utilisateur au groupe Docker Remplacez par votre utilisateur de déploiement non root. Après avoir lancé cette commande, déconnectez-vous puis reconnectez-vous. ``` sudo usermod -aG docker ``` ### Vérifier Docker et Compose Les deux commandes doivent fonctionner pour cet utilisateur. ``` docker ps docker compose version ``` ## Télécharger la CLI Choisissez le binaire correspondant à la machine sur laquelle vous lancerez la CLI. L'hôte de déploiement lui-même doit tourner sous 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 ``` - Ces commandes téléchargent depuis le canal stable et affichent la version de la CLI. - Le numéro de version change à chaque nouvelle sortie. Utilisez la dernière documentation de la CLI lors de l'installation. ## Créer le déploiement Lancez cette commande sur l'hôte Linux que vous avez préparé. Remplacez le domaine, l'e-mail et les valeurs SMTP d'exemple par les vôtres. ``` ./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 ``` | Paramètre | Par défaut | | --- | --- | | Répertoire d'installation | ~/.welley/. Le domaine d'exemple produit le nom de projet example\_com. | | Base de données | PostgreSQL intégré, avec les données dans le répertoire d'installation. | | Pile logicielle | Plateforme Welley, pipeline RAG, Nginx, Redis et PostgreSQL, avec des conteneurs de maintenance. | | Certificats | Let’s Encrypt via Certbot, avec renouvellement hebdomadaire. | | Médias | Fichiers téléversés et fichiers statiques sur https://storage.. | | Mises à jour | Canal stable, vérifié chaque jour. Le processus de mise à jour évite si possible toute interruption. | | Services optionnels | L'installation minimale n'ajoute ni base de données gérée, ni CDN, ni télémétrie, ni intégration Slack. | - Avant de la lancer, définissez MAIL\_USER et MAIL\_PASSWORD avec vos identifiants SMTP. - Le guide de démarrage rapide exige ces six options. - La commande vérifie le DNS, écrit les fichiers de déploiement, obtient un certificat avec Certbot et démarre les conteneurs. - La commande deploy est un alias de deployment. ## Connectez-vous et vérifiez le résultat Le mot de passe administrateur généré se trouve dans le journal de la plateforme. Gardez cette sortie privée. ### Trouver le mot de passe initial Ce nom de conteneur correspond à example.com. Pour votre propre domaine, changez le nom du projet. ``` docker logs example_com-platform-blue-1 | grep "Auto-init complete" ``` ### Se connecter Ouvrez votre domaine et connectez-vous avec l'e-mail d'administrateur indiqué avec -e. Changez tout de suite le mot de passe généré. ### Vérifier les conteneurs Le guide de démarrage rapide s'attend à voir nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal et snoopy. ``` docker ps ``` ## Utilisez la CLI pour l'administration La CLI propose aussi des commandes pour l'API de la plateforme. Votre compte doit toujours avoir les autorisations pour chaque opération. - Avant de lancer une opération, vérifiez ses options actuelles dans l'aide de la commande. - La commande login prend l'URL de base de l'API, l'e-mail et le mot de passe. Elle enregistre le jeton de session qu'elle reçoit en retour. - Pour l'instant, la commande login affiche son jeton de session dans le journal de réussite. Gardez cette sortie privée. Groupes de commandes : `accounts`, `posts`, `apps`, `emojis`, `feeds`, `reports`, `rules`, `settings`. ### Afficher les commandes disponibles ``` ./wlycli --help ``` ### Afficher les commandes de déploiement ``` ./wlycli deployment --help ``` ### Afficher les options de connexion ``` ./wlycli login --help ``` ### Afficher les options de paramètres ``` ./wlycli settings --help ``` ## Mises à jour et récupération Par défaut, un déploiement vérifie chaque jour les mises à jour stables. L'administrateur du serveur peut gérer les versions dans l'interface d'administration. - Si vos fichiers de déploiement sont toujours valides mais que certains conteneurs échouent, le démarrage rapide indique d'exécuter restart, qui recrée les conteneurs. - Create ne se relancera pas tant que le répertoire du projet ou ses conteneurs existent encore. - L'option force-delete supprime les fichiers de déploiement et la base de données incluse. Ce n'est pas une étape de récupération, et elle ne conserve pas vos données. - La skill deploy-server utilise encore le nom deployment update. La CLI actuelle propose à la place deployment auto-update. Consultez l'aide de la CLI actuelle avant de faire la maintenance à la main. ### Recréer les conteneurs à partir du déploiement existant ``` ./wlycli deploy restart -d example.com ``` Recrée les conteneurs à partir de votre configuration enregistrée. Cela ne supprime pas les données du déploiement. ## Déployer avec un assistant IA Si votre assistant IA prend en charge les paquets SKILL.md, téléchargez notre skill officielle deploy-server. Elle vous guide dans un déploiement sur DigitalOcean. Pour l'instant, la skill ne couvre que DigitalOcean. Le démarrage rapide de la CLI fonctionne aussi avec d'autres clouds et avec votre propre hôte Linux. ### Comment l'utiliser - Extrayez le paquet et chargez le répertoire deploy-server de la façon dont votre assistant installe les skills. - Demandez à l'assistant d'utiliser $deploy-server. - La skill vous demande le domaine, l'accès DNS, la configuration SSH, les détails SMTP et l'e-mail de l'administrateur. - Elle peut configurer une VM DigitalOcean et, si vous le souhaitez, une base de données PostgreSQL gérée. Elle confirme avec vous les paramètres du déploiement et le prix de la base de données gérée. ### Avant de télécharger - Le paquet est une copie inchangée de la skill d'origine. - Ses exemples de téléchargement et de mise à jour sont obsolètes. Récupérez l'URL de téléchargement stable actuelle dans le démarrage rapide de ce site. Consultez l'aide de la CLI avant la maintenance. - La skill n'est pas fournie avec des identifiants cloud ni un serveur en marche, et nous ne pouvons pas garantir qu'elle fonctionne avec tous les assistants. Le paquet contient `SKILL.md`, `agents/openai.yaml` et `references/digitalocean.md`. Les deux téléchargements contiennent les mêmes fichiers. [Télécharger deploy-server.zip (10,7 KB)](https://welley.com/downloads/deploy-server.zip) [Télécharger deploy-server.skill (10,7 KB)](https://welley.com/downloads/deploy-server.skill) ## Documentation de référence La documentation complète de la CLI et les fichiers de la skill de déploiement. Vous pouvez les lire ici sans compte. - [**Welley CLI** docs/index.md](https://welley.com/fr/administrators/docs/cli/) - [**Démarrage rapide : déploiement minimal de Welley** docs/quick-start.md](https://welley.com/fr/administrators/docs/quick-start/) - [**Déployer un serveur** skills/deploy-server/SKILL.md](https://welley.com/fr/administrators/docs/deploy-server-skill/) - [**openai.yaml** skills/deploy-server/agents/openai.yaml](https://welley.com/fr/administrators/docs/deploy-server-openai-yaml/) - [**Référence DigitalOcean** skills/deploy-server/references/digitalocean.md](https://welley.com/fr/administrators/docs/deploy-server-digitalocean/)