In depth guide to Postgres' new CI

Transcript

1. In Depth Guide to Postgres’ new CI Nazir Bilal Yavuz Open Source PG Team Microsoft
2. About Me • Nazir Bilal Yavuz • Open Source Postgres Team @Microsoft • Working on Postgres ~2 years • Mainly build and CI stuff
3. What is CI • Stands for Continuous Integration • Automating the integration of new code changes ◦ Build ◦ Test • Main benefits ◦ Find bugs quicker ◦ Fasten the development cycle
4. Why we need CI on Postgres • Patch is sent but… ◦ Your changes are not working on… • Testing changes on various platforms • Developer productivity ◦ Find bugs fast ◦ Shorter review period
5. New CI system • Uses Cirrus CI (https://cirrus-ci.org/) ◦ Continuous integration and deployment platform that enables developers to automate their software development workflows • Steps to run CI: ◦ Enable CI ◦ Push changes ◦ See results ◦ PG16
6. 1 - Fork the Postgres repository • https://github.com/postgres/postgres
7. 2 - Add Cirrus CI application to your GitHub account • https://github.com/marketplace/cirrus-ci
8. 3 - Cirrus CI should access to forked PG repository • GitHub -> Settings -> Applications -> Cirrus CI
9. See results
10. How CI works • It reads .cirrus.yml file ◦ https://github.com/postgres/postgres/blob/master/.cirrus.yml • Explain in detail later
11. CI tips • Cirrus terminal • Gathering logs • on_failure instruction ◦ instruction ▪ I will refer it as a key on yaml file
12. Cirrus terminal • When Postgres is working on your local but you see failures on CI • No need to run CI again
13. Gathering logs • *_artifact instruction • Analyze logs offline • By default log, diff, regress logs • Need to gather other files (e.g. docs)
14. on_failure instruction • Only when we come across a failure • Avoid unnecessary logging • Faster CI runs for successful build
15. Let’s debug!
16. .cirrus.yml file • 6 main parts • Basic example
17. In Summary • Enable new CI on GitHub • Push changes to trigger CI run ◦ CI reads .cirrus.yml file • See the results • If debugging is needed ◦ Use Cirrus terminal ◦ Gather & investigate logs ◦ Use on_failure if needed
18. Thank you! Questions? Discord Comments naziryavuz@microsoft.com Tweet to me @nbyavuz