Mettre en ligne un projet GitHub sur votre hébergement (déploiement automatique) Imprimer

Service concerné par cette fiche : hébergement web au Cameroun.

En bref : le service Mise en ligne GitHub publie votre dépôt GitHub, public ou privé, sur votre hébergement CCN Technologies, sans FTP ni ligne de commande. Vous collez l'adresse du dépôt, nous analysons, puis nous déployons : base de données, certificat SSL et suivi d'avancement compris.

1. Ce qu'il vous faut

• Un hébergement web CCN Technologies actif (offre cPanel).
• Un dépôt GitHub public, ou privé avec un jeton GitHub en lecture seule (voir la section « Dépôt privé » ci-dessous).
• Soit une formule Hébergement Développeur (Dev Starter, Pro, Business ou Agence) : de 3 à 30 projets GitHub inclus, rien d'autre à acheter ; soit, sur un hébergement classique, un emplacement de projet « Mise en ligne GitHub » adapté à votre technologie (voir la section 2).
• Si votre projet utilise MySQL : votre export .sql (facultatif, s'il n'est pas déjà dans le dépôt).

2. Choisir le bon niveau

Un emplacement d'un niveau supérieur accepte aussi les projets des niveaux inférieurs. L'analyse (étape 4) vous indique le niveau exact dont votre dépôt a besoin. Tarifs à jour : page Déploiement GitHub.

3. Commander et payer l'emplacement

1. Connectez-vous à votre espace client.
2. Ouvrez Commander > Produits complémentaires, choisissez le niveau « Mise en ligne GitHub » et rattachez-le à votre hébergement.
3. Réglez la facture :
   • Orange Money ou MTN Mobile Money : suivez les instructions affichées sur la facture, puis envoyez la référence de la transaction (réponse à la facture, ticket ou WhatsApp). L'emplacement s'ouvre dès que notre équipe confirme la réception.
   • PayPal : l'emplacement s'ouvre automatiquement après le paiement.

Dès l'ouverture, vous recevez l'e-mail « Votre emplacement Mise en ligne GitHub est ouvert » avec le lien direct vers l'assistant.

4. Analyser votre dépôt (gratuit)

1. Dans l'espace client, ouvrez Services > Mes services, puis votre hébergement.
2. Cliquez sur Déployer depuis GitHub.
3. Collez l'adresse du dépôt (ex. https://github.com/votre-compte/votre-projet) et cliquez sur Analyser mon dépôt.

L'analyse ne modifie rien. Elle détecte la technologie, le niveau d'emplacement nécessaire, la présence d'une base de données, et signale les fichiers sensibles (.env, clés, sauvegardes) qui ne seront jamais publiés.

5. Configurer et déployer

1. Choisissez le domaine ou sous-domaine de destination.
2. Si le projet utilise MySQL, cochez Créer une base de données et joignez votre fichier .sql si nécessaire. La base, l'utilisateur et le mot de passe sont créés pour vous et inscrits dans le fichier de configuration détecté.
3. Cliquez sur Déployer maintenant.

6. Suivre l'avancement

Chaque déploiement crée un projet dans votre espace client (menu Projets) : récupération du code, base de données, publication, certificat SSL et vérification finale. Vous recevez un e-mail à chaque étape importante.

Les statuts possibles

• En ligne : votre site répond correctement.
• Action requise : une information manque (par exemple le fichier .sql). Corrigez, puis cliquez sur Reprendre.
• À vérifier : le site est publié mais renvoie une erreur (souvent un bug ou un réglage dans le code du dépôt). Corrigez dans GitHub, puis cliquez sur Mettre à jour. Le SSL peut aussi demander quelques minutes après la création d'un sous-domaine.

Dépôt privé : créer un jeton en lecture seule

Pour un dépôt privé, le formulaire « Nouveau projet » demande un jeton GitHub en plus de l'adresse du dépôt. Pour le créer :

1. Sur GitHub : Settings > Developer settings > Personal access tokens > Fine-grained tokens > Generate new token.
2. Donnez-lui un nom et une date d'expiration.
3. Repository access : Only select repositories, puis choisissez uniquement le dépôt à mettre en ligne.
4. Permissions : Contents : Read-only (Metadata : Read-only est ajouté automatiquement). N'ajoutez aucune autre permission.
5. Cliquez sur Generate token, copiez le jeton (il commence par github_pat_) et collez-le dans le champ Jeton GitHub.

Le jeton est chiffré, sert uniquement à lire votre code et n'est jamais réaffiché. Quand il expire, collez-en un nouveau avec « Remplacer le jeton GitHub » sous votre projet. Ne communiquez jamais votre jeton par e-mail, ticket ou WhatsApp.

7. Mettre à jour votre site (automatiquement ou en un clic)

Mise à jour automatique (conseillé) : sous votre projet, ouvrez « Mise à jour automatique », cliquez sur « Activer la mise à jour automatique ». Trois informations s'affichent : Payload URL, Content type (application/json) et Secret.

1. Sur GitHub, ouvrez votre dépôt, puis Settings > Webhooks > Add webhook.
2. Copiez la Payload URL et le Secret affichés dans votre espace client dans les champs du même nom ; choisissez Content type : application/json.
3. Laissez « Just the push event » et « Active » cochés, puis cliquez sur Add webhook.

Désormais, chaque push sur votre branche republie le site tout seul : seul le nouveau code est publié, votre configuration est réappliquée et votre base est conservée. Les notifications qui ne viennent pas de votre dépôt et de votre branche sont refusées. Vous pouvez aussi cliquer à tout moment sur Mettre à jour depuis GitHub à côté du projet.

Revenir à une version précédente (retour en un clic)

Une mise à jour pose problème ? Sous votre projet, ouvrez « Revenir à une version précédente ». La liste propose vos 5 dernières versions publiées, avec leur date. Choisissez la version, cliquez sur « Remettre cette version en ligne » et confirmez.

• Les fichiers de cette version sont republiés et votre configuration (accès à la base) est réappliquée.
• La base de données n'est pas modifiée : si votre mise à jour a changé la structure de la base, contactez-nous.
• Un retour compte comme une mise à jour (30 par mois et par projet).
• Si la mise à jour automatique est activée, votre prochain push remet la dernière version en ligne.

8. Limites et sécurité

• Dépôts publics, ou privés avec un jeton GitHub en lecture seule, chiffré et jamais affiché.
• Jusqu'à 30 mises à jour par mois et par projet, et 5 publications par heure et par hébergement.
• Un emplacement = un projet en ligne. Pour un second projet, commandez un emplacement supplémentaire.
• Les fichiers .env, sauvegardes .sql, dossiers .git, .vscode, .idea et clés ne sont jamais rendus publics.

9. Questions fréquentes

L'analyse est-elle payante ?
Non, elle est gratuite et illimitée. Seule la mise en ligne nécessite un emplacement.

Mon site affiche une erreur 500 après le déploiement.
Le statut passe en « À vérifier ». Cela vient le plus souvent du code (table manquante, chemin incorrect). Ouvrez un ticket avec l'adresse du dépôt : nous vous aidons à identifier la cause.

Puis-je utiliser mon propre nom de domaine ?
Oui, s'il est rattaché à votre hébergement (domaine principal, domaine supplémentaire ou sous-domaine).

Combien de temps prend l'ouverture après un paiement Mobile Money ?
Dès que notre équipe confirme la transaction, généralement dans la journée ouvrée.

Besoin d'aide ?

Ouvrez un ticket ou écrivez-nous sur WhatsApp au +237 690 08 78 79. Pour aller plus loin : notre article complet sur le déploiement GitHub automatique.