LE GUIDE WORKSPACE
Chez vous,
étape par étape.
Todou Studio vous accompagne pour installer et maintenir votre Workspace. Ce guide est destiné à ses opérateurs et à l’administrateur du serveur.
01 / TÉLÉCHARGER
Votre accès Workspace.
Todou Studio réalise les installations. Les archives et images restent privées, réservées aux clients autorisés. Un jeton de déploiement par client permet de télécharger sans compte GitLab personnel, avec les droits read_registry et read_package_registry.
Les accès sont saisis par l’opérateur dans son terminal. Ce site ne demande et ne reçoit aucun jeton.
Informations de version non chargées. Activez JavaScript ou contactez Todou Studio.
Version choisie : · ·
Depuis le serveur Linux
Dans un terminal Bash, sous le compte todou préparé ci-dessous. Le téléchargement écrit l’archive et sa somme dans le dossier personnel de ce compte. Continuez uniquement si la vérification affiche OK.
SHA-256 attendu :
Taille : . L’empreinte vérifie l’intégrité ; ce n’est pas une signature cryptographique.
02 / INSTALLER
Bienvenue sur votre serveur.
Les commandes apparaissent lorsqu’une version est annoncée dans le canal choisi. Deux noms DNS sont nécessaires : Workspace et authentification.
1. Préparer le compte opérateur
Sur une nouvelle installation, l’administrateur crée le compte dédié et son dossier de données. Ne recréez pas un compte ou une instance existants.
# Administrateur système (root), Docker et Node.js déjà installés
useradd -m -G docker -s /bin/bash todou
install -d -o todou -g todou -m 0700 /var/lib/todou
su - todouSous todou, connectez Docker au registre avec le nom d’utilisateur fourni. Docker demandera le jeton. Téléchargez ensuite l’archive avec le bloc de l’étape 01.
docker login gitlab.todoustudio.cloud:5050 -u VOTRE_IDENTIFIANT_CLIENT2. Préparer la version
Après vérification de l’archive, l’administrateur la décompresse dans /opt :
3. Configurer et démarrer
Sous todou, remplacez les deux domaines d’exemple par les vôtres. Pour un serveur dédié avec les ports 80 et 443 disponibles, utilisez Caddy :
CTL=/opt/todou/infrastructure/deploy/todouctl.mjs
node "$CTL" verify-release
node "$CTL" init --edge caddy \
--public-host workspace.example.com \
--auth-host auth.workspace.example.com
node "$CTL" doctor
node "$CTL" up
node "$CTL" statusSi le proxy Traefik de Coolify occupe déjà les ports 80 et 443, utilisez --edge traefik à la place de --edge caddy. Ce mode suppose le réseau coolify et le résolveur letsencrypt ; faites vérifier leur présence par l’administrateur. Le proxy existant reste en place.
Arrêtez-vous si une commande échoue. Avant de continuer, doctor doit indiquer une configuration valide, les services doivent être sains et l’API prête.
4. Activer le gestionnaire d’applications
L’administrateur installe le service système :
# Administrateur système (root)
node /opt/todou/infrastructure/deploy/todouctl.mjs manager-unit --user todou \
> /etc/systemd/system/todou-app-manager.service
systemctl daemon-reload
systemctl enable --now todou-app-manager
systemctl is-active todou-app-manager5. Créer votre compte
Ouvrez immédiatement l’adresse HTTPS de Workspace et choisissez « Créer le compte administrateur ». Le premier inscrit devient administrateur et ferme l’inscription initiale. Ne laissez pas une instance publique en attente de ce premier compte.
Vérifiez la connexion, puis configurez les courriels d’invitation dans l’administration. Les applications du catalogue sont installées séparément, après acceptation de leurs permissions.
03 / METTRE À JOUR
Votre instance, à votre rythme.
Consultez les notes de version et qualifiez le passage sur une instance de test. Prévoyez une interruption et conservez une copie de sauvegarde hors du serveur. Le parcours actuel se fait depuis le terminal ; aucune mise à jour n’est déclenchée par cette page.
- Téléchargez et vérifiez la nouvelle archive comme à l’étape 01.
- Faites-la décompresser par l’administrateur dans
/opt, à côté de la version actuelle. Conservez l’ancien dossier et ne changez pas encore le lien/opt/todou. - Sous
todou, lancez les commandes suivantes avec le chemin réel de la nouvelle version.
update sauvegarde d’abord les données, applique les images et migrations de la nouvelle archive, puis redémarre les services. Notez le chemin de sauvegarde affiché.
Après réussite, l’administrateur bascule le lien et régénère le service :
Vérifiez enfin HTTPS, la connexion d’un compte et une opération dans une application. Les mises à jour d’applications se font séparément avec todouctl apps install ; acceptez uniquement les nouvelles permissions demandées.
En cas d’échec ou de retour arrière
Conservez les journaux et la sauvegarde. Ne basculez pas vers une version dont les vérifications échouent. Les migrations vont uniquement vers l’avant : le retour arrière restaure une sauvegarde et peut supprimer les écritures effectuées depuis sa création.
Faites valider cette perte potentielle de données avant une restauration. L’administrateur arrête le gestionnaire, l’opérateur utilise la procédure rollback --backup … --confirm-delete-data, puis l’administrateur remet le lien et le gestionnaire sur l’ancienne version. Faites-vous accompagner par votre interlocuteur Todou Studio pour cette opération.
04 / DÉVELOPPER
Un vrai Workspace sur votre poste.
Le catalogue déclare les compatibilités SDK pour chaque version du Core. Il ne fournit pas encore de fiche de téléchargement du SDK.
Depuis un projet d’application Todou créé avec le SDK, après installation de ses dépendances et connexion au registre avec docker login :
Le SDK demande votre accès aux paquets pour télécharger le Core. Il prépare le Workspace local, les comptes de test et votre application. L’adresse et les comptes sont affichés dans votre terminal.
# Après modification de votre application
npx todou-app workspace updateCe bac à sable est réservé au développement local. Pour une instance sur un serveur, suivez le parcours d’installation ci-dessus.