Documentation

Tout ce qu'il faut savoir pour démarrer avec Sovrack.

Prérequis recommandés

Un VPS Ubuntu à jour, accessible en SSH, avec une IPv4 publique, des ports 80/443 ouverts, un domaine sous votre contrôle et un dépôt Git ou une image Docker. Conservez toujours un accès direct au fournisseur VPS en cas d’erreur réseau.

1. Créer votre compte

  1. 1Créez un compte avec votre nom, votre adresse email et un mot de passe robuste.
  2. 2Votre espace personnel est prêt immédiatement. Vous pouvez créer ou rejoindre une organisation à tout moment depuis le tableau de bord.
  3. 3Saisissez le code reçu par email afin d'activer votre identité.
  4. 4La connexion s'effectue ensuite avec votre email et votre mot de passe.
  5. 5Vous pouvez activer volontairement une application TOTP dans Mon compte ; cette protection reste facultative.

2. Comprendre les espaces de travail

  1. 1Un espace personnel appartient à une seule personne et ne permet pas d'inviter des membres.
  2. 2Une organisation permet d'inviter des membres et de leur attribuer des rôles.
  3. 3Vous pouvez appartenir à plusieurs organisations tout en conservant votre espace personnel.
  4. 4La conversion d'un espace personnel en organisation est explicite et irréversible.

3. Connecter un serveur VPS

  1. 1Compatible avec tout serveur ou VPS Ubuntu standard (machines virtuelles privées, serveurs cloud ou serveurs bare-metal dédiés).
  2. 2Ouvrez Serveurs, puis indiquez le nom, l'adresse IP, le port SSH et l'utilisateur disposant des droits sudo.
  3. 3Installez la clé publique indiquée par Sovrack dans ~/.ssh/authorized_keys sur le serveur cible.
  4. 4Lancez la validation SSH, la détection des capacités et la préparation guidée en 1 clic.

4. Connecter GitHub ou GitLab

  1. 1Connectez votre compte GitHub ou GitLab en 1 clic pour lister et importer vos dépôts directement.
  2. 2Vous pouvez également utiliser un Personal Access Token (PAT) ou un Deploy Token pour vos dépôts privés d'entreprise.
  3. 3Ajoutez le fournisseur depuis Fournisseurs Git et vérifiez la connexion instantanément.
  4. 4Les jetons sont chiffrés avec AES-256-GCM ; révoquez-les directement chez le fournisseur lorsqu'ils ne sont plus utilisés.

5. Créer et déployer un service

  1. 1Créez un projet et au moins un environnement persistant.
  2. 2Ajoutez une application construite depuis un Dockerfile ou une image Docker.
  3. 3Vous pouvez aussi ajouter PostgreSQL, Redis, MySQL, MongoDB ou RabbitMQ ; Sovrack génère et chiffre leurs identifiants.
  4. 4Ces bases sont des conteneurs exécutés sur votre propre serveur : vous restez responsable des sauvegardes, des restaurations, de la capacité disque et de la haute disponibilité.
  5. 5Configurez la branche, le port, les variables et les secrets nécessaires.
  6. 6Sélectionnez un serveur préparé, contrôlez le résumé puis lancez le déploiement.

6. Utiliser un registre privé

  1. 1Ouvrez Registre depuis les intégrations de votre espace.
  2. 2Ajoutez l'adresse du registre et des identifiants limités à la lecture lorsque cela suffit.
  3. 3Référencez ensuite l'image complète dans la configuration du service.
  4. 4Après rotation d'un secret côté fournisseur, mettez également à jour la connexion dans Sovrack.

7. Variables et secrets

  1. 1Ajoutez les valeurs propres à chaque environnement dans l'onglet Variables.
  2. 2Utilisez les champs secrets pour les mots de passe, clés et jetons.
  3. 3Ne placez jamais un secret directement dans le dépôt Git ou dans le nom d'une variable.
  4. 4Contrôlez l'aperçu avant chaque déploiement sans exposer la valeur des secrets.

8. Domaine et HTTPS

  1. 1Ajoutez le nom de domaine dans la configuration du service.
  2. 2Créez un enregistrement A vers l’IPv4 du serveur. Pour app.sovrack.com, le champ sous-domaine est app ; pour staff.sovrack.com, il est staff.
  3. 3N’ajoutez un enregistrement AAAA que si ce même serveur possède une IPv6 publique fonctionnelle et que le proxy écoute réellement en IPv6. Une mauvaise valeur AAAA provoque des pannes intermittentes chez les visiteurs utilisant IPv6.
  4. 4Attendez la propagation DNS puis relancez la vérification dans Sovrack.
  5. 5L'émission HTTPS ne peut réussir que lorsque le domaine pointe vers le bon serveur et que les ports web sont accessibles.

9. Suivre un déploiement

  1. 1La page Déploiements présente l'état, le déclencheur, le projet et l'environnement.
  2. 2Ouvrez un déploiement pour consulter ses étapes et ses journaux.
  3. 3Les métriques disponibles dépendent de la configuration du serveur cible.
  4. 4En cas d'échec, corrigez la configuration puis lancez un nouveau déploiement traçable.

10. Sécurité et assistance

  1. 1Utilisez un mot de passe unique et protégez l'accès à votre messagerie.
  2. 2Révoquez immédiatement une clé SSH ou un jeton Git que vous pensez compromis.
  3. 3Les rôles limitent les actions au niveau de l'espace de travail et du projet.
  4. 4Pour toute question, contactez contact@sovrack.com sans transmettre de mot de passe ni de secret.

11. Rôles d’une organisation

  1. 1Le propriétaire contrôle l’organisation, les membres, les rôles et la facturation. Il doit toujours rester au moins un propriétaire actif.
  2. 2L’administrateur gère les membres et les ressources, sans pouvoir retirer les protections réservées au propriétaire.
  3. 3Le membre utilise les projets et ressources auxquels son rôle lui donne accès ; il ne peut pas inviter d’autres personnes.
  4. 4Un membre peut quitter une organisation. Quitter retire immédiatement ses droits sans supprimer les ressources de l’organisation.

12. Responsabilités d’exploitation

  1. 1Sovrack orchestre les déploiements ; le propriétaire du serveur reste responsable du fournisseur VPS, du système, du réseau et de la capacité disque.
  2. 2Sauvegardez les volumes et bases de données selon vos objectifs de reprise, puis testez régulièrement une restauration.
  3. 3Surveillez l’expiration du domaine, les quotas du fournisseur, les journaux, les erreurs et l’espace disque.
  4. 4Avant une modification risquée, disposez d’une sauvegarde vérifiée et d’un chemin de retour documenté.

13. Diagnostic rapide

  1. 1Échec SSH : vérifiez l’adresse, le port, l’utilisateur, la clé autorisée et les règles du pare-feu.
  2. 2Domaine inaccessible : vérifiez A et AAAA séparément, la propagation DNS, les ports 80/443 et l’état du proxy.
  3. 3Build en échec : ouvrez le déploiement, lisez les premières erreurs du journal et contrôlez le Dockerfile, la branche et les variables.
  4. 4Image privée refusée : testez les identifiants du registre et vérifiez qu’ils autorisent la lecture du dépôt concerné.
  5. 5Ne transmettez jamais de clé SSH, jeton Git, mot de passe ou secret dans une demande d’assistance.

Une question ?

Notre équipe vous répond par email.

Contacter le support