Git : mettre à jour votre site web à partir d'un dépôt

Travaillez-vous avec Git, par exemple avec GitHub ou GitLab ? Dans DirectAdmin, sous Git, vous pouvez créer un dépôt sur le serveur ou le relier à un dépôt externe. Vous mettez ainsi une nouvelle version de votre site web en ligne en un seul clic (ou automatiquement).

Créer un dépôt

1. Dans DirectAdmin, sous Fonctionnalités avancées, cliquez sur Git.
2. Cliquez sur CRÉER UN DÉPÔT.
3. À côté de Domaine figure le domaine auquel le dépôt est associé.
4. Dans Nom (1), indiquez un nom, par exemple website.
5. Souhaitez-vous importer un dépôt existant depuis GitHub, GitLab ou un autre service ? Indiquez alors l'adresse dans Distant (2).
6. Si ce dépôt est privé, indiquez dans Fichier de clé (3) la clé permettant au serveur de le lire (voir ci-dessous).
7. Cliquez sur CRÉER UN DÉPÔT.

Si vous laissez Distant vide, DirectAdmin crée un dépôt vide sur le serveur, vers lequel vous poussez (push) vous-même via SSH (voir Clés SSH et connexion via SSH).

Un dépôt privé : une clé de déploiement

Pour lire un dépôt privé, le serveur a besoin de sa propre clé. Créez de préférence une clé en lecture seule, comme deploy key sur GitHub ou GitLab. Placez la partie publique au niveau de votre dépôt (sur GitHub : Settings, Deploy keys) et indiquez à DirectAdmin le chemin vers la partie privée dans votre forfait. Utilisez alors la forme SSH pour l'adresse, par exemple git@github.com:votrenom/website.git.

Mettre à jour et déployer

Cliquez sur votre dépôt dans la liste. Vous y récupérez la dernière version depuis le dépôt externe et placez les fichiers dans un dossier de votre site web (déploiement). DirectAdmin y affiche également une adresse de webhook. Indiquez cette adresse au niveau de votre dépôt comme webhook (sur GitHub : Settings, Webhooks), le serveur déploiera alors automatiquement chaque push.

Attention : Gardez l'adresse du webhook secrète. Toute personne qui connaît cette adresse peut lancer un nouveau déploiement.

Bon à savoir

• Lors du déploiement, les fichiers portant le même nom sont écrasés, mais les fichiers que vous avez supprimés de votre dépôt restent présents sur le serveur. Pensez à les supprimer vous-même.
• Ne placez pas le dépôt lui-même dans public_html. Sinon, n'importe qui pourrait consulter le dossier .git contenant tout votre historique. Laissez DirectAdmin déployer les fichiers vers public_html.
• Ne placez pas de mots de passe ou de clés API dans votre dépôt. Conservez-les dans un fichier séparé qui n'est pas suivi par Git, comme .env.
• Pour exécuter Composer ou npm après un déploiement, utilisez le Terminal ou SSH (voir Terminal dans votre navigateur).