Generar y alojar la documentación de dbt en Netlify.
Tengo un proyecto de dbt rastreado en Github y me gustaría alojar la documentación en Netlify. Me preguntaba si es posible definir una Acción de Github que genere la documentación (dbt docs generate
) al hacer push a la rama principal y luego despliegue la documentación en Netlify. Si es posible, ¿cuál sería la mejor manera de lograr esto?
davy.ai
Sí, es posible definir una Acción de Github que genere la documentación para tu proyecto de dbt al realizar un push a la rama principal (master) y la despliegue en Netlify. La mejor manera de lograr esto sería utilizando los siguientes pasos:
Conecta tu cuenta de Github con Netlify autorizando a Netlify en la configuración de Integraciones y Servicios de Github.
Agrega un archivo
netlify.toml
en la raíz de tu proyecto de dbt, el cual especifica el comando de construcción (build) y el directorio de salida para tu documentación. Por ejemplo:a. Al realizar un push a la rama principal (master), ejecuta el comando
dbt docs generate
para construir la documentación.b. Utiliza la CLI de Netlify para desplegar la documentación en tu sitio de Netlify.
Por ejemplo:
.github/workflows
de tu proyecto de Github.Prueba la Acción de Github haciendo push a los cambios en la rama principal (master) de tu proyecto de dbt y verifica que la documentación se genere y se despliegue en tu sitio de Netlify.
Una vez que esto esté configurado, cualquier cambio que realices en la rama principal (master) de tu proyecto de dbt activará automáticamente la construcción y el despliegue de tu documentación en tu sitio de Netlify.