vin-c / book-devops

The "Scaling Institutions With Devops" book.

Home Page:https://book-devops.berwick.fr

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Scaling Institutions with DevOps - The Book

Build Markdownlint

🇫🇷

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

Livre broché et ebook préfacés

🇬🇧

Scaling Institutions with DevOps[1]

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


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 :

Summary

Numerous organizations have embarked on their journey towards digital transformation, yet find themselves grappling to carve out a coherent and potent strategy. In this quest for advancement, 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 milieu, 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.

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

[1] To be translated (not planned at the moment)

About

The "Scaling Institutions With Devops" book.

https://book-devops.berwick.fr


Languages

Language:CSS 28.2%Language:HTML 27.3%Language:Python 23.3%Language:Makefile 21.2%