Hey folks π
I'm the creator of Taskord, I deploy Taskord more than 100 times daily.
In this article, I'm gonna explain how to ship rapidly to production without any error and let us see what the heck is Staff Ship and feature flags!
π± Planning
Let us consider we are building a brand new Explore page and /explore
is going to be the URL. Plan about
- How is the UI going to look
- Do we have all UI components available
- Data model and what are the tables we need to create for a database
- Any blocking Issues
Don't think a lot and waste the time, we can add/improve it in the next Iteration.
π΅ First Pull/Merge Request
After the proper planning just go ahead and create the first page just saying Hello, World!
and point it to /explore
in your routes file.
After that commit and push to GitHub/GitLab and create your first pull request.
This step is optional if you are a solo developer, you can push all the way straight to
main
/master
branch (but it is not suggested).
π¨βπ» Development
After creating the pull request start concentrating on developing the app. If you have any dependency on the backend team don't wait for them until they complete.
Instead, just mock the JSON Response and start developing the work, make sure to give the JSON Spec to the backend team to develop the API in such a way you want. If not we need to rework again based on their API response.
Communication and time are crucial.
π§ͺ Testing
After completing the development wait for the CI to become green for that pull request.
Once all the tests have been passed merge the branch to main
/production
.
Deploy the feature to your staging instance, so you can deploy to production servers without fear. Test everything well, create a small checklist and check everything is done and working fine in staging instance before moving to production.
What is feature flags/toggle?
Feature flags are simply a toggle button which has the ability to turn features of your application on/off easily based on condition.
π‘ Staff Release
After testing well, deploy main
branch to production servers where the new feature exists.
Post in your internal slack that "Hey, we just shipped the explore page to our production servers πΏ, make sure to tun on staff ship. Feedbacks welcomed π"
Then sit back and relax for some time till the feedback arrives. If it has any bugs fix it ASAP.
By the way what is staff ship π€
Staff ship is a feature flag which is available only for site admins possibly mods, where admin can tun on the flag and check whether the feature is working or not.
When staff ship is enabled admins can see this special admin/performance bar above the navbar which is heavily inspired by GitHub.com
Taskord's admin bar
GitHub's admin bar (GH Enterprise)
Here is the sample video how staff ship works in Taskord, the staff ship is enabled when pressing backtick or pb
shortcut key in the keyboard which is available only for admins.
π₯ Beta Release
Release the /explore
page for selected users, usually, you can do by shipping to
- Users based on age
- 50% of platform users
- Users with beta flag enabled, etc.
π¬ Feedback
Feedbacks are critical, you will get a lot if the userbase is huge, make sure to evaluate quickly and fix the bugs in upcoming Iterations.
Automatic Error Tracking
Error Tracking is also a part of feedback, this need be done automatically. We use Sentry to track errors and patch the fix quickly.
This is how Sentry looks like
π General Availability
If all settled and good to go, just go ahead and remove all the feature flags for /explore
page. Make sure to keep an eye on Sentry for a few days.
β Be careful
- Prepare to revert the PR anytime if there is an issue in production β©
- Commit every change π
Hope this article helped you π
Happy Shipping π
Top comments (3)
Heyo!
This is an awesome post! π₯ In fact, the topic of your post would also work really well in The Ops Community too!
The Ops Community is a place for cloud engineers to share tips & tricks, tutorials, and career insights. Folks there commonly share information about DevOps and SecOps topics amongst other things.
Would you consider posting this article there too? Because The Ops Community is built on the same platform as DEV (Forem) you can fairly easily copy the Markdown and post your article there as well.
Really hope that you'll share your post with the community there and consider browsing the other Forem communities out there!
There is a saying, I don't always test my software, but when I do, I do it on production. There is also - you are what you move to production. Love π the approach of fast feedback or error reactivity. Many times, the real users think of aspects the servicing team has never thought about.
This blog post is really informative for me!! spell to stop thinking about someone