{"id":13769839,"url":"https://github.com/SkeltonThatcher/run-book-template","last_synced_at":"2025-05-11T02:33:36.431Z","repository":{"id":38859682,"uuid":"62965545","full_name":"SkeltonThatcher/run-book-template","owner":"SkeltonThatcher","description":"Run Book / Operations Manual template for modern software systems","archived":false,"fork":false,"pushed_at":"2019-08-21T05:20:20.000Z","size":259,"stargazers_count":698,"open_issues_count":0,"forks_count":345,"subscribers_count":38,"default_branch":"master","last_synced_at":"2024-05-18T19:28:17.949Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SkeltonThatcher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-07-09T19:23:21.000Z","updated_at":"2024-05-05T19:54:45.000Z","dependencies_parsed_at":"2022-08-09T06:16:53.583Z","dependency_job_id":null,"html_url":"https://github.com/SkeltonThatcher/run-book-template","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkeltonThatcher%2Frun-book-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkeltonThatcher%2Frun-book-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkeltonThatcher%2Frun-book-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkeltonThatcher%2Frun-book-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SkeltonThatcher","download_url":"https://codeload.github.com/SkeltonThatcher/run-book-template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224703869,"owners_count":17355710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T17:00:32.065Z","updated_at":"2024-11-17T05:31:41.897Z","avatar_url":"https://github.com/SkeltonThatcher.png","language":null,"funding_links":[],"categories":["Templates","On-Call","Code signing ###","🚨 Incident Management e On-Call"],"sub_categories":["Miscellaneous","Chess :chess_pawn:","Templates de Runbooks"],"readme":"# Run Book Template\n\nA Run Book / Operations Manual template for modern software systems.\n\nThere are two main files:\n\n1. [`run-book-template.md`](run-book-template.md) - the template itself (see below)\n2. The [Run Book Dialogue Sheet](https://github.com/SkeltonThatcher/run-book-template/releases/latest), a PDF (300KB) with headings taken from the `run-book-template.md` and designed to be printed at A1 paper size for use in a team situation. _The Run Book Dialogue Sheet is based on the work on [Dialogue Sheets by Allan Kelly](https://www.infoq.com/articles/dialogue-sheets-retrospectives) and used with his permission._\n\n\u003ca href=\"https://github.com/SkeltonThatcher/run-book-template/releases/latest\"\u003e\n\t\u003cimg src=\"Run-Book-dialogue-sheet.png\" title=\"Download a PDF of the Run Book dialogue sheet\" alt=\"Download a PDF of the Run Book dialogue sheet\" width=\"300px\" style=\"border: 1px solid gray;\" /\u003e\n\u003c/a\u003e\n\n## Overview\n\nThe file `run-book-template.md` contains suggested checks and procedures for most non-trivial software systems that can be used as **a template to create a Run Book or System Operation Manual** (SOM). Treat the resulting information as a starting point for discussions about operational readiness. \n\nIn our experience, most interesting software systems will need engineers to address the majority of the points, if only to confirm that \"this section definitely does not apply here\" - a valuable realisation. Each section has a description to set the context and explain why it's needed. \n\nYou'll likely get the best outcomes from having the **software development team own and drive the activities around the Run Book**, seeking input from Testers and Ops people to fill in gaps in knowledge. In practice, you'll want to automate many of the checks and procedures (rather than leaving them in a wiki), but remember: _discussion, not documentation_ is where the value lives in Run Book collaboration!  See [runbookcollab.info](http://runbookcollab.info/) for more details.\n\nHave fun! _Matthew Skelton \u0026 Rob Thatcher_\n\n\u003e The book [Team Guide to Software Operability](http://operabilitybook.com/) has a chapter dedicated to the use of Run Book collaboration and the Run Book dialogue sheet, including details of how different teams use these techniques. \n\u003e \u003cbr/\u003e \n\u003e \u003cimg src=\"Team-Guide-to-Software-Operability.png\" width=\"200\" /\u003e\n\nCopyright © 2014-2016 [Skelton Thatcher Consulting](https://skeltonthatcher.com/)\n\nLicenced under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) ![CC BY-SA 4.0](https://licensebuttons.net/l/by-sa/3.0/88x31.png)\n\n##  How to use the template\n\n1. Fork the repo\n1. Edit the file [`run-book-template.md`](run-book-template.md) \n1. Add your own operational \u0026 runtime checks - send us a Pull Request if you think your new checks are useful to others!\n1. Remove (or comment with _N/A_) those sections that really do not apply in your case (but double-check first).\n1. Use the template as a way to [encourage discussion and collaboration between Devs and Ops people for building better systems](http://runbookcollab.info/).\n1. If some information is missing for one or more sections, indicate this clearly (e.g. *WARNING*). Knowing what you do not know is valuable.\n1. After you have validated the operational aspects with all teams involved, begin to automate the checks and procedures.\n\n**Expect to redesign parts of the software in order to better meet the operational needs outlined in this template!**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSkeltonThatcher%2Frun-book-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSkeltonThatcher%2Frun-book-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSkeltonThatcher%2Frun-book-template/lists"}