Configurar la integración continua con un repositorio de GitHub mediante GitHub Actions

Como parte de tu workflow de desarrollo, es posible que prefieras mantener tu código fuente de verdad en el control de versiones. Esto sería especialmente útil si trabajas como parte de un equipo de desarrollo para que puedas hacer seguimiento de los cambios y revertirlos rápidamente si es necesario.

Con GitHub Actions, puedes configurar una integración continua con un repositorio de GitHub. Esta guía recorre el proceso de integración y asume que estás familiarizado con:

• El uso de Git y GitHub
• La creación de sitios web usando la CLI de HubSpot

A continuación, descubre cómo configurar la integración utilizando HubSpot CMS Deploy GitHub Action (recomendado) o manualmente.

Antes de poder integrarte con GitHub, primero deberás recopilar tus archivos localmente.

• Si tienes un material de CMS existente que reside en HubSpot, como un tema o un conjunto de plantillas, puedes obtenerlo ejecutando el comando fetch de la siguiente manera: hs fetch<HubSpot_src> <local_dest>. De manera alternativa, puedes descargar todos los archivos en el sistema de archivos de desarrollador de la cuenta ejecutando hs fetch /.
• Para crear un nuevo proyecto local, se recomienda comenzar con el boilerplate del tema de CMS. Si no has trabajado con el tema de CMS antes, echa un vistazo a la guía de inicio rápido. Si ya instalaste la CLI de HubSpot y configuraste tu entorno local, puedes crear un nuevo tema local desde el boilerplate ejecutando hs create website-theme<new-theme-name>. Debes subir tus archivos a HubSpot con el comando hs upload.

Con tu código disponible localmente, lo agregarás a un repositorio de GitHub. Después de agregar tus archivos a GitHub, continúa con el siguiente paso para instalar la GitHub Action prefabricada de HubSpot (recomendada) o configurar la Acción manualmente.

Para agilizar el proceso, HubSpot creó una GitHub Action que puedes instalar en tu proyecto de GitHub para gestionar la implementación automática de los cambios de una rama a tu cuenta de producción de HubSpot.

• Con tus secretos, workflows y scripts en tu repositorio de GitHub, crea una solicitud de extracción y combínala en main. 
• Después de combinar la solicitud de extracción, navega a Acciones. Deberías ver cómo se ejecuta tu acción de implementación, que luego implementará tu código en tu cuenta de HubSpot.

Ahora que tu fuente de referencias reside en GitHub, debes bloquear tu material en HubSpot para evitar que se realicen modificaciones allí. Esto garantiza que los cambios solo lleguen a través de la acción de implementación.

Para bloquear materiales en el administrador de diseño:

• En tu cuenta de HubSpot, navega a Marketing > Archivos y plantillas > Herramientas de diseño.
• Localiza la carpeta de tu activo en la barra lateral izquierda, luego haz clic con el botón derecho y selecciona Bloquear carpeta.