CodeYourFuture / CodeYourFuture/Module-Cloud

[TECH ED] Write a run book

Offen
#31 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
🎁 Module Product 🎯 Topic Communication 🎯 Topic Requirements 🏕 Priority Mandatory 📅 Sprint 4 🦑 Size Large Cloud
Vorherrschende Sprache
Keine Sprachdaten
Sterne
0
Forks
6
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

### 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_

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit den in diesem Issue verlinkten Kursunterlagen und der Atlassian-Runbook-Vorlage und dokumentiere anschließend ein Projekt, das du mithilfe der Cloud-Technologien des Moduls bereitgestellt hast. Veröffentliche das Runbook als Dokument im Projekt-Repository und in deinem Portfolio, verlinke es aus der README des Projekts und teile den Portfolio-Link in Slack; abgeschlossen ist die Aufgabe, wenn diese Links sowie die Anweisungen zur Bereitstellung, Validierung, zum Support und zur Überwachung vorhanden sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
cloud
Bereich
cloud, devops, documentation
Issue-Typ
Dokumentation
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.