the 10 commandments of release engineering
DESCRIPTION
This presentation on The 10 Commandments of Release Engineering is from the December 2013 Automated Testing San Francisco meetup that took place at New Relic's HQ in San Francisco. The author/presenter is Dinah McNutt, Release Engineer at Google. Dinah distills the truths that she's found in her 20 years of building commercial software. For each truth, she will provide reasons and examples that support the truth. Some of the commandments are controversial, but she will include examples of where these commandments do not apply. Feel free to join us at our next monthly meetup in San Francisco, New York, or Boston. Find us at #AutoTestSF / #AutoTestNYC / #AutoTestBoston --- About Dinah McNutt: Dinah McNutt is a Release Engineer at Google, Inc and is also chairing the USENIX 2014 Summit on Release Engineering. She has been involved with systems administration since the mid-1980’s. Some of her accomplishments include writing the Daemons & Dragons column for Unix Review Magazine, writing for SunExpert Magazine, Byte, and other publications. She has served on the LISA program committee several times including chairing the conference. She has 20 years of commercial release engineering experience and has released all types of Unix-based software from shrink wrapped to web-based services to network appliances.TRANSCRIPT
The 10 Commandments of Release Engineering
Dinah McNuttGoogle, Inc.
Release Engineering
“Accelerating the path from development to operations”
Overview
● These commandments are FROM test engineers/system administrators TO release engineers
● Concepts apply to software products for both internal and
external customers ● Ideas presented are my own, not necessarily Google's
Background
● Release processes are usually an afterthought ● Most systems do the minimum required to "get it done"
● Release processes should be treated as products in their
own right ● There is often a big disconnect between the developer
writing the code, the person writing tests, and the system admin who installs it
Steps in Release Process
Check out code
Compile
Test
Release
The Real Process
Check out code
Compile
Unit Tests
Deployment
Package
System Tests
Canaries
More System Tests
Bug Fixes
The Real, Real Process
Check out code
Compile
Unit Tests
Deployment
Package
System Tests
Canaries
More System Tests
Bug Fixes
Build Artifacts
Reports
Alerts/Monitoring
Release Process Features
● Reproducible
● Tracking of changes and the ability to understand what is in a new version of the product or product component
● An identification mechanism (e.g. build ID) that uniquely identifies what is contained in a package or product
● Implementation and enforcement of policy and procedures
● Management of upgrades and patch releases
I - Thou shalt use a source code control system.
●Everything needed to release should be under source control
○ source code○ build files○ build tools○ documentation
●Doesn't matter what you use, just use something!
Reproducibility is a virtue.
Reproducible Build Environment
● Not usually checked into a SCR, but still may need to be recreated:
○ Operating System ○ Compilers ○ Build tools
● Possible solutions:○ Backups○ Installation servers
II - Thou shalt use the right tool(s) for the job.
Complex projects may require multiple build tools
Examples:
●make for C and C++ - the dependency checking is crucial
●ant for java
● scripting languages (bash, python, etc.)
Unnecessary complexity is a sin.
III - Thou shalt write portable and low-maintenance build files
● Plan to support multiple architectures and OS versions
● Use centralized configuration files for definitions common to build files○ Compiler options will change between architectures○ Editing hundreds of files for a single change is no fun
● Provide template files so developers can easily create new build files
Measure twice, cut once.
IV - Thou shalt use a release process that is reproducible
And automated...And unattended...And reproducible...
● Adopt a continuous build policy
● Leverage open source tools like Jenkins and Puppet
Automation is a virtue.
V - Thou shalt use a unique build ID
● Must provide enough information so the build can be uniquely identified and reproduced
● Examples:○ Date○ Repository revision○ Release version
● Must be easily obtainable
○ Included in packaging○ Embedded in binaries
Knowing where you came from is a virtue.
Build IDs
● 20131008_RC05
● 164532_20131008_2_RC00
● 164532_0_RC02
VI - Thou shalt use a package manager
● Auditing ● Leverage installation/upgrade/removal capabilities
● Package summary (who, what, when, etc.)
● Built-in version tracking and dependency checking ● Manifest (ok, tar -tf gives you that.)
● Use native package managers when possible
tar is not a package manager...
VII - Thou shalt design an upgrade process before releasing version 1.0
● Packaging decisions can affect the ability to upgrade
● Design an upgrade process at the same time you are designing an installation process
Not thinking ahead is a sin.
VIII - Thou shalt provide a detailed log of what thou hath done to my machine
● Installing/Patching/Upgrading/Removing software should provide a detailed log of what is happening
● Provide the ability to unpack and inspect the packages without installing
● Ideally there should be a "do nothing" option so I can see
what is going to happen first
IX - Thou shalt provide a complete install/upgrade/patch/uninstall process● Totally automated process
● Rollback AND roll forward
● Packages should be relocatable
Playing nice with others is a virtue.
X - Test Engineer: Thou shalt apply these laws to thyself
● All of these commandments can be applied to development and execution of tests
Shameless Plug
The 2014 USENIX Summit on Release Engineering
June 20, 2014 Philadelphia
“From Dev to DevOps”