Skip to content

flavienbwk/book-devops

Repository files navigation

Scaling Institutions with DevOps - The Book

Build Markdownlint Podcast

🇺🇸

The pragmatic decision-makers' guide to understanding and acting.

Paperback and ebook with foreword

🇫🇷

Le guide des décideurs pragmatiques pour comprendre et agir.

Livre broché et ebook préfacés


What is it ?

This repository hosts a comprehensive guide to implementing DevOps in large organizations, addressing the challenges from fostering cultural shifts to navigating technical and HR transformations.

Scaling Institutions with DevOps was written from my SRE/DevOps experience to benefit enthusiasts, mainly from the public sector, to overcome these technical and transformational challenges.

As a DevOps advocate, I had to make this book GitOps-compliant, this is why it is hosted here. I hope it will be community-driven to fill it with good resources and make improvements as practices evolve. Please contribute through Pull Requests and Discussions.

Here are the different ways to access this writing :

Type French English
Web version Lire maintenant Read now
Markdown version Lire maintenant Read now
Ebook version Amazon / Google Books Amazon / Google Books
Paperback book Amazon Amazon
Hardcover book Amazon N/A
Audiobook N/A Soon
Summarized audiobook N/A Listen now (18 min)

The original book was written in French. The English version was reworked to include america-related examples and use cases.

Summary

Numerous organizations have embarked on their journey towards digital transformation, yet find themselves grappling to develop a coherent and effective strategy. In their quest for improvement, they often turn to a plethora of experts, harboring hopes of achieving success.

Confronted with the imperative necessity to evolve and sustain their operational momentum, a pervasive sense of fatalism begins to take hold. In this situation, the DevOps movement emerges as a beacon of hope. Rooted in the principles that govern the world's most successful and expansive organizations, DevOps seeks to provide viable solutions to these pressing challenges.

This book is designed to be your gateway to understanding this transformative movement, which has found its stronghold in the largest and most prosperous organizations of the world.

Designed to be both accessible and insightful, this hands-on guide, enriched with illustrations, unfolds the opportunities that state-of-the-art DevOps technologies and methodologies have to offer. It demystifies the prerequisites for organizational adaptation and guides you on embarking on your own DevOps transformation, at any scale.

Purpose

This book is filled with recommendations about DevOps practices, including versioning everything you do : from documentation, presentations, to infrastructure recipes (IaC). So this repo is a perfect illustration of how it can be done !

I believe the practice of writing a book the gitops-style is not a bad move : it's portable, iterative, open and automatable. Of course, it's far fetched for the use case, but this is a funny way to illustrate the methodology.

That said, this way of writing is very convenient for not being annoyed by compatibility issues when I switch from my Windows to my Linux PC.

It automatically :

  • Validates Markdown format
  • Renders a PDF version on develop and main
  • Updates the Amazon physical version book through their API

This repo uses a trunk-based git workflow with releases automatically triggering optional actions.

Supporting the author

  • ⭐ Star and share this repo
  • 📓 Buy the paperback or hardcover book (including foreword)
  • 📘 Buy the ebook (including foreword)
  • ❤️ Sponsor me

Contributions and publishing process

This book has numerous lives. Let's make sure it reflects DevOps' state of the art practices at all times with your contributions.

  • Source edition (1.x.x) : the original book, unique, exclusively written by the author.
  • Community edition(s) (>1.x.x) : annual versions of the book including community contributions to improve it.

Licenses

  • Source edition : Copyright © 2023 Flavien BERWICK

  • Community edition(s) : GNU General Public License v3.0 Commons Clause License

    Details about the community license.

    After the initial source edition' hard cover book gets publicated and as soon as there are accepted contributions to this repo's writing (fra/README.md or eng/README.md) through a pull request, the license will be updated to GNU General Public License v3.0 Commons Clause License.

    The Commons Clause License was added so any book version officially published totally reflects community's contributions, with no parts adapted or removed by someone trying to partially publish it.

    What this means is that you can use this project (blogs, podcasts, presentations), while citing its source, but not sell it as-is in a (e)book.

    The name in the GitHub profile of contributors will be published if granted. To grant authorization to include your name, please include the following sentence in the description of your Pull Request : "I hereby declare allowing the original author of the book publishing the following edition of this book with my contribution and name.". If you want to be published with another name that your GitHub's one, please specify it at the same place.

Book generation

This repository has automatic PDF and HTML generation from Markdown files thanks to Pandoc.

mkdir -p "$HOME/.local/share/fonts"
cp ./fra/templates/fonts/* "$HOME/.local/share/fonts"
cp ./eng/templates/fonts/* "$HOME/.local/share/fonts"
cd ./fra && make pdf && cd -
  • Other formats available : EPUB (requires you to clone this repo or buy the digital version to support the author).

Useful VSCode extensions when writing