Exploiter BYOS
Une fois votre serveur connecté, le travail quotidien ressemble en tout point à celui de l'hébergement géré. Cette page couvre les domaines dans lesquels l'exécution sur votre propre serveur se comporte différemment : domaines et SSL, Odoo Enterprise, sauvegardes et comportement de l'abonnement.
Domaines et SSL
Les déploiements sur votre propre serveur reçoivent une adresse skysize.io par défaut, mais les nouvelles adresses par défaut sont limitées par compte. La configuration recommandée consiste à rattacher votre propre domaine au projet une seule fois : un enregistrement DNS wildcard, puis chaque branche reçoit un nom d'hôte sous ce domaine avec des certificats émis sur votre serveur. Voir Votre domaine sur BYOS. La suite de cette section décrit l'ajout d'un domaine unique à une branche.
Ajouter votre domaine
- Ouvrez la section Domaines de la branche et ajoutez votre domaine (par exemple
erp.mycompany.com), en laissant SSL activé. - Chez votre fournisseur DNS, créez un enregistrement A pointant le domaine vers l'adresse IPv4 publique de votre serveur (indiquée sur la page de détail du serveur dans le tableau de bord).
- Attendez la propagation du DNS, puis ouvrez le domaine dans un navigateur.
Sur l'hébergement géré, vous faites pointer un CNAME vers votre nom d'hôte *.skysize.io. Sur BYOS, ce nom d'hôte n'existe pas : vous faites donc pointer un enregistrement A directement vers l'IP de votre serveur. Le reste du guide sur les domaines personnalisés s'applique sans changement.
Certificats SSL
Les certificats HTTPS des déploiements BYOS sont émis sur votre serveur via Let's Encrypt, et y sont renouvelés automatiquement. Les certificats de plateforme propres à Skysize ne sont jamais installés sur du matériel client.
Pour que l'émission aboutisse :
- Le DNS du domaine doit déjà résoudre vers votre serveur.
- Les ports 80 et 443 du serveur doivent être accessibles depuis internet, dans le pare-feu du serveur et dans le groupe de sécurité de votre fournisseur cloud (Let's Encrypt valide le domaine en HTTP).
Tant que le certificat n'est pas émis, le site peut n'être brièvement accessible qu'en HTTP.
Odoo Enterprise sur votre propre serveur
Les déploiements Enterprise sur votre serveur lisent le code source d'Odoo Enterprise avec vos propres accès, issus de votre propre abonnement Odoo Enterprise. Les identifiants enterprise de Skysize ne sont jamais utilisés sur du matériel client.
Configurez-le sur la page de détail de votre serveur, dans Source Odoo Enterprise. Deux options sont possibles.
Clé de déploiement (recommandé)
Conservez votre propre copie du code Enterprise dans un dépôt privé que vous contrôlez, chez n'importe quel hébergeur git : GitHub, GitLab, Bitbucket ou un serveur auto-hébergé. Il doit avoir une branche par version d'Odoo, nommée d'après la version (par exemple 19.0). Si Odoo vous a donné accès à odoo/enterprise, créez votre copie comme un miroir : un nouveau dépôt privé vide avec le même contenu, et non un fork GitHub. Un fork du dépôt privé d'Odoo reste rattaché au dépôt d'Odoo, et GitHub peut refuser que Skysize y installe automatiquement la clé de déploiement, même si vous en êtes administrateur. Sans accès à odoo/enterprise, poussez plutôt l'archive du code source téléchargée sur odoo.com.
git clone --bare git@github.com:odoo/enterprise.git
cd enterprise.git
git push --mirror git@github.com:votre-societe/enterprise.git
- Saisissez l'URL du dépôt (forme SSH ou HTTPS) et cliquez sur Générer la clé de déploiement.
- Skysize génère une clé en lecture seule pour ce seul dépôt. Lorsqu'un de vos comptes Git connectés est administrateur du dépôt, la clé y est installée automatiquement.
- Sinon, copiez la clé publique et ajoutez-la aux clés de déploiement du dépôt, en lecture seule. Installer automatiquement réessaie après que vous avez connecté le bon compte Git.
Une clé de déploiement ne donne jamais accès à autre chose que ce dépôt, et la supprimer sur le serveur la retire aussi du dépôt lorsque Skysize l'y avait installée. Tenez le dépôt à jour lorsqu'Odoo publie des correctifs ; un rafraîchissement mensuel est une bonne habitude. Pour un miroir, lancez git fetch origin '+refs/heads/*:refs/heads/*' --prune dans le clone bare, puis à nouveau git push --mirror.
Les clés de déploiement nécessitent l'agent 1.4.4 ou plus récent sur le serveur.
Image Docker avec Enterprise
Le serveur peut exécuter une image Docker qui contient déjà Enterprise ; rien n'est alors téléchargé.
Vous pouvez configurer l'une ou l'autre lors de la création d'un projet Enterprise : si le serveur cible n'a pas encore de source Enterprise, le tableau de bord vous en demande une, avec la clé de déploiement comme choix par défaut.
Pourquoi pas le dépôt officiel d'Odoo ?
Pointer votre serveur directement sur odoo/enterprise ferait récupérer à chaque déploiement ce qu'Odoo a publié le jour même. Une modification qui attend un code Community plus récent que celui de votre image peut casser l'instance, sans retour en arrière possible. Avec votre propre copie, vous décidez quand mettre à jour et vous pouvez annuler une mise à jour problématique. C'est pourquoi le tableau de bord propose des clés de déploiement sur votre propre dépôt, et non sur celui d'Odoo.
Sans clé de déploiement ni image Enterprise, les builds Enterprise sur ce serveur échouent car le code enterprise est introuvable. Les projets Community ne sont pas concernés.
Workers et mémoire
Votre serveur, votre dimensionnement : en BYOS, le nombre de workers du déploiement n'est pas fixé par le plan, c'est vous qui le choisissez. Ouvrez les Paramètres du projet et accédez à Workers et mémoire. Ces réglages dimensionnent uniquement le déploiement de production ; les déploiements de staging et de développement s'exécutent toujours en processus Odoo unique, sur des ressources fixes.
- Workers : le nombre de processus HTTP d'Odoo. Laissez 0 pour un processus unique qui sert à la fois le HTTP et les actions planifiées, ce qui convient à une petite instance ou à un serveur modeste. Indiquez 2 ou plus pour exécuter Odoo en mode multiprocessus, où chaque worker traite les requêtes en parallèle.
- Workers cron : le nombre de processus qui exécutent les actions planifiées. Utilisé uniquement en mode multiprocessus ; la valeur par défaut d'Odoo est 2.
- Mémoire par worker : le plafond mémoire de chaque processus Odoo, en Mo. Le minimum est de 512 Mo et la valeur par défaut de 1024 Mo. Un processus qui le dépasse est redémarré par Odoo : augmentez-le si votre charge de travail comporte de gros imports ou rapports.
Lorsque vous modifiez l'un de ces réglages, le tableau de bord affiche, avant application, la mémoire maximale que le déploiement peut utiliser : chaque processus à son plafond, plus 512 Mo de marge pour le conteneur. Vérifiez que votre serveur dispose de cette mémoire, en plus de Postgres et de tout ce qu'il exécute par ailleurs.
Appliquer et redémarrer enregistre le dimensionnement et redémarre le déploiement de production : prévoyez une courte interruption.
Les réglages Délai d'expiration des requêtes et Délai d'expiration des workers cron se trouvent dans la même section et fonctionnent exactement comme en hébergement infogéré. Voir Limites de temps.
Sauvegardes
L'ensemble du système de sauvegarde fonctionne sur BYOS : sauvegardes quotidiennes automatiques de la production, sauvegardes manuelles, restaurations, téléchargements et imports. Les tâches de sauvegarde s'exécutent sur votre serveur, puis l'archive est téléversée vers la cible de stockage configurée pour le projet.
Choisir l'emplacement de stockage des sauvegardes
Les projets BYOS sauvegardent vers votre propre stockage : le stockage de la plateforme Skysize n'est pas proposé comme cible, de sorte que les données actives (sur votre serveur) comme les sauvegardes restent sur une infrastructure que vous contrôlez. Tant qu'aucune cible n'est configurée, aucune sauvegarde n'est effectuée, et le projet affiche une bannière rouge qui le signale.
- Ouvrez les Paramètres du projet et accédez à Cible de sauvegarde.
- Sous Vos cibles de sauvegarde, cliquez sur Ajouter une cible et créez une cible (voir les champs de chaque type ci-dessous). Utilisez Tester pour vérifier la connexion : le test s'exécute sur le serveur de la branche de production, déployez donc d'abord cette branche.
- La première cible ajoutée est automatiquement sélectionnée comme Cible de stockage du projet. Si vous en ajoutez d'autres par la suite, choisissez celle à utiliser sous Cible de stockage et enregistrez.
Champs pour chaque type
Chaque cible a un Nom et un Type. Les autres champs dépendent du type. Les identifiants sont stockés chiffrés et ne sont plus affichés après l'enregistrement : laissez un secret vide lors d'une modification pour le conserver. Le Préfixe est toujours facultatif et place les archives dans un dossier, ce qui est utile lorsque plusieurs projets partagent un bucket.
AWS S3
| Champ | Valeur |
|---|---|
| Bucket | Le nom du bucket. Il doit déjà exister. |
| Région | La région du bucket. Par défaut us-east-1. |
| Authentification | Rôle IAM si votre serveur est une instance EC2 : aucun secret n'est stocké. Sinon Clés d'accès, avec l'ID de clé d'accès et la Clé d'accès secrète d'un utilisateur IAM. |
Le rôle ou l'utilisateur a besoin des autorisations listées dans le formulaire. Copier la stratégie JSON vous donne une stratégie prête à coller dans AWS.
Compatible S3 (Wasabi, R2, MinIO...)
Pour les autres fournisseurs dotés d'une API S3, comme Wasabi, Backblaze B2, Cloudflare R2, MinIO, OVH, Scaleway, Hetzner et DigitalOcean Spaces.
| Champ | Valeur |
|---|---|
| Bucket | Le nom du bucket. Il doit déjà exister. |
| Endpoint | L'URL S3 de votre fournisseur. |
| Région | La région de votre fournisseur, ou n'importe quelle valeur s'il n'en a pas. |
| ID de clé d'accès et Clé d'accès secrète | La clé fournie par votre fournisseur. |
| URL de type chemin | À activer uniquement si votre fournisseur l'exige. |
Google Cloud Storage
| Champ | Valeur |
|---|---|
| Bucket | Le nom du bucket. Il doit déjà exister. |
| Identifiants | Par défaut du serveur si votre serveur tourne sur Google Cloud avec un accès au bucket : aucune clé n'est stockée. Sinon Clé de compte de service : collez le contenu du fichier de clé. |
Le compte de service a besoin du rôle Storage Object Admin sur le bucket. Avec Par défaut du serveur, les liens de téléchargement sont signés par Google pour le compte du serveur : la VM a donc aussi besoin du niveau d'accès cloud-platform, et son compte de service du rôle Service Account Token Creator sur lui-même. Une clé de compte de service n'a besoin ni de l'un ni de l'autre.
Azure Blob Storage
| Champ | Valeur |
|---|---|
| Compte de stockage | Le nom du compte, pas son URL. |
| Conteneur | Le nom du conteneur. |
| Authentification | Identité managée si votre serveur tourne sur Azure : aucun secret n'est stocké. Sinon Clé d'accès : key1 ou key2 dans Access keys du compte de stockage. |
| Client ID de l'identité managée | Facultatif. Seulement si le serveur a plusieurs identités attribuées par l'utilisateur. |
Une identité managée a besoin des rôles Storage Blob Data Contributor et Storage Blob Delegator sur le compte.
Système de fichiers
Écrit les archives dans un Répertoire du serveur qui exécute le projet.
Les sauvegardes sur système de fichiers se trouvent sur la même machine que vos bases de données. Elles protègent contre les données erronées (suppressions accidentelles, mises à niveau ratées), mais pas contre la perte du serveur lui-même. Pour la reprise après sinistre, utilisez l'un des types de stockage ci-dessus, ou copiez vous-même le répertoire de sauvegarde hors du serveur.
Les sauvegardes sont créées sur le serveur avant leur téléversement : conservez donc suffisamment d'espace disque libre pour une copie compressée de votre plus grande base de données et de son filestore.
Stocker les fichiers une seule fois (déduplication)
La plupart des fichiers d'un filestore Odoo (pièces jointes, images, documents) ne changent pas d'une sauvegarde à l'autre, mais une sauvegarde classique les stocke tous à nouveau chaque jour. Activez Stocker une seule fois les fichiers partagés (déduplication) dans le formulaire de la cible pour stocker chaque fichier une seule fois par projet : chaque sauvegarde garde son dump complet de la base de données et pointe vers les fichiers dont elle a besoin. Sur un gros filestore, le stockage des sauvegardes devient bien plus petit, et le stockage de sauvegardes affiché pour le projet correspond à ce qui est réellement stocké.
- Cela s'applique aux nouvelles sauvegardes uniquement. Les sauvegardes prises avant restent telles quelles et continuent de fonctionner. Désactiver l'option ne s'applique aussi qu'aux nouvelles sauvegardes.
- Les restaurations, les copies hors site et les téléchargements fonctionnent comme d'habitude : Skysize reconstruit un
.zipOdoo standard avec le filestore. - Sur une cible de type bucket, le premier téléchargement d'une sauvegarde demande quelques minutes de préparation. Le bouton affiche Préparation… pour tous les membres du projet, et le téléchargement démarre tout seul si vous gardez la page ouverte. Une fois prête, la sauvegarde se télécharge en un clic pendant environ un jour, et le bouton affiche le temps restant. Si votre domaine pointe directement vers votre serveur, le téléchargement démarre tout de suite.
- Les archives de votre bucket ne sont plus des sauvegardes Odoo complètes à elles seules : elles n'ont pas de filestore, et les fichiers se trouvent dans un dossier
blobs/. Restaurez-les et téléchargez-les via Skysize, pas directement depuis le bucket. - Un nettoyage quotidien supprime les fichiers qu'aucune sauvegarde n'utilise plus. Les fichiers de moins d'un jour sont toujours conservés.
Cela nécessite l'agent Skysize 1.4.23 ou plus récent sur votre serveur (les agents se mettent à jour d'eux-mêmes).
Si votre abonnement expire
Si votre abonnement Bring Your Own Server expire ou est annulé, Skysize n'intervient jamais sur votre serveur pour arrêter quoi que ce soit :
- Les déploiements en cours continuent de fonctionner. Vos instances Odoo et leurs données restent actives sur votre matériel.
- Les nouvelles opérations sont bloquées. Les builds, les déploiements et les sauvegardes des projets BYOS sont refusés tant que l'abonnement n'est pas réactivé, et aucun nouveau serveur ni projet BYOS ne peut être ajouté. Les projets concernés affichent une bannière dans le tableau de bord.
- Le renouvellement rétablit tout. Renouvelez ou rachetez l'abonnement depuis la page Agents et les builds et sauvegardes reprennent ; aucune réinstallation n'est nécessaire.
Si le compte reste sans abonnement Bring Your Own Server actif pendant une période prolongée (environ 30 jours), les serveurs connectés qui n'hébergent pas de déploiements de projets actifs sont retirés du tableau de bord. Vous devriez alors les enregistrer et les enrôler à nouveau après avoir repris un abonnement. Les serveurs qui hébergent encore vos déploiements en cours d'exécution ne sont pas retirés.
Limites et différences par rapport à l'hébergement cloud
- Pas de domaines
*.skysize.io. Chaque déploiement que vous souhaitez rendre accessible sur le web nécessite votre propre domaine, avec un enregistrement A pointant vers votre serveur. - Pas de bouton de proxy Cloudflare. Le trafic va directement vers votre serveur. Si vous souhaitez placer un CDN ou une protection DDoS devant celui-ci, configurez-les chez votre propre fournisseur DNS ou proxy.
- Pas de choix de région. L'emplacement de votre serveur constitue la région. La latence et la résidence des données dépendent de l'endroit où vous l'hébergez.
- Pas de palier gratuit. Les projets BYOS nécessitent toujours un abonnement Bring Your Own Server actif, un par projet.
- La capacité est à votre charge. Le CPU, la RAM et le disque sont limités par votre matériel. Surveillez les métriques du serveur dans le tableau de bord et ajoutez des ressources, ou connectez des serveurs supplémentaires, avant qu'elles ne soient épuisées. Avec plusieurs serveurs, la production s'exécute sur le serveur que vous avez sélectionné et les autres branches se répartissent sur l'ensemble.
- La maintenance du serveur vous incombe. Les mises à jour du système d'exploitation, l'application des correctifs de sécurité et la configuration du pare-feu de la machine relèvent de votre responsabilité. Skysize maintient à jour l'agent et vos déploiements Odoo.
Tout le reste, y compris les flux de travail par branche, les journaux de build, la gestion des accès et les restaurations, se comporte exactement comme sur l'hébergement géré.