CodeYourFuture / CodeYourFuture/Module-Cloud

[TECH ED] Write a run book

Open
#31 0 comments 0 reactions 0 assignees View on GitHub
🎁 Module Product 🎯 Topic Communication 🎯 Topic Requirements 🏕 Priority Mandatory 📅 Sprint 4 🦑 Size Large Cloud
Dominant language
No language data
Stars
0
Forks
6
PR merge metrics
No merged PRs in 30d

Description

### Link to the coursework

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 name** | Application X Deployment to Production
-------------------|----------------------------------------
**Runbook description** | This runbook provides instructions for deploying Application X to the production environment.
**Owner** | @DevOpsEngineer
**Version** | 2.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 level | Team | Team lead | Contact 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

Name | State | Start time | Completed time | Duration
-----|-------|------------|-----------------|----------
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]

Enabled | Execution location | Run environments | Run conditions | Documentation
--------|---------------------|-------------------|-----------------|---------------
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_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.