Slides for @drupalbristol talk on Weds October 21st (Back to the Future Day!) on automating Drupal Aegir Platform builds triggered from Git tags using Fabric and Drsush Provision

1. Git-Drush-Aegir
Automatic Drupal builds with Fabric

2. It’ll be about half an hour
✅ Motivation for using Aegir / Drush Provision;
dev-staging-live platform triangle: 5-7 mins
✅ Front end workflow choices;
Their effect on Aegir Platform builds; Motivation for extending Aegir; demo the
fun bit 😳; setup gotchas : 10-15 mins
✅ Extending Aegir with Fabric tasks: 5 mins
✅ Automating the Fabric tasks with Jenkins: 2 mins
✅ Hooking Git into the automation: 2 mins
✅ Seeing the results in Aegir: 2mins
✅ Wrap up; GitHub and tutorial pointers: 2 mins

3. It’s better in the future
"We're descending toward Hill Valley, California, at
4:29 pm, on Wednesday, October 21st, 2015."
Doc Brown and Marty McFly:
Back to the Future

4. Why Aegir?
• “Aegir creates the web server's site configuration files,
the site's database, runs the Drupal installation
process and reloads the relevant services, all
automatically.”
http://aegir.readthedocs.org/en/3.x/
• Useful for managing even a few Drupal sites
• Imposes a discipline for managing
development→staging→live sites

5. Typical Aegir Site
Operations to manage Site
Operations queued

6. Typical Aegir Site
Per site:. Of note:
aliases; platform; packages; tasks / operations

7. Drupal platforms
The Development Triangle
live staging
dev
Aegir
Server
Dev
m/c

8. git push dev
Case: update contrib
Iterate dev; Distribute dev
live staging
dev

9. Development complete
Pushing tag on develop branch:
Creates a new platform and migrates staging site to it.
live staging
dev
git tag <tag>
“ready to stage” ✔
git push —-tags

10. Aegir migrate
Staging platform replaces live platform
drush @live_site provision-migrate @new_platform
live staging
dev
tests ✔

11. Front-end workflow

12. Front-end workflow
• sass; compass (Stylus; postcss; etc.)
• coffeescript
• browserSync
Theming can be more fun and more productive💥
Introduces extra build steps to be automated 😱

13. Let’s see a demo
The workflow experience has to be worth the pain of setting it all up!

14. Post demo
A few details of note in workflow setup
Full details at:
https://github.com/iainhouston/aegir-deploys
https://iainhouston.com/blog/automated-drupal-builds-with-fabric-git-and-aegir.html

15. browserSync gotchas (D7)
• Don’t use Drupal browsersync contrib
Do use browserSync.init({proxy: <test_site_name>})
• Do use Drupal link_css contrib
Overrides @import during development
linked css for browserSync to inject new css

16. Workflow Consequences
• Aegir builds new platforms with drush make
• We keep source under version control (sass, coffee)
• We don’t version compiled artefacts (css, js)
• So …
We need to add compile steps after drush make

17. Workflow Consequences
• We use Fabric to extend Aegir
• Write task to run compilations
• Write tasks to emulate Aegir front-end steps
with drush provision
• You can fork fabfile.py
https://github.com/iainhouston/aegir-deploys

18. Extending Aegir with Fabric tasks
Snippet 1 - config
This file in your “build” repo

19. npm gotchas
• Enforce build-local versions of sass and coffee compilers
npm run sass
npm run coffee
• node_modules/**/*.info files can be included in drupal
cache rebuild → WSOD
(addressed in drupal core now / soon)

20. gulp gotchas
Compilation errors
• Should fail automated build
• Shouldn’t interrupt devel workflow

21. Extending Aegir with Fabric tasks
Snippet 2 - compile css; js
This fabfile.py file in
https://github.com/<your_fork>/aegir-deploys

22. Extending Aegir with Fabric tasks
Snippet 3 - emulates Aegir migrate
This fabfile.py file in
https://github.com/<your_fork>/aegir-deploys

23. Hooking Git into the
automation
Writing the Git post-receive hook

24. git@<git_server>:<my_build_repo>.git/post-receive

25. Triggering the build

26. Seeing the results in Aegir
drush provision tasks shown in Aegir UI
Use UI to migrate live site to new platform
OR push new tag on master branch

27. Seeing the results in Aegir
drush provision tasks shown in Aegir UI
Use UI to migrate live site to new platform
OR push new tag on master branch

28. Wrap up.
GitHub and tutorial pointers
https://github.com/iainhouston/aegir-deploys
https://iainhouston.com
https://iainhouston.com/blog/automated-drupal-builds-with-fabric-git-and-aegir.html

29. fin