Go to file
dependabot[bot] c736f2c9a4 Bump nokogiri from 1.16.2 to 1.16.3
Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.16.2 to 1.16.3.
- [Release notes](https://github.com/sparklemotion/nokogiri/releases)
- [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md)
- [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.16.2...v1.16.3)

---
updated-dependencies:
- dependency-name: nokogiri
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-03-17 09:03:55 +00:00
.github Create FUNDING.yml 2022-05-30 14:47:44 +05:30
cover add support to generate multi book 2019-02-01 06:17:47 +01:00
metadata add The Site Reliability Workbook 2019-02-01 06:28:34 +01:00
.dockerignore Easier Docker workflow 2018-05-17 01:54:54 +05:30
.editorconfig Initial commit 2017-09-16 21:52:31 +05:30
.gitignore Fix Directory Structure Changes (#17) 2018-12-20 23:23:37 +05:30
COPYING [docs] Add Linux/Mac instructions for both books 2021-01-19 14:32:58 +05:30
Dockerfile Switch to debian, fixes #31, closes #32 2020-06-07 00:35:54 +05:30
Gemfile Initial commit 2017-09-16 21:52:31 +05:30
Gemfile.lock Bump nokogiri from 1.16.2 to 1.16.3 2024-03-17 09:03:55 +00:00
README.md Configurable font size in PDF 2024-03-17 09:03:47 +00:00
books.sh The books are now hosted on sre.google instead of landing.google.com 2021-01-19 14:27:58 +05:30
generate.rb The books are now hosted on sre.google instead of landing.google.com 2021-01-19 14:27:58 +05:30
generate.sh Configurable font size in PDF 2024-03-17 09:03:47 +00:00

README.md

Google SRE Book/s

Generates a EPUB/MOBI/PDF for the Google SRE Books. Original sources are downloaded from https://sre.google/books/

Visit the Releases page to download the latest release. Go through all the releases, and click "Assets" to view a list of files.

Books

Site Reliability Engineering (2016) The Site Reliability Workbook (2018)
site reliability engineering cover
BUY
the site reliability workbook cover
BUY

A few other SRE books/reports are available as directly from Google or publishers. A few links point to Internet Archive. Links marked in 🔻 are currently down.

You might also like:

Build

Docker (Preferred)

Requirements:

  • Docker

You can generate either of books using BOOK_SLUG variable.

Available values for BOOK_SLUG:

  • sre_book Site Reliability Engineering.
  • srw_book The Site Reliability Workbook.
$ docker run --rm --volume "$(pwd):/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest
  • You should see the final EPUB/MOBI/PDF files in the current directory after the above runs.
  • The file may be owned by the root user.

NOTE: You'll have to allow docker access to a directory that's local to your system. The safest way to do this is as follows:

$ mkdir /tmp/sreoutput
$ chcon -Rt svirt_sandbox_file_t /tmp/sreoutput
$ docker run --rm --volume "/tmp/sreoutput:/output" -e BOOK_SLUG='srw_book' captn3m0/google-sre-ebook:latest

The build for the above Docker image can be audited at https://hub.docker.com/repository/docker/captn3m0/google-sre-ebook/builds.

macOS / Linux

Requirements:

  • Make
  • Ruby
  • gem install bundler
  • bundle install
  • brew install pandoc
  • brew cask install calibre
  • brew install wget

Run either of the following:

# To download Site Reliability Engineering.
BOOK_SLUG='sre_book' ./generate.sh

# To download The Site Reliability Workbook.
BOOK_SLUG='srw_book' ./generate.sh

PDF options

Any option can be passed to pandoc by PDF_OPT_ prefix, for example:

PDF_OPT_GEOMETRY=margin=1.5cm \
PDF_OPT_DOCUMENTCLASS=extbook \
PDF_OPT_FONTSIZE=14pt \
PDF_OPT_MAINFONT=LiberationSerif-Regular.ttf \
PDF_OPT_MAINFONTOPTIONS=BoldFont=LiberationSerif-Bold.ttf,ItalicFont=LiberationSerif-Italic.ttf,BoldItalicFont=LiberationSerif-BoldItalic.ttf \
PDF_OPT_MONOFONT=LiberationMono-Regular.ttf \
PDF_OPT_MONOFONTOPTIONS=BoldFont=LiberationMono-Bold.ttf,ItalicFont=LiberationMono-Italic.ttf,BoldItalicFont=LiberationMono-BoldItalic.ttf \
PDF_OPT_SANSFONT=LiberationSans-Regular.ttf \
PDF_OPT_SANSFONTOPTIONS=BoldFont=LiberationSans-Bold.ttf,ItalicFont=LiberationSans-Italic.ttf,BoldItalicFont=LiberationSans-BoldItalic.ttf \
BOOK_SLUG=sre_book ./generate.sh

Default options passed to pandoc in generate.sh are overloaded by PDF_OPT_ prefix, see PDF_OPT_GEOMETRY in above example.

Fonts in above axample are packed to fonts-liberation2 on Ubuntu.

See more details:

Known Issues

  • metadata is not complete. There are just too many authors
  • Foreword/Preface is not part of the index
  • The typesetting is not great and does not match the original. See #22 for a list

LICENSE

This is licensed under WTFPL. See COPYING file for the full text.

Extra

I have a list of my E-book publishing related projects at https://captnemo.in/ebooks/. Links to other related books can be found at https://github.com/upgundecha/howtheysre#books-1