backlog

Module-Cloud πŸ”—  

Expand all

During this module

These tasks can be completed at any point during this module. Don't leave them to the last minute!

[TECH ED] Write a run book πŸ”— Clone

[TECH ED] Write a run book πŸ”—

https://www.transposit.com/devops-blog/sre/2020.01.30-writing-runbook-documentation-when-youre-an-sre/

Why are we doing this?

Write a runbook for a project you have deployed using the Cloud technologies in this module.

Publish this runbook on your portfolio, along with the project.

Example runbook template from Atlassian
Runbook nameApplication X Deployment to Production
Runbook descriptionThis runbook provides instructions for deploying Application X to the production environment.
Owner@DevOpsEngineer
Version2.3
Version date//2024-03-21

On this page

πŸ› Architecture

[Include a high-level architectural diagram of the relevant hosts and services]

πŸ’¬ Support contacts

Expertise levelTeamTeam leadContact info
Level 1@ops-team-members@ops-team-lead[Include contact information for Level 1 support]
Level 2[Include details for Level 2 support, if applicable]
Level 3[Include details for Level 3 support, if applicable]

🎽 Runs

NameStateStart timeCompleted timeDuration
Application X Deployment[To be updated during deployment][To be updated during deployment][To be updated after deployment][To be calculated after deployment]

🎒 Process

Step instructions

  1. Ensure all prerequisites are met (e.g., successful testing in lower environments, approvals obtained)
  2. Take a backup of the current production environment
  3. [Detailed deployment steps]
  4. [Validation and testing steps]
  5. [Monitoring and alerting setup]
  6. [Communication to stakeholders]
EnabledExecution locationRun environmentsRun conditionsDocumentation
Yes[Specify the location or environment where the deployment will be executed]Production[Specify any conditions or prerequisites required for the deployment][Include links to relevant documentation, such as application guides, deployment scripts, or configuration files]

Maximum time in hours

8

How to get help

Share your blockers in Slack.

How to submit

Publish your runbook on your portfolio and as a document in your project repo. Link to your runbook on your project readme. Link your portfolio runbook in Slack. The best runbook, voted by the group, wins the coveted 🎽 πŸ“˜ Best Runbook Award