Configurer l'intégration continue avec un référentiel GitHub à l'aide des actions GitHub

Dans le cadre de votre workflow de développement, vous préférerez peut-être conserver la source de données de votre base de code de production dans le contrôle des versions. Cela serait particulièrement utile si vous travaillez au sein d'une équipe de développement afin de pouvoir suivre les changements et les annuler rapidement si nécessaire.

À l'aide des actions GitHub, vous pouvez configurer une intégration continue avec un référentiel GitHub. Ce guide parcourt le processus d'intégration et suppose que vous connaissez :

• l'utilisation de Git et GitHub ;
• la création de sites web à l'aide de l'interface de ligne de commande HubSpot.

Découvrez ci-dessous comment configurer l'intégration à l'aide de l'action GitHub de déploiement de CMS Hub (recommandée) ou manuellement.

Avant de pouvoir intégrer GitHub, vous devez d'abord rassembler vos fichiers localement.

• Si vous disposez d'un actif CMS existant qui réside dans HubSpot, tel qu'un thème ou un ensemble de modèles, vous pouvez le récupérer en exécutant la commande fetch comme suit : hs fetch <HubSpot_src> <local_dest>. Vous pouvez également télécharger tous les fichiers du système de fichiers développeur du compte en exécutant hs fetch /.
• Pour créer un nouveau projet local, il est recommandé de commencer par le boilerplate de thème CMS. Si vous n'avez jamais travaillé avec le boilerplate de thème CMS, consultez le guide de démarrage rapide. Si vous avez déjà installé l'interface de ligne de commande HubSpot et configuré votre environnement local, vous pouvez créer un nouveau thème local à partir du boilerplate en exécutant hs create website-theme<new-theme-name>. Vous devrez ensuite télécharger vos fichiers sur HubSpot à l'aide de la commande hs upload.

Une fois votre code disponible localement, vous l'ajouterez à un référentiel GitHub. Après avoir ajouté vos fichiers à GitHub, passez à l'étape suivante pour installer l'action GitHub prédéfinie de HubSpot (recommandée) ou configurer l'action manuellement.

Pour simplifier le processus, HubSpot a créé une action GitHub que vous pouvez installer sur votre projet GitHub pour gérer automatiquement le déploiement des modifications d'une branche vers votre compte de production HubSpot.

• Avec vos secrets, vos workflows et vos scripts dans votre référentiel GitHub, créez une demande d'extraction et fusionnez-la dans la branche principale. 
• Après avoir fusionné la demande d'extraction, accédez à Actions. Vous devriez voir votre action de déploiement s'exécuter, ce qui déploiera ensuite votre code sur votre compte HubSpot.

Maintenant que votre source de données réside dans GitHub, vous devez verrouiller votre ressource dans HubSpot pour empêcher les modifications. Cela garantit que les modifications ne sont apportées que par l'action de déploiement.

Pour verrouiller des ressources dans le gestionnaire de conception :

• Dans votre compte HubSpot, accédez à Marketing > Fichiers et modèles > Outils de conception.
• Localisez le dossier de votre ressource dans la barre latérale de gauche, puis effectuez un clic droit et sélectionnez Verrouiller le dossier.