Déployer automatiquement l'IPBX 3CX sur l'offre Public Cloud OVHcloud
Objectif
Ce guide vous détaille comment déployer automatiquement votre instance 3CX sur une instance Public Cloud.
A la fin de ce guide, vous aurez les bases pour gérer le déploiement de votre instance et sa configuration automatiquement.
Prérequis
- Un projet Public Cloud dans votre compte OVHcloud. Retrouvez plus d'informations dans notre guide « Créer votre premier projet Public Cloud ».
- L'IPBX 3CX requiert une license valide pour être utilisé. Assurez-vous d'avoir une license valide lors du déploiement. Retrouvez toutes les informations sur https://www.3cx.fr.
En pratique
OVHcloud met à votre disposition des services dont la configuration, la gestion et la responsabilité vous incombent. Il vous revient de ce fait d'en assurer le bon fonctionnement.
Nous mettons à votre disposition ce guide afin de vous accompagner au mieux sur des tâches courantes. Néanmoins, nous vous recommandons de faire appel à un prestataire spécialisé et/ou de contacter l'éditeur du service si vous éprouvez des difficultés. En effet, nous ne serons pas en mesure de vous fournir une assistance. Plus d'informations dans la section « Aller plus loin » de ce guide.
Nous allons utiliser un template au format XML afin de pouvoir configurer automatiquement l'instance 3CX.
Ce fichier XML peut être très simple, pour simplement installer 3CX et votre license.
Il peut aussi être très complet pour vous permettre non seulement d'installer la license mais aussi de créer vos utilisateurs, vos trunks et les autres fonctions de 3CX.
Dans ce guide, nous allons utiliser un template XML très simple. Pour un template plus complet, nous vous invitons à consulter la documentation de 3CX.
Etape 1 : compléter le template
Nous allons joindre à l'instance un user-data. Lors du démarrage de l'instance, ce fichier permettra à l'outil cloud-init de :
- créer le fichier XML de configuration de 3CX ;
- lancer l'installation des packages de 3CX.
Le fichier XML est inclus dans le template que nous allons joindre à l'instance lors de sa création.
Voici le fichier à utiliser pour suivre ce guide :
Dans ce template, il y a deux éléments à modifier pour un premier test de déploiement :
- Remplacez
YourLicenseKeypar votre clé de license 3CX.
- Remplacez
YourStrongAdminPasswordpar votre mot de passe pour le compte admin. Ce mot de passe doit faire 10 caractères minimum, contenir des chiffres, des lettres en minuscules et majuscules :
Une fois votre template terminé, vous pouvez le déployer grâce aux instructions de l'étape 2.
Etape 2 : déployer l'instance avec le template
Selon la version et le dimensionnement de votre instance 3CX, le modèle d'instance (flavor) à utiliser sera différent. Référez vous au lien suivant pour choisir la bonne instance : https://www.3cx.com/docs/recommended-hardware-specifications-for-3cx/
Pour notre guide, nous allons utiliser une instance Discovery D2-4.
Déploiement via l'espace client OVHcloud
Connectez-vous à votre espace client OVHcloud et cliquez sur le menu Public Cloud.
Sélectionnez votre projet Public Cloud.
Sur la page d'accueil, cliquez sur Créer une instance. Sélectionnez votre modèle d'instance et la région désirée.

Sélectionnez ensuite le système d'exploitation. A ce jour, 3CX utilise Debian 10.

C'est à l'étape suivante, appelée « Configurez votre instance » que vous allez pouvoir joindre votre template.
Nommez votre instance, puis cliquez sur Ajouter dans l'encadré Script de post-installation.
Dans la boite de texte qui s'affiche, collez le script d'installation généré précédemment.

Cliquez sur Suivant pour valider cette étape. Terminez par le choix de votre configuration réseau et du mode de facturation.
Une fois l'instance démarrée, l'installation sera lancée directement et prendra quelques minutes.
Vous pouvez vous connecter à la machine pour vérifier le bon déroulement avec les logs :
Une fois le déploiement terminé, l'interface d'administration sera accessible via le FQDN donné lors de la souscription à votre license 3CX ou via l'adresse IP de votre instance : https://ip_publique_instance:5001/
Déploiement via API
Il est également possible de déployer votre instance via API, en utilisant l'appel suivant :
- Exemple avec une flavor D2-4, Debian 10 et la facturation à l'heure :
Dans ce JSON, insérez le template dans userData. Attention, les sauts de lignes doivent êtres échappés par \n.
Aller plus loin
L'essentiel pour commencer avec Public Cloud
Se familiariser avec l'interface Public Cloud
Créer votre premier projet Public Cloud
Créer une première instance Public Cloud et s'y connecter
Pour des prestations spécialisées (référencement, développement, etc), contactez les partenaires OVHcloud.
Si vous souhaitez bénéficier d'une assistance à l'usage et à la configuration de vos solutions OVHcloud, nous vous proposons de consulter nos différentes offres de support.
Échangez avec notre communauté d'utilisateurs.